Installing and Logging in to RLM

Before Installation

  • Confirm that you have either a Google Chrome or Mozilla Firefox internet browser.

  • Extensions applications may require additional hardware and resources, depending on utilization. Consider expanding your resources if heavy use of the application is intended.

  • If you are not using Tufin OS, we recommend that you open a support ticket for a walkthrough before installing an Extension application for the first time. Note the initial setup for all Extensions applications is the same.

  • Users and workflows for RLM.

  • Create workflows in SecureChange. It is strongly recommended that these workflows be unique for RLM, as unique workflows may be needed for compliance/audit requirements and can be used in future reporting. For more information, see TOS Admin: Creating Users and Workflows.

Install Process

These instructions apply if you are:

  • Installing RLM for the first time.

  • Upgrading to a TOS Aurora version that requires a new installation.

  • Upgrading RLM.

Retrieve Installation File

You can download all Extensions application files, either locally or downloaded to a relevant server, from the Customer Portal Download Center.

  1. From the Download Center, select the Extension to download.

  2. Select the method for downloading the installation package: Download to Computer or Copy link (valid for 10m). Using the link requires the server to have access to download from https://tosportaldownloads.tufin.com.

  3. If you downloaded the package, upload it from your local computer to the primary data node to the directory c:/opt. Upload the file as is; do not extract it first.

  4. If you copied the link, run the following command. If the link has expired, get a new link from the Download Center.

    curl -o rlm-v<APP-VERSION>-k3s.run “<LINK>”
    curl -o rlm-v<APP-VERSION>-k3s.run “<LINK>”

    where

    • <APP-VERSION> is the version number (as written in the file name in the Download Center).

    • <LINK> is the link you copied from the Download Center.

Procedure

  1. Using SSH, log into the TOS Aurora server.

  2. Create a directory called /opt/extensions.

  3. Copy the installer run file (already downloaded) to /opt/extensions.

  4. Go to /opt/extensions.

  5. Go to the folder and run the installer file:

    # sh rlm-v<VERSION>.k3s.run

RLM is installed in the TOS Aurora cluster on the data node.

A license is required if you are running TOS Aurora R23-1 or earlier, or you have a legacy (non-tiered) TOS license - see Installing a License.

During installation, RLM creates a Rule Recertification workflow called RLM Rule Recertification Workflow (if no workflow by that name already exists). This workflow includes three steps with the rule recertification field defined in each step. The user, with permissions to modify workflows, must login to SecureChange to complete the setup by adding an assignee for each step. The end user does not need to use this workflow.

Troubleshooting Installation

Error Message

Next Steps
Error: TOS isn't running If you receive this message while trying to install an Extension and you are not using Tufin OS, the issue may be related to your OS user permissions. Please contact Tufin Support for instructions.

Log into RLM

Rule Lifecycle Management App (RLM) is located in the SecureChange server. To log in to RLM, use your SecureChange user credentials provided by your App Administrator or TOS Administrator.

Your user credentials determine your level of access to RLM. App Administrators can configure RLM, change settings, and map Rule Owners and network devices. Rule Owners can view rules for which they are responsible and mark rules for certification or decertification. See Create Users in SecureChange for a detailed list of permissions for each user type.

Access RLM from SecureChange

From R23-1, use the app launcher icon () and select Rule Lifecycle Management.

Note that this option only appears after RLM installation.

Log in to RLM Directly

Without SSO Enabled

  1. In your browser, enter the following URL:

    2. https://<SecureChange_Host>/apps/public/rlm

    The RLM login page appears.

  2. Enter your user credentials and click Login.

With SSO Enabled

  1. In your browser, enter the following URL:

    2. https://<SecureChange_Host>/apps/rlm

    The TOS login page appears.

  2. Enter your user credentials and click Login. The RLM extension opens automatically.