Server Operation

Start Altair Monitor Manually on UNIX

  1. Ensure that the license license key file is in place (or for customers using a RLM-based licensing environment, ensure that the RLM server is running and Altair licenses are being served).
  2. If starting from a UNIX shell, setup the environment to include the Altair Accelerator commands:
    • UNIX: source the shell-specific vovrc script found in the Altair Accelerator product installation, in the common/etc directory.
    After the environment has been setup, start Monitor using the lmmgr start command. The start command accepts options to override the port, SWD location, and project name, if desired.
The following shows the usage syntax of the lmmgr utility.

lmmgr

Altair Monitor management script. Execute on the server. Some commands require enablement by first typing "vovproject enable licmon". If a project name other than licmon is used, use that name instead.


lmmgr: Usage Message
  
  DESCRIPTION:
      LicenseMonitor management script. Execute on the server. Some commands
      require enablement by first typing "vovproject enable licmon".
      If a project name other than licmon is used, use that name instead.
  
  USAGE:
      % lmmgr <COMMAND> [OPTIONS]
  
  COMMANDS:
      deobfuscate          -- Deobfuscated checkout data that was obfuscated
                              due to license violation. Requires enablement and
                              a valid license file with a proper user count for
                              the dates that contain obfuscated data.
      loaddb               -- Fully load the database. Requires enablement.
      loadremotedata       -- Load data that was copied in from remote instances
                              into the database.
      reset                -- Resets LM. Requires enablement.
      start                -- Starts LM.
      stop                 -- Stops LM.
  
  START OPTIONS:
      -h, -help            -- Print this usage message.
      -v                   -- Increase verbosity.
      -block               -- Do not return to the shell or command prompt
                              after starting. This is only useful, and required,
                              when starting LicenseMonitor as a Windows service.
      -dir   <dir>         -- Choose top directory (it must exist).
                              Default $VOVDIR/../../licmon
      -name  <name>        -- Name for the server (default licmon).
      -port  <port[:port]> -- Colon separated port list wherein each element
                              may be of the form:
                              N         - An integer specifying the exact port
                                          number to use.
                              automatic - Calculates hash of project name to
                                          derive a single port number.
                              any       - Calculates hash of project name to
                                          derive starting port number. Ports
                                          are checked sequentially up to
                                          30000.
                              Projects will not start if all specified ports
                              are unavailable (default 5557).
      -product <product>   -- Product type, one of: lm (default) or lms.
      -webport <port>      -- Web interface port (default 5555).
      -roport  <port>      -- Web interface guest access port (default 5556), or
                              0 if no anonymous guest access port should be
                              enabled.
      -dbhost  <host>      -- Host for database.
      -dbroot  <path>      -- Path, local to database host, for database files.
                              If either -dbhost or -dbroot is left unspecified,
                              the database and historical reporting will be
                              unavailable until configured in the admin UI.
      -dbport  <port>      -- Port of the database to listen for connections.
  
  STOP OPTIONS:
      -f, -force           -- Suppress shutdown confirmation prompt.
      -name <name>         -- Name for the server (default licmon).
  
  EXAMPLES:
      % lmmgr              -- For this usage message
      % lmmgr start
      % lmmgr start -dir ~/MYFTLM -port 7777
      % lmmgr loaddb
      % lmmgr stop
      % lmmgr stop -force -name licmon833
      % lmmgr deobfuscate
      % lmmgr reset
  

Start Altair Monitor Manually on Windows

  1. Download the lm-win64.exe program from the release area of the Altair website and save it into a permanent directory, such as c:\rtda.
  2. Run lm-win64.exe.
  3. Fill out the information to match the desired installation configuration.


    Figure 1.
  4. If not using an Altair license key file, make sure to specify the location of the RLM license server.
    Monitor can now be controlled manually via the Start and Stop buttons.

First Startup

The following actions are performed upon first startup:
  • The server working directory (licmon.swd) is created at the default location of $VOVDIR/../../licmon/licmon.swd, including default configuration files, as well as maintenance tasks for database loading, etc.
  • The server process (vovserver) is started.

When the startup process is complete, the web interface will be accessible at the default URL of http://<HOSTNAME>:5555/cgi/ftlm.cgi.

Start Monitor Automatically at System Startup - Windows

Note: If upgrading from a version less than 2015.03, first stop and uninstall the old service before installing the new service. See the Installation Guide for the specific version for instructions on doing this.
  1. Download the lm-win64.exe program from the Altair website and save it into a permanent directory, such as c:\rtda.
  2. Run lm-win64.exe as administrator by right-clicking it and choosing the Run as administrator option.
  3. Fill out the information to match the desired installation configuration:


    Figure 2.
  4. If not using an Altair license key file, make sure to specify the location of the RLM license server.
  5. Use the Windows Services area to setup and manage a service for controlling Monitor.

Reset Altair Monitor

Resetting Monitor consists of clearing all monitoring data, removing the data collection jobs, and recreating them from the configuration files. This may be required if disk-full or network outage situations occur while Monitor is running.

  1. To reset Monitor via the web interface, navigate to the System page under the Admin tab and click on the reset button.
  2. To reset using the CLI, use:
    % lmmgr reset

Stop Monitor

  1. To stop Monitor, use:
    % lmmgr stop
  2. To stop without prompting for confirmation, use the option -force.