Install CodeMRI® on Linux

 

Installation Instructions

If you are installing a version older than 1.24.60, please see the instructions:

Upgrade Notice

Prior to version 1.24.27, CodeMRI® Platform required a separate installation of Understand. Beginning with CodeMRI® Platform 1.24.27, this requirement has been lifted. You may uninstall Understand by removing the /opt/understand directory.

1. Prepare for Install

  1. Create and or navigate to the directory in which CodeMRI® (CMRI) will be installed.

  2. Verify there is enough storage to install CMRI and store the codebases to be analyzed.

    1. System storage can be revealed by typing df -h into the command line.

  3. If there is enough storage in the desired location, proceed to the installation.

2. Download & Install CodeMRI® (CMRI)

2.1 Acquire CodeMRI®(CMRI)

  1. Navigate to CodeMRI.com and sign In. If this is a new account, click sign up.  Navigate to your email client and validate the email. This email address will become the username for this account.

  2. Navigate to the Downloads page https://codemri.com/installers/ and Download the CodeMRI Platform - Linux

Installation will fail if the install path contains any spaces. 

Please be sure to extract the installer into a path whose name contains no spaces. For example, /opt/cmri. If the installation path contains any spaces, the installation may fail or CodeMRI® may fail to work properly.

2.2 Unpack CodeMRI®(CMRI)

  1. Navigate to the directory containing the CMRI Platform download and run it:
    $ ./CMRI-1.24.60-Linux-x86_64.sh

    1. If it’s not executable on your system you can make it so with $ chmod u+x CMRI-1.24.60-Linux-x86_64.sh

    2. Follow the instructions provided by the installer script

3. Start CodeMRI®

  1. If you don’t already have one open, open a terminal

  2. Add cmri to the path (export PATH=$PATH:/path/to/cmri/bin). This is optional, but if cmri is not on your path, you will need to use the full path when running it.

  1. Create and select a project.

    1. Start the shell by running cmri shell.

    2. Use the project add command to add a new project. CodeMRI® will select the project automatically after it is added.

> project add --name ProjectName

==================================
1 projects and 0 systems selected.

  1. Create and select a system.

    1. Use the system add command as shown below to add a new system. CodeMRI® will select the system automatically after it is added:

> system add --name SystemName --version 47.0 --origin "/path/to/code/"
Successfully added new system to selected project(s).

==================================
1 projects and 1 systems selected.

Note that code (system) added can be compressed or uncompressed.

Once you receive the license code from Silverthread support, enter the code as instructed in the reply and re-run job run produce_reports.

Update from previous version

  1. Uninstall the existing CMRI Platform.

  2. Install the new version, using the installation guide above

    1. Skip the process of creating a vault and logging in if there is an existing vault.