Running the Admin Installation Wizard
You can install the Admin component using the installation wizard if you have a display set. When you run the installation wizard, it automatically runs the Admin Configurator, which is where you specify configuration information.
To install the Admin component using the installation wizard:
| 1. | Go to the location where you downloaded the FlexNet Manager for Engineering Applications installer files (flexnet_download_dir), as described in Prerequisites for Installing FlexNet Manager for Engineering Applications. |
The file name of the Admin installer has the following format:
flexnet_manager_admin-<version number>-<platform>.<ext>
| 2. | Run the installer. If you are installing on a machine running Microsoft Windows, right-click on the installer and select Run as Administrator. |
The installer prepares to install the Admin files. It may take a few minutes for the Admin installer window to appear.
| 3. | In the Welcome installer panel, verify that you have read the product documentation and click Next. |
| 4. | In the Install Folder panel, specify the directory in which to install the Admin component. The default installation directory depends on the platform, as follows: |
| • | Windows: C:\Program Files\FLEXnet\manager\admin |
| • | Red Hat Linux: /opt/FLEXnet/manager/admin |
To install in the default location, you may need system privileges. The installation directory you specify here is referred to as admin_install_directory. Click Next.
| 5. | In the Pre-Installation Summary panel, review the installation directory and the space requirements, and then click Install. The installer decompresses and installs the Admin files into the installation directory you specified. |
After the files are installed, the Admin Configurator window opens. The installer window remains open.
Note:You can also run the Configurator later and/or use the FlexNet Manager for Engineering Applications interface to provide additional configuration information.
| 6. | In the first panel of the Configurator (Step 1), provide the license file location and application settings, then click Next. Select the Show advanced settings checkbox to display three additional configuration panels. |
|
Setting |
Description |
||||||
|
License File Path/ |
The license-rights source.
|
||||||
|
The HTTP port on which the Admin server listens. Use the port number for the embedded Web container, or supply a different value. Ensure that this port is open through the firewall on the machine where FlexNet Manager for Engineering Applications Admin is installed, if the machine hosts a firewall. The default value is 8888. |
|||||||
|
JBoss Management Port |
The port used to issue commands to the JBoss server. This is used to stop the server. The default value is 9974. |
||||||
|
Install As Service (Windows only) |
If you want FlexNet Manager for Engineering Applications Admin to run as a Windows service, select the check box. If it is installed as a Windows service, you can start and stop FlexNet Manager for Engineering Applications Admin through the Services window available from Start | Control Panel | Administrative Tools | Services. You can re-run the Admin Configurator to configure and install the service later. |
||||||
|
Use Local System Account |
By default, if you install FlexNet Manager for Engineering Applications Admin as a Windows service, the Local System account will run the service. Clear the Use Local System Account check box to configure another user account to run the service. |
||||||
|
Service User Name/ (Windows) |
User, password, and network domain for the user that runs the Windows service that manages FlexNet Manager for Engineering Applications Admin. For this user to be able to start the service, the user must be listed in the security settings of the Log on as service policy in Windows (Control Panel | Administrative Tools | Local Security Policy | Security Settings | Local Policies | User Rights Assignment). If Local System Account is not used, the service user defaults to the OS user who is running the installer. |
||||||
|
Service User Name (UNIX) |
User who executes the service script. This defaults to the operating system user who is running the installer. |
| 7. | Optional: Select the Show advanced settings checkbox to show additional settings panels—where you can specify logging threshold, JBoss ports, secure server and client settings, and performance settings. |
If you do not select the Show advanced settings checkbox, go to Step 11.
| 8. | Advanced settings panel (Step 2 of 6): If you selected Show advanced settings in Step 1, you can specify user data directory, logging threshold, virtual machine heap size, and JBoss ports. |
|
Setting |
Description |
|
User Data Directory |
The directory in which all enterprise-specific data is kept—for example, usage data and reports are stored here. It is recommended that you back up this area on a regular basis and before upgrading to a later version of FlexNet Manager for Engineering Applications. Important:The data directory is shared between both FlexNet Manager for Engineering Applications components—Admin and Reporting. Ensure that this directory is accessible from both the Admin and Reporting servers. By default, this directory is C:\Program Files\FLEXnet\manager\data |
|
Startup Logging Threshold |
The maximum level of detail for the messages written to the FlexNet Manager for Engineering Applications application log file before it starts. Only messages at or below the selected level appear in the log. |
|
Specify the initial and maximum heap sizes. See Configuring a new certificate with the ‘flexnet site’ command. Important:If you keep the default settings, ensure that the server has 8 GB of RAM available. If the server does not have the minimum amount of RAM, the Admin server will not start. |
|
|
JBoss Ports section |
|
|
Transaction Recovery Port |
The port specified in this setting is available for database-transaction management. The default port is 4722. |
|
Transaction Status Port |
The port specified in this setting is available for database-transaction management. The default port is 4742. |
|
JBoss Bind Address |
Optional setting to specify the address to which the HA-JNDI server will bind waiting for JNP clients. The default value is the host’s default address. This value is useful only for multi-homed computers—for example, if you have multiple network cards in the same machine. The default address is 127.0.0.1. |
|
JBoss Port Offset |
You can use the JBoss port offset to execute several application servers on the same machine. For example, you could use port offset to create a vertical cluster, with multiple nodes on the same machine. In the text field, specify the value by which you want to offset (add to) the port number, in order to avoid port conflicts. For example, if you specify 100 here, this will offset the port number specified in the JBoss Management Port field by 100. The default value is 0. |
| 9. | Advanced settings panel (Step 3 of 6): If you selected Show advanced settings in Step 1, you can specify secure server and client settings. |
|
Setting |
Description |
|
Secure Server Settings section |
|
|
HTTPS Port |
The port on which FlexNet Manager for Engineering Applications Admin listens for HTTPS requests that it serves. The default port is 8444. FlexNet Manager for Engineering Applications Admin is always enabled to accept HTTPS requests, but some additional settings must be configured before using SSL. See Configuring FlexNet Manager for Engineering Applications Admin for Secure Socket Layer for information about configuring SSL for the Tomcat Web container used by JBoss. The URL to connect to the FlexNet Manager for Engineering Applications application with HTTPS is https://host:port/flexnet, where port is the HTTPS port number. Note that HTTPS requests can be handled by a full-featured web server instead of by FlexNet Manager for Engineering Applications Admin itself. |
|
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 keystore for testing. Otherwise, point to a location of a keystore outside the FlexNet Manager for Engineering Applications Admin installation. Note:If you are using the bundled keystore, you need to note this setting in order to enable the flexnet stop command (which stops the FlexNet Manager for Engineering Applications server). |
|
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. The default password value is flexnet. |
|
Secure Client Settings section |
|
|
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 for Engineering Applications Admin installation. Important:Note the SSL truststore location. You will need this to enable the flexnet stop command (which stops the FlexNet Manager for Engineering Applications server). |
|
SSL Truststore Password |
The password used to secure the truststore. The same password is used to secure the certificate key. The default password value is changeit. |
| 10. | Advanced settings panel (Step 4 of 6): If you selected Show advanced settings in Step 1, you can specify an AJP port and performance settings. |
|
Setting |
Description |
|
AJP Port |
The port on which the AJP connector listens. The AJP connector is used to integrate FlexNet Manager for Engineering Applications with a full-function proxy (such as Apache or IIS) server for security or load balancing. The default port is 8010. |
|
Performance Settings section |
|
|
Database Connection Pool Size |
Size of the database connection pool. Ensure that your database is capable of creating the specified number of connections. The default value is 300. A minimum size of 25 is recommended. |
|
Number of Scheduler Threads |
The number of threads allocated for the scheduler. A minimum setting of 30 is recommended. The default value is 30. |
|
Database Transaction Timeout (seconds) |
The number of seconds that the database transaction will run before timeout. A minimum timeout of 3600 seconds is recommended. The default value is 3600. |
| 11. | In the database-server panel, specify configuration settings for the database that you will use with FlexNet Manager for Engineering Applications Admin. |
|
Setting |
Description |
|||||||||
|
Database Server section |
||||||||||
|
Database Type |
The database server you will be using with FlexNet Manager for Engineering Applications Admin. The menu displays the supported database types. For a list of the supported database versions, see the FlexNet Manager for Engineering Applications 2021 R1 Release Notes. Note:Settings in the FlexNet Database section of this panel depend on the database type selected. |
|||||||||
|
JDBC Driver |
The JDBC driver for the selected database. (This is typically bundled with the database.) |
|||||||||
|
Database Server Host |
The machine on which the database server is running. The default host is localhost. Replace localhost with the host name of the machine that hosts the database. A fully qualified host name is not required. |
|||||||||
|
Database Server Port |
The port on which your database server runs. Use the default value for your database server, if you did not change the database-server port number when the database server was installed. Default port numbers for supported database types:
|
|||||||||
|
FlexNet Database section (Microsoft SQL Server) |
||||||||||
|
Database Name |
For SQL Server, the name of the database to create which will contain the tables used by FlexNet Manager for Engineering Applications Admin. The default database name is flexnet. |
|||||||||
|
FlexNet DB User |
The user that FlexNet Manager for Engineering Applications Admin application uses to connect to the database. The default FlexNet DB user is flexnet. After you finish the Admin installation, you will create the empty Admin database for use with FlexNet Manager for Engineering Applications. Doing this (running the command flexnet loaddb) automatically creates the FlexNet DB user. |
|||||||||
|
FlexNet DB Password |
The password to be assigned to the FlexNet DB User. The default password is Flexnet0. It is recommended that this password be changed to comply with your organization’s password policies. See Configuring Database Servers for FlexNet Manager for Engineering Applications |
|||||||||
|
FlexNet Database section (PostgreSQL Server) |
||||||||||
|
Database Name |
For postgreSQL Server, the name of the database to create which will contain the tables used by FlexNet Manager for Engineering Applications Admin. The default database name is flexnet. |
|||||||||
|
FlexNet DB User |
The user that FlexNet Manager for Engineering Applications Admin application uses to connect to the database. The default FlexNet DB user is flexnet. After you finish the Admin installation, you will create the empty Admin database for use with FlexNet Manager for Engineering Applications. Doing this (running the command flexnet loaddb) automatically creates the FlexNet DB user. |
|||||||||
|
FlexNet DB Password |
The password to be assigned to the FlexNet DB User. The default password is Flexnet0. It is recommended that this password be changed to comply with your organization’s password policies. See Configuring Database Servers for FlexNet Manager for Engineering Applications |
|||||||||
|
FlexNet Database section (Oracle) |
||||||||||
|
Database Service Name |
Specify the fully qualified Oracle global database name. |
|||||||||
|
Tablespace |
Name of the tablespace that will contain FlexNet Manager for Engineering Applications Admin. Important:The Oracle tablespace must be created manually before you create the empty Admin database that FlexNet Manager for Engineering Applications Admin requires. See the section, Configuring Oracle, in Configuring Database Servers for FlexNet Manager for Engineering Applications. |
|||||||||
|
FlexNet DB User |
The user that FlexNet Manager for Engineering Applications Admin application uses to connect to the database. The default FlexNet DB user is flexnet. After you finish the Admin installation, you will create the empty Admin database for use with FlexNet Manager for Engineering Applications. Doing this (running the command flexnet loaddb) automatically creates the FlexNet DB user. |
|||||||||
|
FlexNet DB Password |
The password to be assigned to the FlexNet DB User. The default password is Flexnet0. It is recommended that this password be changed to comply with your organization’s password policies. See Configuring Database Servers for FlexNet Manager for Engineering Applications |
|||||||||
| 12. | In the reporting server panel, specify information about the FlexNet Manager for Engineering Applications Reporting server. |
|
Setting |
Description |
|
Reporting Server Name |
Specify the fully qualified name of the host machine where FlexNet Manager for Engineering Applications Reporting is installed. Important:It is recommended that you install the Reporting and Admin components to separate host machines. |
|
Reporting Server HTTPS Port |
Specify the HTTPS port for the FlexNet Manager for Engineering Applications Reporting server. By default, the communication between the Admin and Reporting servers is via SSL. The default port number is 8454. |
| 13. | When you have finished specifying configuration information, click Finish. |
The configuration information is processed, and the new settings are merged into the site directory, which is the directory from which FlexNet Manager for Engineering Applications Admin runs. This process may take several seconds.
| 14. | After the configuration information is processed, the final installer window is displayed. Click Done to close the installer. |
| 15. | After installation, you need to create the Admin database. See the section, Creating an Empty Admin Database , for instructions. |