Obtaining License Files

Go Up to Installing the AppWave Enterprise License Center

The process of generating license files is called "hosting." You can perform hosting process either directly from ELC Web Admin interface or from the Web Hosting page at https://reg.codegear.com/srs6/el/login.jsp.

To generate License Files using the ELC Web Admin Interface

1. Start ELC.
2. Start the ELC Web Admin interface.
3. Select License Hosting page from the main menu.
4. In the Login Name field, enter the login name sent to you in the Embarcadero License Certificate.
5. In the Password field, enter the password sent to you in the Embarcadero License Certificate.
6. Enter one or more certificate numbers or leave the field empty to retrieve licenses for all issued certificates.
7. Optionally, change the default port number.
8. Optionally, enter the host address.
9. Optionally, enter the backup host name and address. Note that backup license server has to be already installed on a different physical machine or VM than master server.

To generate License Files using the Web Hosting Page

1. In a web browser, navigate to https://reg.codegear.com/srs6/el/login.jsp.

   

2. In the Login Name field, enter the login name and password sent to you in the Embarcadero License Certificate.
3. Click the Login button. The License Hosting License Certificates screen opens.

   

4. To choose a certificate to host, scroll through the list of license certificates and select the certificate you want.
5. Click Host. The License Creation Master Server screen opens.

   

6. Specify a master server for hosting the license certificate you selected.

   A license can be hosted on one master-backup server configuration only.

To set up a Master Server for a License Certificate

If you do not know the Host Name

The host name is displayed in the Admin, on the License Server Status page.

The host name is included in the resulting server license file (server_XXX.slip, where XXX is the certificate number). This .slip file can only be used with the supplied backup and master host names.

If you cannot obtain the host name from Admin tool, run the ELC host utility to find the host name:

• On Windows, run elise.bat host from the <ELC>/bin directory.
• On Unix, run elise.sh host from the <ELC>/bin directory.

The JAVA_HOME environment variable must be set in order to run this utility.

The installation wizard automatically sets this for you.

Warning: System utility 'hostname' should not be used, as it may return a different value than the ELC host utility.

Once you know the Host Name

1. Enter it into the Host Name field.
2. Enter the port number in the Port field. The default is 5567. Do not change this value unless port 5567 is blocked or already in use by the server.
3. Enter an IP address (such as 123.123.12.21) or a fully qualified address (hostname.hostdomain.com) in the Host Address field. This address is used by clients to send licensing requests to the server.
4. Click Next to store the Master Server hosting information and open the Backup Server hosting page.

A license can only be hosted on one server at a time. Moving a license from one server to another is called re-hosting. A common reason to re-host is because you entered incorrect information into either of these fields or because the server computer failed. If you have to re-host (either by changing the Host Name or Port Number on this screen), you must contact Embarcadero Customer Support.

You can change the Host Address any time after the license files are issued and re-issue license files.

Defining a backup server is optional. The backup server must be installed on a separate machine prior to this step completion.

Note: Mixing master-only and master-backup license files on ELC is not allowed.

To set up a Backup Server

1. Select Click here to enable backup server support to enable the Backup Host Name and Host Address text fields. If the master server has already been hosted in connection with a backup server, the checkbox is selected by default and values for Backup Host Name and Host Address are added.
2. Stop here if you do not know the backup server host name and see “If you do not know the host name”.
3. Once you know the backup server host name, enter it into the Host Name field.
4. Enter an IP address (such as 123.123.12.21) or a fully qualified address (hostname.hostdomain.com) in the Host Address field. This address is used by clients to send licensing requests to the server.
5. Click Next to store the backup server hosting information and open the Review the following hosting page.

   To make changes to the backup server setup, click Back.

6. The Review the following hosting page details the hosting information that you supplied in the previous steps, before you create the license files.

   

   The Review the following hosting page provides warning information about creating license files that are compatible on existing redundant/non-redundant ELC setups. Warnings do not prevent or stop the hosting process but are meant to encourage compatibility.

   All license files loaded on any ELC must be all redundant or all non-redundant. All redundant license files must point to the same backup ELC. During the hosting process, warnings may be displayed for the following cases:

   • Warning: Creating new redundant licenses for a master server that has previously been hosted as non-redundant server.
   • Warning: Creating new non-redundant licenses for a master server that has previously been hosted as a redundant server.
   • Warning: Creating new redundant licenses in which the backup server is different from the backup server found in a previously hosted configuration.
   • Warning: Creating new redundant licenses where the master server is different from the master server found in a previously hosted configuration.
7. Click Finish to create the license files and move to the Download. Click Back to make any changes to your ELC configuration. The License creation page opens.

   

8. Use the License creation page to review the information and download license files.

   A readme.txt file is included with the download. The file contains license summary and ELC user list setup instructions. If multiple license certificates are hosted, you will see a listing of multiple license certificates.

9. Download the .zip file and extract its contents into <ELC install>\conf directory. The archive contains 2 configuration files (*.slip) files and a readme.txt file with instructions about copying the configuration files (*.slip files) to the required directories:
   • The server_nnnnn.slip file is the server configuration file.
   • The named_nnnnn.slip or concurrent_nnnnn.slip file is the client configuration file.

   The readme.txt file also contains the product identifier that is used when configuring the user list file.

10. Follow the instructions in the "Client for AppWave Enterprise License Center" section of the readme.txt file to copy client configuration files to the required directory.
11. Follow the instructions in the "Configuring the AppWave Enterprise License Center" section of this document to configure the IP and user list text files. These files authorize users to access licenses. The identifier you must enter into the user list file is contained in the readme.txt file.

See Also

• Installing ELC