test

N1 Grid Service Provisioning System 5.0 System Administration Guide

Chapter 9 Backing Up and Restoring

The provisioning system includes utilities for completely backing up and restoring a Master Server. These utilities are found in the N1SPS-home/server/bin directory.

By default, the resource store, database contents, data files, configuration data, and keystores are backed up. You can skip backing up these components by using the appropriate command-line arguments.

Backing Up and Restoring the Master Server

ProcedureHow to Back Up a Master Server

Before You Begin

Before you back up the Master Server, any plans or preflights must be stopped, as well as any other tasks, such as comparisons.

Caution – Caution –

Be sure to specify an output directory when you run the backup script. If you do not specify an output directory, the resultant backup file is saved in the N1SPS-home/server/bin directory. If you are uninstalling and then reinstalling the Master Server and the backup file is in this directory, the backup file is deleted. Consequently, you will not be able to restore the Master Server.

Steps

  1. Log into the machine as the user who installed the provisioning system.

    Caution – Caution –

    Do not run the backup script as root. Ensure that you are logged in to the provisioning system's user account.

  2. Change to the directory where the backup script is located.


    % cd N1SPS-home/server/bin

    N1SPS-home is the home directory of the application.

  3. Start the backup.


    % ./cr_backup.sh options

    The following options are available for use with the cr_backup.sh command.

    Note –

    By default, the resource store, database contents, data files, configuration data, and keystores are backed up. You can skip backing up these components by using the appropriate command-line arguments.

    -b

    Master Server base directory.

    -q

    Quiet. No informative messages are printed.

    -nors

    Skip the Resource Store back up.

    -nodb

    Skip the Database, Plug-in, Custom Task backup

    -noconfig

    Skip the Configuration and Keystore backup

    -nokeystore

    Skip the Keystore backup

    -o directory

    Save the backup file in this directory

    The backup script verifies that you have write permissions for the directory you specified. If you do not have write permissions for this directory, the script generates an error.

    If you do not specify a directory, the files are saved in the N1SPS-home/server/bin directory.

    -z

    Compress the resulting backup file

    -1 logfile

    Write log output to the logfile file instead of the default logfile file.

    -gz

    GZip the resulting backup file if gzip is in PATH.

    -shutdown yes

    Shut down the Master Server without prompting the user.

    -u

    Print this information.

    -h

    Print this information.

    The script warns that if you proceed, the Master Server process will stop. Any tasks, such as searches, plans, and comparisons, that are in progress will also stop.

  4. Type y to proceed with the backup.

    The script shows the progress of the backup and displays the location of the backup file.

    The script restarts the Master Server.

ProcedureHow to Restore a Master Server

Before You Begin

Before performing a restore, you must have an installation of the Master Server that contains no data.

Steps

  1. Log into the machine as the user who installed the provisioning system.

  2. Stop the Master Server.


    %N1SPS-home/server/bin/cr_server stop

  3. Change to the directory where the backup script is located.


    % cd N1SPS-home/server/bin

    N1SPS-home is the home directory of the application.

  4. Start the restoration.


    % ./cr_restore.sh options

    The following options are available for use with the cr_restore.sh command.

    Note –

    By default, the resource store, database contents, data files, configuration data, and keystores are restored. You can skip restoring these components by using the appropriate command-line arguments.

    -b

    Master Server base directory

    If you do not use the -b option to specify a directory to in which to restore the backup files, the files are put in the current directory, N1SPS4.1–home/server/bin. If you do not have write permissions for this directory, the software generates an error.

    -q

    Quiet. No informative messages are printed

    -nors

    Skip the Resource Store restore

    -nodb

    Skip the Database, Plug-in, Custom Task restore

    -noconfig

    Skip the Configuration and Keystore restore

    -nokeystore

    Skip the Keystore restore

    -f backupfile

    Restore the contents of the backupfile file

    -l logfile

    Write log output to the logfile file instead of the default logfile file

    -t temp_directory

    Use the temp_directory directory to save temporary files

    -overwrite yes

    Overwrite the existing data during restore

    -shutdown yes

    Shutdown the Master Server without prompting the user

    -u

    Print this information

    -h

    Print this information

    The script verifies that the backup files do not contain any errors. The script warns that if you proceed the Master Server process will stop, if it is not already stopped. Any tasks, such as searches, plans, and comparisons, that are in progress will also stop.

  5. Type y to proceed.

    The script warns that any data currently in the databases will be overwritten with the data in the backup files.

  6. Type y to proceed.

    The restoration proceeds. The script starts the Master Server.

Backing Up and Restoring Remote Agents

To manually back up the Remote Agent, stop the agent and copy the contents of the N1SPS-home/data directory to a safe location. To restore the Remote Agent, stop the agent, and copy the contents of the directory that you saved.