Running the Reporting Installation Wizard

You can install the Reporting component using the installation wizard if you have a display set. When the installation wizard is run, it automatically runs the Reporting Configurator, which is where you specify configuration information.

To install the Reporting 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 Reporting installer has the following format:

flexnet_manager_reporting-<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 Reporting files. It may take a few minutes for the Reporting installer window to appear.

3. In the Welcome 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 Reporting component, then click Next. The default installation directory depends on the platform, as follows:
• Windows: C:\Program Files\FLEXnet\manager\reporting
• Red Hat Linux: /opt/FLEXnet/manager/reporting

To install in the default location, you may need system privileges. The installation directory you specify is referred to as reporting_install_directory.

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 Reporting files into the installation directory you specified.

After the files are installed, the Reporting 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/
License Server Host and Port

The license-rights source.

• If license rights are not served by a license server, choose License File Path. Specify the location of the license file for FlexNet Manager for Engineering Applications that you received from Flexera and saved. Browse to, or type the location. This license file is copied to: <admin_install_directory>/config/license/
• If license rights are served by a FlexNet Publisher license server system, choose License Server Host and Port. Specify the host and port from the SERVER line of the license file for FlexNet Manager for Engineering Applications that you received from Flexera.

HTTP Port

The HTTP port on which the Reporting 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 Reporting is installed, if the machine hosts a firewall.

The default value is 8899.

JBoss Management Port

The port used to issue commands to the JBoss server. This is used to stop the server.

The default value is 9984.

Install As Service (Windows only)

If you want FlexNet Manager for Engineering Applications Reporting to run as a Windows service, select the checkbox.

If it is installed as a Windows service, you can start and stop FlexNet Manager for Engineering Applications Reporting through the Services window available from Start | Control Panel | Administrative Tools | Services.

You can re-run the Reporting Configurator to configure and install the service later.

Use Local System Account
(Windows only)

By default, if you install FlexNet Manager for Engineering Applications Reporting 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/
Service User Password/
Service User Domain

(Windows)

User, password, and network domain for the user that runs the Windows service that manages FlexNet Manager for Engineering Applications Reporting.

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 application log file before FlexNet Manager for Engineering Applications Reporting starts.

Only messages at or below the selected level appear in the log.

Virtual Machine Heap Size

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 Reporting 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 Reporting listens for HTTPS requests that it serves. The default port is 8454.

FlexNet Manager for Engineering Applications Reporting 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 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 Reporting 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 for Engineering Applications Reporting 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 Reporting 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 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 8018.

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 Reporting. 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:

• Microsoft SQL Server: 1433
• Oracle: 1521

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 Reporting.

The default database name is flexnetreporting.

FlexNet DB User

The user that FlexNet Manager for Engineering Applications Reporting application uses to connect to the database.

The default FlexNet DB user is flexnetreporting.

After you finish the Reporting installation, you will create the empty Reporting 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 Reporting.

Important:The Oracle tablespace must be created manually before you create the empty Reporting database that FlexNet Manager for Engineering Applications Reporting 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 Reporting application uses to connect to the database.

The default FlexNet DB user is flexnetreporting.

After you finish the Reporting installation, you will create the empty Reporting 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 Admin server.

Setting

Description

Admin Server Name

Specify the fully qualified name of the host machine where FlexNet Manager for Engineering Applications Admin is installed.

Important:It is recommended that you install the Reporting and Admin components to separate host machines.

Admin Server HTTPS Port

Specify the HTTPS port for the FlexNet Manager for Engineering Applications Admin server.

By default, the communication between the Admin and Reporting servers is via SSL.

The default port number is 8444.
13. After you have finished entering configuration information, click Finish. The configuration information is processed and the new settings are merged into the site directory. This may take several seconds.
14. After the configuration information is processed, the final installer window opens. Click Done to close the installer window.
15. After installation, you need to create the Reporting database. See the section, Creating an Empty Reporting Database, for instructions.