Data Export
The Data Export tool allows you to export data from adTempus. You can export data to a file to be saved for backup or to be transferred to another adTempus server. You may also export the data directly to any other server to which the Console is currently connected.
You can only export data for which you have Modify permission.
If you are trying to recreate your adTempus instance in a new database, it may be simpler to do this by copying the entire database rather than exporting and importing all of the data. See Duplicating an Instance.
Data Export Window
Object Selection
In the Data Export window, select an object type to view a list of objects of that type, then select the objects you wish to export. You can export objects of multiple types at the same time (e.g., you can export jobs and shared schedules).
When you export an object, any objects on which it depends are automatically exported. For example, when you export a job, any scripts, notification recipients, shared schedules, etc., that are used in the job are exported with it. Thus if you want to export a single job, that is the only object you need to select.
adTempus 4.0 and later use a different export format than previous versions of adTempus, but is able to read and write the format used by version 3.
Server Settings
You can choose which server-level settings are included. If you are trying to create an exact copy of this adTempus instance these settings should all be included. You can also create an exact copy by copying the database.
- General server settings: Includes server configuration settings not covered by other categories, such as backup and alerting settings, history retention settings, etc.
- Server-level job variables: Includes server-level Job Variables defined in the Server Options window.
- Audit and snapshot options: Includes the settings from the Audit and Snapshots page of the Server Options window.
- Top-level security containers: Includes the default object security that applies to objects such as Shared Scripts, Notification Recipients, etc.
Export all data
Check this option to export all the data that you have permission for (all the objects in all of the categories available for selection).
Options
Include history when exporting jobs
When this box is checked, adTempus will include the history (instance details and log messages) for all exported jobs. Otherwise, history will not be included.
You must check the corresponding box when you import the data, or the history data in the file will be ignored by the import process.
Optionally you may specify a date/time range for the history to be included.
Sensitive Data
The data export can include sensitive data like passwords, API credentials, and hidden (secret) Job Variables. Sensitive data is encrypted when it is written to the export file. By default adTempus uses a standard encryption key that allows the file to be read by any other adTempus installation. This means that although the data is protected from people who casually view the export file, it is possible for anyone with a copy of adTempus to read and view the data.
To protect your sensitive information:
- If you are sending an export to Arcana Development for technical support, or to anyone else who does not need access to this information, check Exclude sensitive information and this information will be left out of the export file.
- If you need to include sensitive information, use a strong password to protect the data. This will encrypt the data using the password you provide rather than the default encryption settings, making the data unreadable by anyone without the password.
- If you are connected to a server older than version 6, the Exclude sensitive information option is not available. You can still uncheck Include passwords for credential profiles to exclude passwords, but other sensitive information will be included.
Include passwords for credential profiles
When this box is checked, adTempus will include the passwords for any Credential Profiles associated with jobs being exported. If this box is not checked, passwords are not included, and you will be prompted for the password for each Credential Profile when the data is imported.
Specify a password to protect sensitive data
For maximum protection you can provide your own password to use when encrypting data. The same password will be required when the data is imported.
Comments
You may optionally enter comments that will be stored in the export file. The comments are displayed when the file is selected in the Import Wizard, and can also be seen by viewing the file with a text or XML viewer.
Export
Export to File
Select this option to save the exported objects to a file. See the import/export overview topic for more information on the file format.
File Format
Select the format for the export file.
- adTempus 6.0+ Compatible This format uses a newer encryption scheme for sensitive data and can be read by version 6.0 and later. Earlier versions will not be able to read the file.
- adTempus 5.0.5+ Compatible This format supports protection of hidden Job Variables (see support article K00000637) and can be read by version 5.0.5 and later. Earlier versions will not be able to read the protected values.
- adTempus 5+ Compatible. This format does not protect hidden Job Variables and can be read by version 5.0 and later. If the Advanced Server Option "DataProtection:RequireHiddenVariableEncryptionInExport" is set to true, attempting to use this format will produce an error if the exported data contains hidden Job Variables.
- adTempus 4.10.1+ Compatible This format supports protection of hidden Job Variables (see support article K00000637) and can be read by 4.x versions 4.10.1 and later and by 5.x versions 5.0.5 and later. Earlier versions will not be able to read the protected values.
- adTempus 4+ Compatible. This format does not protect hidden Job Variables and can be read by version 4.0 and later. If the Advanced Server Option "DataProtection:RequireHiddenVariableEncryptionInExport" is set to true, attempting to use this format will produce an error if the exported data contains hidden Job Variables.
- adTempus 3 Compatible. The file can be used to transfer data to an adTempus version 3 installation, but adTempus will not be able to export objects or settings that are not supported by version 3.
Export to Server
Select this option to transfer the objects directly to another server. Only servers to which the Console is currently connected will be listed.