Migrating from VM to the new dockerized iTDS server usually involves the following steps:

  • Deploy the new server
  • Create a backup on the old server 
  • Restore the backup on the new server
  • Update the seed URL in the Maltego client to point to the new server


Please ensure that the new server instance has successfully been restored before deleting the old server VM. 

1. Deploy the new server

You will need to deploy and activate the new server in your environment so that you can begin the migration to the new server.


Instructions for deploying and then activating our servers are listed here.


2. Create a Backup

The iTDS includes the functionality to create a full backup of the server.


The backup will include all server information, including paired configs uploaded to the server.


To access the backup menu, open the iTDS admin interface (https://<server ip>/iTDS).


From the main interface page, you can then click on the "Backups" link.



From the backup page, you will have the option to set a password for the backup.


After clicking "Create Backup", a backup file will be downloaded in your browser with the contents of your server.



Please Note: Creating a backup will clear your activation certificate. Requiring you to re-activate the server from https://<server ip>/


3. Restore the Backup

With the backup file created on the old server, we now want to import the backup onto our new sever.


On the new server, navigate to the Backup/Restore page in the admin interface.


Under the "Backup File" heading, select the file that was exported from the old server.


With the file selected, click "Restore Backup" to restore the information from your old server onto your new server.



Please Note: Restoring a backup will clear your activation certificate. Requiring you to re-activate the server from https://<server ip>/


4. Update the Seed URL

The Maltego client uses the seed URL to discover transform, entities and machines from the iTDS.


In order to point the Maltego client to the new server, you will need to update the seed URL to point to the new server.


Please Note: A recent update changed the seed URLs to run on port 443 instead of running on port 8081.


You can view the latest seed URL of your server seed by navigating to https://<server ip>/iTDS/seeds



To update the seed URL in your Maltego client, go to the home page of the client. Hover your mouse over the hub item that you want to update and click "Details".



A new window will appear that allows you to edit the seed URL used: