6.2.5 The RLM Web Server

The rlm server contains an embedded Web Server which can be used to perform most administration of the rlm server itself. The web server contains the functionality of all the rlmutil- based utilities except rlmhostid. The web server allows you to retrieve server and license status (similar to rlmstat), cause the servers to re-read the license files (rlmreread), switch debug (rlmswitch) or report log (rlmswitchr) files, move the current report log file to a new name (rlmnewlog), or shut down the license servers (rlmdown). Using this web-based interface, you can administer the license servers from any platform, and do not need to install the rlm utilities - you only need a web browser.

In addition, the web server allows you to edit server option files (if you have access to the edit_options capability - for ISV servers, or the edit_rlm_options capability - for rlm itself.) Also, the web interface allows you to view the recent debug log information from any of the servers if you have access to the status capability. Finally, access to the status, reread, and shutdown commands is controlled by the appropriate capability as specified in The RLM Options File.

The web server is started automatically on port 5054 when rlm is started. To use the web server, simply point your browser to: http://ServerHostName:5054 and select the operation you would like to perform. You will be prompted for any required information.

If you would like to run the web server on a different port, specify the -ws NNNNN command-line argument when starting rlm, where NNNNN is the desired port.

The RLM web server is 100% self-contained in the rlm binary; no additional html files are required for operation.

The web server is disabled if the user running rlm is root or an admin user, starting in rlm v14.1.

The remaining sections will describe some of the main functions of the web interface.