Extract the CLI-based lmagent SFD Executable

  1. On Windows:

    To extract the SFD using the CLI, you should have selected lmagent-win64-cli.exe. This is a subset of Altair software required to support a Monitor agent. This agent will work as both a license management agent and a monitoring agent. The subset components will be extracted into the directory specified by the CLI argument and the agent will run from within that directory. This directory will be overwritten upon each start of this executable in order to facilitate simple upgrades of the agent.

    1. At the command line, navigate to the directory where the SFD was downloaded.
    2. Run lmagent-win64-cli.exe.
      The software will automatically use the defaults during extraction. You can change any of the parameters using the fields as shown below:
      CLI Usage (Windows):
lmagent-win64-cli -host <HOST> [-dir <DIR>] [-port <PORT>] [-instance <NAME>]
                  [-tag <TAG>] [-extract-only 0|1] [-nogui 0|1]

Required arguments for CLI mode:

-host     HOST     -- Name of Monitor server host to connect to.
-dir      DIR      -- Directory in which the agent files should be extracted.
                      Use forward slash (/) for path separator on Windows. The
                      directory path must not contain spaces
                      (default Unix: /opt/altair/agent, Windows: c:/altair/agent).
-port     PORT     -- Port number for LicenseMonitor server (default: 5557).
-instance NAME     -- Name of Monitor instance (default: licmon).

Optional arguments for CLI mode:

-h                 -- Show this help message.
-tag TAG           -- One or more tags to be managed by this agent, passed in as
                      a space-separated list enclosed in either double quotes or
                      curly braces. Can also be 'ALLTAGS' to manage all tags on
                      the current host or can be left empty to use agent as a
                      host monitor only (default).
-nogui             -- For Unix-based platforms, suppress the GUI.
-extract-only      -- Extract only, do not run.
-start-only        -- Start only, do not extract. A previous extraction must
                      exist.
-noblock           -- Return to the shell/command prompt after startup.

Optional arguments for CLI mode on Windows (ignored on Unix-based platforms):

-install-service   -- Install service. The service will point to this
                      executable, so ensure it is in a path that is accessible
                      in a service environment. Requires both the account and
                      password arguments to be passed in addition to the
                      required arguments listed above.
-start-service     -- Start service. Requires no other arguments.
-stop-service      -- Stop service. Requires no other arguments.
-uninstall-service -- Uninstall service. Requires no other arguments.
-account           -- Account to use for service installation. Pass "system" to
                      install the service to run under the system user.
-password          -- Password to use for service installation. Pass "system" to
                      install the service to run under the system user.
  2. On Linux:
    To extract the SFD using the CLI, you should have selected lmagent-linux64. This is a self-extracting installation of the Monitor product. The software components will be extracted into the directory specified by the CLI argument and the product will run from within that directory. This directory will be overwritten upon each start of this executable in order to facilitate simple upgrades of the product.
    1. At the command line, navigate to the directory where the SFD was downloaded.
    2. Run lmagent-linux64.
      The software will automatically use the defaults during extraction. You can change any of the parameters using the fields as shown below:
      CLI Usage (Unix-based platforms):
lmagent-<VOVARCH> -host <HOST> [-dir <DIR>] [-port <PORT>] [-instance <NAME>]
                  [-tag <TAG>] [-extract-only 0|1] [-nogui 0|1]

Required arguments for CLI mode:

-host     HOST     -- Name of LicenseMonitor server host to connect to.
-dir      DIR      -- Directory in which the agent files should be extracted.
                      Use forward slash (/) for path separator on Windows. The
                      directory path must not contain spaces
                      (default Unix: /opt/altair/agent, Windows: c:/altair/agent).
-port     PORT     -- Port number for LicenseMonitor server (default: 5557).
-instance NAME     -- Name of LicenseMonitor instance (default: licmon).

Optional arguments for CLI mode:

-h                 -- Show this help message.
-tag TAG           -- One or more tags to be managed by this agent, passed in as
                      a space-separated list enclosed in either double quotes or
                      curly braces. Can also be 'ALLTAGS' to manage all tags on
                      the current host or can be left empty to use agent as a
                      host monitor only (default).
-nogui             -- For Unix-based platforms, suppress the GUI.
-extract-only      -- Extract only, do not run.
-start-only        -- Start only, do not extract. A previous extraction must
                      exist.
-noblock           -- Return to the shell/command prompt after startup.

Examples:

% lmagent-linux64 -host lmsrv
% lmagent-linux64 -host lmsrv -port 7777 -instance mylm
% lmagent-macosx  -host lmsrv -dir /Applications/Altair/agent -nogui
% lmagent-win64   -host lmsrv -tag "MENTOR SYNOPSYS"
% lmagent-win64-cli -host lmsrv -port 5557 -install-service -account joe -password secret
% lmagent-win64-cli -host lmsrv -port 5557 -install-service -account system -password system -start-service
% lmagent-win64-cli -start-service
% lmagent-win64-cli -stop-service -uninstall-service