Sun Grid Engine Information Center
Administering Sun Grid Engine
Index

Backing Up and Restoring Grid Engine Configuration

Backing Up the Grid Engine System Configuration

You can back up your Grid Engine system configuration files automatically. The automatic backup process uses a configuration file called backup_template.conf. The backup configuration file is located by default in $SGE_ROOT/util/install_modules/backup_template.conf.

The backup configuration file must define the following elements:

• The Grid Engine system root directory ($SGE_ROOT).
• The Grid Engine system cell directory ($SGE_CELL).
• The Grid Engine system backup directory.
• Type of backup. Your backup can be just the Grid Engine system configuration files, or the backup can be a compressed tar file that contains the configuration files.
• The file name of the backup file.

The backup template file looks like the following example:

##################################################
# Autobackup Configuration File Template
##################################################

# Please, enter your $SGE_ROOT here (mandatory)
$SGE_ROOT=""

# Please, enter your $SGE_CELL here (mandatory)
$SGE_CELL=""

# Please, enter your Backup Directory here
# After backup you will find your backup files here (mandatory)
# The autobackup will add a time /date combination to this dirname
# to prevent an overwriting!
BACKUP_DIR=""

# Please, enter true to get a tar/gz package
# and false to copy the files only (mandatory)
TAR="true"

# Please, enter the backup file name here. (mandatory)
BACKUP_FILE="backup.tar" 

To start the automatic backup process, type the following command on the sge_qmaster host:

inst_sge -bup -auto <backup-conf>

backup-conf is the full path to the backup configuration file.

Note You do not need to shut down any of the Grid Engine system daemons before you back up your configuration files.

Your backup is created in the directory specified by BACKUP_FILE. A backup log file called install.pid is also created in this directory. pid is the process ID number.

How to Perform a Manual Backup

1. Type the following command to start a manual backup:

   inst_sge -bup
   

   
   

2. Enter the $SGE_ROOT directory or use the default.

   SGE Configuration Backup
   ------------------------
   
   This feature does a backup of all configuration you made
   within your cluster.
   Please enter your $SGE_ROOT directory.
   Default: [/home/user/ts/u10]
   

   
   

3. Enter the $SGE_CELL name or use the default.

   Please enter your $SGE_CELL name. Default: [default]
   

   
   

4. Enter the backup destination directory or use the default.

   Where do you want to save the backup files?
   Default: [/home/user/ts/u10/backup]
   

   
   

5. Choose whether to create a compressed tar backup file.

   Caution If you create a compressed tar file, use the same tar binary to pack and unpack the files. Using different tar versions (gnu tar/ solaris tar) might result in corrupt tar packages.

   Shall the backup function create a compressed tar package with your files? (y/n) [y] >>
   

   
   

6. Enter the file name of the backup file or use the default.

   ... starting with backup
   
   Please enter a filename for your backupfile. Default: [backup.tar] >>
   

   Once the filename is specified, the backup process completes. Output similar to the following is displayed.

   2007-01-11_22_43_22.dump
   bootstrap
   qtask
   settings.sh
   act_qmaster
   sgemaster
   settings.csh
   sgeexecd
   jobseqnum
   
   ... backup completed
   All information is saved in
   [/home/user/ts/u10/backup/backup.tar.gz[Z]]
   

How to Restore from a Backup

Caution Shut down the qmaster daemon before you start the restore process. During the restore process, the spooling database is changed. If the qmaster and restore processes try to access the same data concurrently, data loss might result.

1. Type the following command to start the restore process:

   inst_sge -rst 
   

   
   

2. Read the messages on the screen and press Return.

   SGE Configuration Restore
   -------------------------
   
   This feature restores the configuration from a backup you made
   previously.
   
   Hit, <ENTER> to continue!
   

   
   

3. Enter the $SGE_ROOT directory or use the default.

   Please enter your $SGE_ROOT directory.
   Default: [/home/user/ts/u10]
   

   
   

4. Enter the $SGE_CELL name or use the default.

   Please enter your $SGE_CELL name. Default: [default]
   

   
   

5. Confirm the format of the backup file.
   The backup file can be in a format other than a compressed tar file.

   Is your backupfile in tar.gz[Z] format? (y/n) [y]
   

   
   

6. Enter the full path to the backup file.

   Please enter the full path and name of your backup file.
   Default: [/home/user/ts/u10/backup/backup.tar.gz]
   

   
   

7. Verify the information for the spooling database.
   The restore feature unpacks the backup file and reads system information. To prevent data loss, confirm that the correct spooling database is detected.

   Copying backupfile to /tmp/bup_tmp_22_51_40
   
   /home/user/ts/u10/backup/backup.tar.gz
   2007-01-11_22_43_22.dump
   bootstrap
   qtask
   settings.sh
   act_qmaster
   sgemaster
   settings.csh
   sgeexecd
   jobseqnum
   
   Spooling Method: berkeleydb detected!
   
   
   The path to your spooling db is [/tmp/dom/spooldb]
   If this is correct hit <ENTER> to continue, else enter the path. >>
   

   
   

8. Restart qmaster.