Creating a backup - Creating a backup - Other - Other - OnBase Integration for Salesforce - Other/OnBase-Integration-for-Salesforce/3.3/OnBase-Integration-for-Salesforce/Appendix/Using-the-OnBase-Integration-for-Salesforce-Data-Migration-Utility/Creating-a-backup - 3.3 - 3.3

OnBase Integration for Salesforce
Platform
Other
Product
OnBase Integration for Salesforce
Release
3.3
License
ft:lastPublication
2026-08-20T22:05:38.760000
ft:locale
en-US

This section describes how to use the OnBase Integration for Salesforce Data Migration Utility application to back up the application data and Salesforce Content Migration configurations.

To back up application data and configurations:

  1. Launch a command prompt with elevated privileges.
  2. Navigate to the folder on your computer where the OnBase Integration for Salesforce Data Migration Utility application is located.
  3. Enter the complete name of the utility (Hyland.Verticals.OIFS.DataMigration.Admin.exe) after .\, followed by a space and backup
    For example:
    .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup
  4. To specify the location of the Salesforce organization or the URL from which you want to back up data, enter .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n [URL] where [URL] is the path to the Salesforce organization URL
    For example:
    .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com
  5. To specify the Salesforce organization type, enter
    .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t [type] where [type] can be either Sandbox or Production.
    For example:
    .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t Sandbox
  6. To specify the user name required to log on to the Salesforce organization, enter .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t Sandbox -u [user name] where [user name] is the name of the user required to log on to the Salesforce organization.
    For example:
    .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t Sandbox -u example@hyland.com
  7. To specify the required password, enter .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t Sandbox -u example@hyland.com -p [password] where [password] is the password required to log on to the Salesforce organization.
    For example:
    .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t Sandbox -u example@hyland.com -p password
  8. To specify the required security token, enter .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t Sandbox -u example@hyland.com -p password -k [token name] where [token name] is the security token required to authenticate a user on the Salesforce organization.
    For example:
    .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t Sandbox -u example@hyland.com -p password -k k5NfcZA7XmGIgnoedA0IZwsF
    Note: You must enter a token name only if you are using the Bulk API 1.0. The token must be 24 characters long and have a combination of both numbers and letters.
  9. To specify the schema file name, enter .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t Sandbox -u example@hyland.com -p password -k k5NfcZA7XmGIgnoedA0IZwsF -d [schema] where [schema] is hfs__migrationconfig_3_0 for OnBase Integration for Salesforce 3.0.4
    For example:
    .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t Sandbox -u example@hyland.com -p password -k k5NfcZA7XmGIgnoedA0IZwsF -d hfs__migrationconfig_3_0
    Note: The schema files are typically included in the OnBase Integration for Salesforce Data Migration Utility application. However, you may create a custom schema file or use a different schema file name, if required. The file must have the .json extension.
  10. To specify the output directory, enter .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t Sandbox -u example@hyland.com -p password -k k5NfcZA7XmGIgnoedA0IZwsF -d hfs__migrationconfig_3_0 -o [output] where [output] is the full path to the folder where the backup files will be stored.
    For example:
    .\Hyland.Verticals.OIFS.DataMigration.Admin.exe backup -n https://example.sandbox.my.salesforce.com -t Sandbox -u example@hyland.com -p password -k k5NfcZA7XmGIgnoedA0IZwsF -d hfs__migrationconfig_3_0 -o C:\Backup
  11. Press Enter to execute the command.
    Note:
    • The application data and configurations are stored in folders that have the same name as the Session ID. These folders are located within the output directory you specified earlier.
    • You must note the Session ID displayed on the screen after a backup session starts. This is required for resuming a backup session if it is interrupted.