Archiving data by using TrueSight Server Automation jobs

Use the run_archival_from_tssa.nsh script to archive data by using TrueSight Server Automation jobs. The run_archival_from_tssa.nsh script uses archival settings, such as archive directory location and retention period for domains, that you configure by using the TrueSight Server Automation - Data Warehouse console. This script is included in the content_installer.zip file, which is located in the <TSSA-DWInstallationDirectory>/bsa/content_installer directory.

Before you begin

Before you archive the reports data warehouse data, ensure that these prerequisites are met.

To run the archival process by using TrueSight Server Automation jobs

1. Extract the contents of the content_installer.zip file to a directory of your choice on the TrueSight Server Automation Application Server. 

2. Run the content installer.
   The script is added to TrueSight Server Automation as a Network Shell script. 

3. Create a Network Shell Script Job for the run_archival_from_tssa.nsh script by performing the following steps:

   1. Log in to the TrueSight Server Automation console.
   2. Navigate to the Depot/TSSA Reports Scripts/Run TSSA-DW Archival folder.
   3. Right-click Run TSSA-DW Archival Script and select the NSH Script Job option.
      The New NSH Script Job wizard starts.
   4. In the Name field, enter name of the NSH Script Job.
   5. In the Save in field, enter the path where you want to save the job, and click Next. 
   6. In the Targets pane, select the report servers on which you want to run the archival process, and click Next.

   7. In the Parameters pane, set the ETL_HOME parameter as the directory in which the ETL-related files (extract, transform, and load) are located.
      The default location is <TSSA-DWInstallationDirectory>/shared/bdi/bin. Enter the path in the NSH format.

      Using existing jobs

      If you want to run ETL or archive data by using the existing TrueSight Server Automation jobs, the following fields need to be modified:

      Script name	Field/Parameter
      run_archival_from_tssa	ETL_HOME, Target Server
      Run ETL from TSSA Script	ETL_HOME, Target Server

      
      

   8. Click Next. 
   9. In the Default Notifications pane, configure job run notifications, and click Next.
   10. In the Schedules panel, schedule the job if required, and click Finish.
       The job is created in the location that you specified in step 5.

   You can use this job to run the archival process on the specified servers. You can execute the job for a one-time run or you can create a schedule for the job. For more information about the options available while creating an NSH Script Job, see Creating Network Shell Script Jobs in the TrueSight Server Automation documentation.

4. Run the job against the target report server.
5. (Optional) View the status of the archival job using the TrueSight Server Automation - Data Warehouse console, as described in Viewing-the-status-of-an-archival-job.

Related topics

Archiving-data-by-using-the-console
Rerunning-a-failed-archival-or-restore-session  
Stopping-an-archival-or-restore-process