Migrating RIPS

Use the following steps to migrate RIPS2 to RIPS3 on your local server with the help of the RIPS installer:

  • Download the latest RIPS installer version
  • Simply run sudo ./rips3.py rips:migrate --old-installer /opt/rips --last-scan
    • In case that your RIPS2 installer is not located at /opt/rips change the path accordingly
    • Exporting and importing a large amount of scans may take several hours, thus we highly recommend to only migrate the last scan of every application
    • Make sure that you have at least 10 GB of free hard disk space
    • Delete your browser cache after the migration
    • Attention: Use your e-mail address to log-in, it is not possible to use the username anymore
      • The libraries, integrations, and rips-cli use new variable names for authentication
  • The same restrictions apply here that also apply to the installation: port 80 and 8080 have to be free or changed and the data directory can not exist.
    • If you run into a problem and want to rerun the migration you have to delete your data directory first (by default /var/rips3).

The migration does not delete any data. RIPS2 is stopped but not removed. If you experience any problems you can stop RIPS3 (./rips3.py rips:stop) and start RIPS2 again (./rips.py --up).

Example

# Switch to root shell
sudo -s

# Create installation directory with secure permissions
mkdir -p /opt/rips
chown root:root /opt/rips
chmod 750 /opt/rips

# Download installer and make it executable
wget https://files.ripstech.com/installer/rips3.py -O /opt/rips/rips3.py
chown root:root /opt/rips/rips3.py
chmod 755 /opt/rips/rips3.py

# Migrate RIPS
/opt/rips/rips3.py rips:migrate --last-scan

Demo: Migrating RIPS and switching between RIPS2 and RIPS3.