Utility: mxserver

Syntax

mxserver {-h} {-p port_number} {-x debug}
    {-f license_file} {-a access_file}
    {-reg} {-unreg}

Description

The network license server.

Parameters

None

Switches

• -a access_file
  Informs mxserver to use the file access_file as the site-specific access control file. By default, mxserver will use $MXSITE/fire.access - if it exists - as the access control file.

• -f license_file
  Tells mxserver to use the file license_file as the license file. The default license file name is $MXSITE/fire.lic.

• -h
  Print a usage summary on stderr.

• -p port_number
  Use inet port number port_number instead of resolving the port from environment variable MXSERVERPORT or consulting NIS /etc/services. This is a UDP port, and typically port 2001 is used.

By default, mxserver will first use environment variable MXSERVERPORT and, if it is not defined, look up service name "mxserver/udp" in NIS /etc/services to determine its inet port number.

• -reg
  Register mxserver as a Windows NT service. This will enter it into the Windows NT services panel. To ensure that it gets kicked off every time the machine reboots, the services panel should be opened and its disposition set to Automatic. This option is available on Windows systems only and should be executed as a user with Administrator privileges.

• -unreg
  Unregister mxserver as a Windows NT service. This will stop the service and remove it from the Windows NT services panel. This option is available on Windows systems only, and should be executed as a user with Administrator privileges..

• -x debug
  Set internal debugging messages on (if debug != 1) or off (if debug = 0).

This will cause a lot of information to be output to mxserver's stderr.

The default state of debugging is 0 (off).

Required

TCP/IP network services.

mxserver is itself a licensed program and therefore requires the installation of a license file. The license file must be created specifically for the nominated license server host. There must be a valid license for product mxserver, node-locked to the nominated server host.

Notes

On Unix systems, mxserver normally runs as a daemon process. It is typically started by the system start-up scripts on the license server host. If the environment name MXSITE is undefined when the server is started, the -f option should be used with the full path name of the license file.

There is a script supplied to run mxserver as a daemon process on Unix: mxserverd. The script is typically placed in the /etc/init.d directory for mxserver to be started and stopped at boot and shutdown time respectively. It will require some minor editing to define the location of the Fire installation home and a location in which temporary PID (process ID) files are located. The variables to be set are clearly marked via comments within the script.

To start the mxserver process manually:

/etc/init.d/mxserverd start

To stop the mxserver process manually:

/etc/init.d/mxserverd stop

mxserver outputs logging information to its stdout and debugging information to its stderr.

Licensed client programs will locate the server host using the host name mxserverhost.

See Also