Installation Instructions

If you are installing a version older than 1.24.60, please see the instructions: Install CodeMRI® on Linux (pre-1.24.60)

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.

CMRI should now be operational, start Command Prompt and run the command cmri --help. You should see the following output on your terminal:

Welcome the CodeMRI(R) CLI Reference. The CodeMRI(R) Command-line Interface (CLI) provides an easy to use interface for administering and using your CodeMRI(R) product. To get started, see General Invocation.

Press q then enter to return to the terminal.

  1. Before using CMRI, you will need to create a vault. It's recommend to create a folder called “vault”.

    1. Using CMRI in the installation directory will cause complications, you must create the vault in a different directory. 

    2. Navigate to the directory where you want your vault to be created. Alternatively, specify the directory path using the --vault flag for the command below.

    3. Run cmri vault create and answer the prompts given.

Contact information for vault creation does not need to match the license email.

  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.