Migrating to a new iTDS Server

Modified on: Mon, 5 Jun, 2023 at 1:48 PM


Moving away from the Virtual Machine (VM) based iTDS deployment to the recommended Docker based iTDS deployment is the main reason for migrating data from an existing iTDS deployment to a new one.

In most other cases this migration is not necessary and the existing iTDS can be updated in place instead.


An iTDS migration follows these high-level steps:

  1. Deploy the new iTDS
  2. Update the existing iTDS
  3. Create a backup of the existing iTDS
  4. Restore the backup on the new iTDS
  5. Update the Seed URL in the Maltego Client to point to the new iTDS

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

Deploy the new iTDS

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 provided here.


2. Update the existing iTDS

Follow the Update your iTDS guide to update your existing iTDS to the same version as your new iTDS.


3. 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>:<admin ui port>/iTDS).


From the main interface page, you can then click on the Backups/Restore 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.



4. Restore the Backup

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


On the new servernavigate to the Backup/Restorpage 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.



5. Update the Seed URL

The Maltego Client uses the Seed URL to discover Transforms, Entities and Machines from the iTDS.


To point the Maltego Client to the new server, you will need to update the Seed URL to point to the new server.


Note: A recent update changed the seed URLs to run on port 443 instead of running on port 8081. This was to avoid issues customers were having connecting to 8081 through their firewall


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




To update the Seed URL in your Maltego Client, go to the home page of the Maltego 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:




Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.