#### Configuring Key Administrator Plug-In

The Parallels Key Administrator (hereinafter, KA) GUI interface URL is:

`https://ka.swsoft.com:2000`

Please note that the port 2000 must be used to log in to the KA GUI only. To connect to the KA server remotely, via the KA plug-in, you need the special KA API login/password The remote KA API port is 7050. Please, contact your Parallels sales representatives and ask for the remote KA API login and password.

After you enter all the necessary requisites into the KA plug-in form and save them, the plug-in becomes active automatically after the list of available license classes is fetched either from the Parallels Business Automation - Standard database (for plug-ins with licenses manual upload) or online from KA server (for online KA plug-ins), and you can issue licenses that belong to the set of license classes included in your client agreement with Parallels.

Please remember that the license classes you would like to sell are to be manually selected for every KA plug-in configuration.

To add a new KA plug-in configuration:

1. Select Service Director - License Manager.
2. Click Plug-Ins on the License Manager submenu.
3. Click the New plug-in button.
4. Enter the new plug-in general settings:
   1. Type the name of a new KA plug-in configuration into the Plug-in name field.
   2. Select the basic plug-in configuration type from the Plug-in template drop-down menu.
5. Click the Next button.
6. Fill the form:
7. Select the way you will get licenses by setting the option button to one of the following:
   - Upload licenses manually. Select this to use the plug-in in offline mode. You will upload licenses manually. For offline mode, a special tool for license requests generation is provided. You select a license class, specify a license capacity, select add-ons, and all this information is saved in a license request. Later, this license request can be copied and sent to the KA sales representative. As soon as you select this option, all the fields for online KA integration will become disabled.
   - Get licenses via Parallels KA. Select this option if you want to get licenses from Parallels Key Administrator online. In this case, licenses will be issued automatically via the KA API. To configure the plug-in for online mode the KA server data is to be entered.
8. If you have selected online integration with KA, enter the following into the form fields:
   1. Type the Parallels Key Administrator server hostname into the KA server host field. The KA hostname is `ka.swsoft.com`.
   2. Enter the number of remote API port the Parallels Key Administrator server listens for license issuing requests into the KA server port field. The remote KA API port is 7050.
   3. Type your Parallels Key Administrator API login into the KA API login field.
   4. Type your Parallels Key Administrator client login into the KA client login field.
   5. Type your Parallels Key Administrator API password into the KA API password field.
   6. Parallels's Software Update Service (SUS) is licenses upgrade service. A KA client gets SUS for a period defined in his/her client agreement. During SUS period, a KA client can get licenses upgrades. Licenses expiration is not connected with SUS, if a license is not expired, it can be used, but if there is no SUS, then such a license cannot be upgraded. If the Monthly billing scheme is used, then SUS is renewed each month. If the Purchase billing scheme is used, then SUS can be renewed two weeks before expiration with considerable discount or, if renewal is done after SUS expiration, a renewal payment is discounted as well, but less than in case of advance renewal. Thus, it is reasonable to use the Automatically renew SUS option if you use the Purchase billing scheme. If you enable this option, the plug-in will automatically request KA server for SUS renewal two weeks before SUS expiration.
   7. If you want to re-sell released licenses, then check the Return licenses to pool after unassign from subscription box. It is reasonable to use this option if you use the Purchase billing scheme, when licenses do not expire. If you use the Monthly billing scheme, then it would be problematic to guarantee that returned licenses do not expire shortly, so in this case we do not recommend to enable this option.
9. Select the terms of payment for licenses from the Bill Type menu:
   - Monthly. Licenses are purchased for the period of one month with one-month SUS. Monthly payment is required to keep license(s) active and renew SUS.
   - Purchase. Licenses are purchased for an unlimited period with one-time payment and one year SUS. In this case, licenses never expire, but licenses upgrades are possible only during SUS period, i.e., during one year. In this case, SUS can be renewed. SUS can be renewed two weeks before expiration with considerable discount or, if renewal is done after SUS expiration, a renewal payment is discounted as well, but not so good as in case of advance renewal.
10. Click the Update button.

Please send us your feedback on this help page