Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The information on this page refers to License Statistics v6.0 or newer, which made changes to the License Statistics installation procedure. If you are running a previous version of License Statistics, see documentation for previous versions.


Info
The following steps are designed to help you get a new License Statistics installation up and running on Linux

...

Step 1: Prepare files prior to upgrading.

  • If this is an initial installation (not an upgrade), skip this step.
  • If you are upgrading from a previously installed version, it is important to do the following before installing the new version of License Statistics:
    • Back up the database.
    • Copy the License Statistics configuration file (xflicstat.cfg), license file (license.lic), and third-party utilities (for example lmutil.exe) to a safe location.
    • Remove the current installation folder before installing the new version, because the License Statistics installation will not remove the currently installed version and will not install a new version into the same location as a previous version.

...

. To update an existing License Statistics installation, please see Updating License Statistics.
  1. Download the License Statistics installation from

...

  1. the License Statistics download page.
    • If you have purchased License Statistics: Enter your Activation Key

...

    • , included in

...

    • the email sent to you after purchasing

...

    • License Statistics

...

...

  1. Start the installer and follow the installation

...

  1. instructions.

Note the following:

  1. Info

    Administrator privileges are recommended, but not required to install License Statistics on Linux. You can install License Statistics on any machine, not necessarily the license server.


    Info
    The installation program works on most Linux distributions; however, if you have a problem running the installer, you can

...

  1. install License Statistics using a command prompt.

...


  1. Activate the license.

...

  • If you are activating the License Statistics license during installation, you can activate your license over the internet, copy the existing license file, or choose a 30-day trial.
  • Otherwise, activate your license online to obtain a license file.
  • By default, the license file will be copied to the license subdirectory of the License Statistics installation directory. You may specify a different location for the license file during installation if desired.

Step 4: Configure License Statistics for your site.

  • If this is an initial installation (not an upgrade), review all configuration settings and modify xflicstat.cfg as needed to customize License Statistics for your site.
  • If you are upgrading from a previous version, compare the newly installed xflicstat.cfg configuration file with your backed up xflicstat.cfg file, and edit the settings in the new file as needed. We do not recommend reusing your old xflicstat.cfg file, as the new configuration file may contain new or changed items.
  • Important: Do not change the structure of the new xflicstat.cfg file.

If you have questions about how to configure License Statistics for your site, please contact X-Formation Support.

Step 5: Obtain all needed utility executables.

...

  1. Info

    You must re-activate your license whenever you upgrade your license or renew your maintenance.


  2. Configure License Statistics using the xflicstat.cfg file.

    Info

    Be careful not to change the structure of the xflicstat.cfg file when editing configuration settings.


  3. Start the xflicstat service.
  4. Test that License Statistics is running normally by using the Open Browser button in the License Statistics Manager, or by going to http://localhost:80 (or other address matching your configuration). The first time you access the License Statistics web interface, your login credentials will be set to username = admin, password = admin.


Tip

To begin monitoring license servers after a new installation, add the license server(s) to be monitored as instructed in Adding and editing license servers


Tip
  • Make sure you have all the utility executables required by the license servers you will be monitoring

...

  • , as described in License server dependent requirements.
  • Ensure the utility version corresponds with the license server version. If you don't know which version to use, please contact your vendor.

...

  • Make sure that 3rd party utilities are always stored outside of the License Statistics

...

Step 6: Restore the database if needed.

  • If this is an initial installation (not an upgrade), skip this step.
  • If you are upgrading from a previous version, restore your database before running the application for the first time.

Step 7: Start the service.

Use the init script to start the service.

Step 8: Configure the license servers

To configure license servers to be monitored by License Statistics, see Adding and editing license servers.

When you configure your license servers, specify the path to your query tool if needed.

Step 9: Test that License Statistics is running normally.

  • A couple of minutes after starting the service, review the log files and ensure they contain no ERROR or WARNING lines that indicate problems with parsing, monitoring servers, or adding or editing license serversThe following output messages indicate the service is running normally:
No Format
Ready for querying...
To view statistics please go to http://localhost:80

...

  • installation directory so they will not be removed by the installer upon subsequent installations.