Import Data into XTAM from Exported File

Importing your data to XTAM from a previously created Export provides a System Administrator with the ability to recover from a lose of data or to rebuild a XTAM deployment on a new host.

Some common use cases include:

  • Disaster recovery
  • Data loss recovery
  • Populating a test or UAT environment with data
  • Switching to a different XTAM database

And as with all things, the following items must be considered when performing an import:

  • This procedure is similar to a database import, meaning all data currently in XTAM will be replaced with that from the import. The process will remove all data currently in XTAM and import only what is contained in the export.
  • If the import is using an encrypted export (which we recommend), then you will need to know the Master Password if importing to a new system.
  • The XTAM instance that will be importing must be equal or newer in version number to the XTAM instance that created the export.

Import back into the same XTAM deployment

How to Import back into the same XTAM deployment using an Encrypted or Decrypted Export.

This procedure details the steps required to import data back into the same XTAM system that created the export.

This procedure supports the use of encrypted or decrypted export files.

  1. Login to XTAM as a System Administrator.
  2. Navigate to Administration > Settings > Database.
  3. In the table list of available exported volumes, locate the one you wish to use and click the Import button to its right.
  4. FAQ-Import-Database-Action

  5. The Import operation will now be added to the XTAM queue and will be executed shortly. Once the import begins, completion time depends on the amount of data that needs to be imported and may take several minutes to finish.

  6. During the import process, the application’s GUI may become temporarily unavailable. To check the status of the operation, you should open the XTAM log file located at $XTAM_HOME/web/logs/pam.log and when the message Importing Complete appears, the operation is finished.

  7. Refresh the All Records page to review the imported data.

Import into a new deployment with Encrypted Export

How to Import into a new XTAM deployment using an Encrypted Export.

 

This procedure details the steps required to import data into a new XTAM system; one that did not create the export.

This procedure supports the use of encrypted export files.

  1. Install a new XTAM system where and as needed.
  2. Once the installation is complete, open a command line on this new host server, navigate to the folder where XTAM is installed ($XTAM_HOME) and issue the following command to update your current XTAM Master Password with the one that was used to create your encrypted export.
    1. For Windows, substitute <MASTER PASSWORD> with the master password used with your export and issue:

      Copy
      bin\PamDirectory.cmd SetMasterPassword web <MASTER PASSWORD>
    2. For Unix or Linux, substitute <MASTER PASSWORD> with the master password used with your export and issue:

      Copy
      bin/PamDirectory.sh SetMasterPassword web <MASTER PASSWORD>
  3. Copy your exported file(s) to your new XTAM system and paste them into $XTAM_HOME/export/ or the custom location you defined in Administration > Settings > Parameters > Export Location.

  4. Login to XTAM as a System Administrator.

  5. Navigate to Administration > Settings > Database.

  6. In the table list of available exported volumes, locate the one you wish to use and click the Import button to its right.

    FAQ-Import-Database-Action

  7. The Import operation will now be added to the XTAM queue and will be executed shortly. Once the import begins, completion time depends on the amount of data that needs to be imported and may take several minutes to finish.

  8. During the import process, the application’s GUI may become temporarily unavailable. To check the status of the operation, you should open the XTAM log file located at $XTAM_HOME/web/logs/pam.log and when the message Importing Complete appears, the operation is finished.

  9. Refresh the All Records page to review the imported data.

Import into a new deployment with Decrypted Export

How to Import into a new XTAM deployment using an Decrypted Export.

This procedure details the steps required to import data into a new XTAM system; one that did not create the export. This procedure supports the use of decrypted export files.

 

  1. Install a new XTAM system where and as needed.
  2. Copy your exported file(s) to your new XTAM system and paste them into $XTAM_HOME/export/ or the custom location you defined in Administration > Settings > Parameters > Export Location.
  3. Login to XTAM as a System Administrator.
  4. Navigate to Administration > Settings > Database.
  5. In the table list of available exported volumes, locate the one you wish to use and click the Import button to its right.FAQ-Import-Database-Action
  6. The Import operation will now be added to the XTAM queue and will be executed shortly. Once the import begins, completion time depends on the amount of data that needs to be imported and may take several minutes to finish.

  7. During the import process, the application’s GUI may become temporarily unavailable. To check the status of the operation, you should open the XTAM log file located at $XTAM_HOME/web/logs/pam.log and when the message Importing Complete appears, the operation is finished.

  8. Refresh the All Records page to review the imported data.