Configuring FlexNet Agent 5.8 Using the Agent Configurator
You use the Agent Configurator to configure FlexNet Agent 5.8 for use with FlexNet Manager for Engineering Applications.
To configure FlexNet Agent 5.8 using the Agent Configurator:
| 1. | You can launch the Agent Configurator from the command line or by double-clicking the file AgentConfiguration.bat. |
| • | From the command line |
| a. | Open a Command Prompt window, and change to the FlexNet Agent 5.8 installation directory. |
| b. | Type the following command to launch the Agent Configurator: |
AgentConfiguration.bat
| • | From the file AgentConfiguration.bat |
| a. | In a file explorer, navigate to the location: <agent_install_dir> |
| b. | Double-click the file AgentConfiguration.bat. |
The Agent Configurator opens.
| 2. | In Step 1 of 3 (Agent Configuration and HTTP Upload Location), configure the following. |
|
Setting |
Description |
|
Broker Protocol |
Specify TCP or SSL. |
|
Broker Hostname |
Host name for the FlexNet Agent 5.8. |
|
Broker port |
Port for the FlexNet Agent 5.8. |
|
Protocol |
Specify whether to use HTTP or HTTPS to upload files. |
|
Host name |
Host name for the FlexNet Manager Admin server |
|
Port |
Port for the FlexNet Manager Admin server |
|
Show Advanced Settings |
Select this check box to display two additional configuration panels, where you can configure logging details, virtual machine heap size, and secure settings. |
| 3. | In Step 2 of 3 (License Servers), click Add to add license servers for this FlexNet Manager for Engineering Applications. This configures the FlexNet Manager for Engineering Applications’s access to a license server on the FlexNet Manager for Engineering Applications host machine. |
When you click Add, the Add License Server panel is displayed. Complete the license-server settings, then click Continue to add the license server.
|
Setting |
Description |
|
Configure as lmadmin server |
Select this check box if you are using lmadmin to configure the license server. |
|
Alias |
Enter a display name that is used to identify the license server. To ensure that the display name is unique, the FlexNet Manager for Engineering Applications host name followed by a dash is automatically prepended to this alias. Caution:If there are duplicate license server names in the FlexNet Manager for Engineering Applications's config.xml file, the agent will fail to start. The FlexNet Manager for Engineering Applications log will display a FATAL "duplicate license server name” log message. |
|
License Manager |
The full path to the lmgrd executable for the license server. For lmadmin, specify the path for lmadmin.exe. |
|
lmutil Executable |
The full path to the lmutil executable (lmutil.exe). FlexNet Manager for Engineering Applications needs this location in order to be able to obtain usage information, which is used in the Operational Dashboard, available from FlexNet Manager for Engineering Applications. |
|
Debug Log |
If the license server has an existing debug log, specify it. If a debug log does not yet exist, specify the location where it should be written for lmgrd. For lmadmin, specify the path of lmadmin.log. |
|
License Locations |
Click the Add button to open a file browser to add a license file or directory containing one or more .lic files. To add additional files or directories, repeat the process. |
| 4. | If you selected the Show Advanced Settings check box in Step 2, the Step 4 of 5 panel is displayed next. Configure the settings, as needed. |
|
Setting (Advanced) |
Description |
|||||||||
|
User Data Directory |
The directory in which all FlexNet Manager for Engineering Applications–specific data is kept. It is recommended that you back up this area on a regular basis, and before upgrading to a newer version of the FlexNet Manager for Engineering Applications. Use the default location or specify your own. The default directory is: agent_install_dir/data |
|||||||||
|
Logging Threshold |
The maximum level of detail for messages written to the FlexNet Manager for Engineering Applications log file. Only messages at or below the selected level of detail will appear in the log. Select the following options, as needed:
|
|||||||||
|
Virtual Machine Heap Size |
Specify the initial and maximum heap size (in MB). |
| 5. | If you selected the Show Advanced Settings check box in Step 1, the Step 5 of 5 panel is displayed next. Configure the settings, as needed. |
|
Setting (Advanced) |
Description |
|
SECURE BROKER SETTINGS |
|
|
Broker Username |
The Broker Username and Password settings can be used to password-protect the message queue communication. |
|
Broker Password |
|
|
SECURE SERVER SETTINGS |
|
|
SSL Keystore Location |
The name and location of the server-side keystore file that contains the key entry for the certificate that FlexNet Manager for Engineering Applications Admin uses to provide SSL connections to its clients (for example, browsers or activation utilities). Use the default location only if you are using the bundled or another keystore for testing. Otherwise, point to a location of a keystore outside the FlexNet Manager Admin installation. |
|
SSL Keystore Password |
The password used to secure the keystore that contains the certificate used for authenticating the SSL server to the SSL client. The same password is used to secure the certificate key. Provide confirmation for the password. |
|
SECURE CLIENT SETTINGS |
|
|
SSL Truststore Location |
The name and location of the client-side truststore file that contains the trusted certificate entry for a remote SSL server (for example, an LDAP server). Use the default location only if you are using the bundled truststore. Otherwise, point to a location of a truststore outside the FlexNet Manager Admin installation. |
|
SSL Truststore Password |
The password used to secure the truststore. The same password is used to secure the certificate key. Provide confirmation for the password. |
| 6. | Click Finish. |