Server Operation

Start Altair Monitor Manually on UNIX

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

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. Requires enablement.
    reset                -- Resets LM. Requires enablement.
    start                -- Starts LM. The project name is the -name option
                            value if present. Otherwise, licmon.
    stop                 -- Stops LM. The project name is the -name option
                            value if present. Otherwise, licmon.

START OPTIONS:
    -block               -- Do not return to the shell or command prompt
                            after starting. This is only useful, and required,
                            when starting Monitor as a Windows service.
    -dbhost  <host>      -- Host for database.
    -dbport  <port>      -- Port of the database to listen for connections.
    -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.
    -dir   <dir>         -- Choose top directory (it must exist).
                            Default $VOVDIR/../../licmon
    -h, -help            -- Print this usage message.
    -name  <name>        -- Name of the Monitor server project name. Used 
                            by the start and stop commands.
    -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.
    -removelockfile      -- Delete server lock file if it already exists.
    -roport  <port>      -- Web interface guest access port (default 5556), or
                            0 if no anonymous guest access port should be
                            enabled.
    -v                   -- Increase verbosity.
    -webprovider <prov>  -- Web provider: internal or nginx. Default: internal.
    -webport <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.
                            (Default 5555).
    -inport <port[:port]> -- ignored
    -eventport  <port[:port]> -- Colon separated update 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 5559).
     -pubkey  <key>       -- Specify the public API key to be added to a new project.
                             If -pubkey is not specified, the public key listed in 
                             ~/.vov/userkey or %PROFILE%/.vov/userkey is added.                            

STOP OPTIONS:
    -f, -force           -- Suppress shutdown confirmation prompt.
    -name <name>         -- Name for the server (default licmon).

LOADDB OPTIONS:
    -start               -- Start time for loading data, (default 1y).

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

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.
Run lm-win64.exe.
Fill out the information to match the desired installation configuration.

Figure 1.

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.

Download the lm-win64.exe program from the Altair website and save it into a permanent directory, such as c:\rtda.
Run lm-win64.exe as administrator by right-clicking it and choosing the Run as administrator option.
Fill out the information to match the desired installation configuration:

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

Troubleshooting: Images Do Not Display

Occasionally, images may not display correct. The images are retrieved from the readonly port (5556 by default) of the licmon server via HTTP. If your images are not displaying, try the following steps:

Check that readonly port is enabled.
Check the DNS/NIS setup and /etc/nsswitch.conf to be sure that the licmon hostname resolves.
Set the environment variable VOV_HOST_NAME in licmon.swd/setup.tcl to a value that resolves to the Monitor server machine.
If an IP address is the only way to access the machine from other hosts, add VOV_HOST_HTTP_NAME with the desired IP address to the setup.tcl file and perform a reread.
To make the change effective immediately, also enter the following commands at the shell. This sets the environment variable in the running vovserver.
```
% vovproject enable licmon
% vovsh -x "vtk_server_setenv VOV_HOST_HTTP_NAME <VALUE>
```

If you are viewing Monitor over a port-forwarded tunnel through ssh, for example, -L 5555:jaguar:5555, the host names differ on each end of the connection. The only way to deal with this is to make the Monitor host an alternate name for 'localhost'. For the above example, where the remote host is 'jaguar', your line in the hosts file would be similar to:

127.0.0.1 localhost jaguar

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.

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

Stop Monitor

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