Scops Docs
Docs Download

Import and export

Move database definitions from one Scops server to another: how to reach each database and where it belongs.

Settings, Import and Export on Export, with 9 production databases selected and Passwords on

Before you begin

  • You need Manage Settings and Manage databases. To export passwords, you also need Manage credentials.
  • An import stops at the database limit of your edition.

Export databases

  1. On the old server, open Settings › Import & Export and select the databases.

  2. To include the passwords, turn on Passwords and type a passphrase of 12 characters or more two times. Keep it for the import.

  3. Click Export n. Your browser saves a JSON file.

The file has the addresses of your databases and the user names that Scops signs in with. Keep it safe, also without passwords.

What the file holds

In the fileNot in the file
The connection of each database: host, port, service name, DBID, name and roleThe data that Scops collected
The names of its environment, group, owner, policies and credentialThe contents of the policies
Its display name, notes, and Ask Scops and Cache switchesThe Diagnostics and Tuning Pack and Radar switches
The credentials, and their passwords only with Passwords onOS log settings, and the settings of Statistics, Compression and Archiving

Import databases

The Import tab after Scops read a file: four new databases, two already here and one that cannot be added
Scops writes nothing until you click Add.

  1. On the new server, open Settings › Import & Export and click Import.

  2. Click Choose a file and select the file. If it has passwords, type the passphrase and click Read.

  3. Check the Status of each database. Clear the databases that you do not want.

  4. Click Add n, then Done.

StatusMeaning
NewNot on this server. Scops selects it.
Already HereThis server has it, with the same DBID and role, or the same host, port and service. Scops does not change it.
Cannot Be AddedIts host, port or service name is missing.

Finish an import

Scops adds the databases as offline, with no connection test. It checks each one every 5 minutes, and a database becomes online when Scops can reach it.

  1. Set the password of each new credential that has none, in Settings › Security › Credentials.

  2. Set up each new policy in Policies. Scops creates a missing policy empty.

  3. Where you need them, turn on Diagnostics and Tuning Pack in Edit Database, and Radar in Policies › Monitoring.

Move to a new server

  1. Install Scops on the new server.

  2. On the old server, export all databases with Passwords on.

  3. On the new server, import the file and finish the import.

  4. Set up again what the file does not hold. See What the file holds.

Add a databaseAdd one database with a test. PasswordsThe recovery code on a new server.

Updated October 29, 2026