Backing Up and Restoring Prime Performance Manager
The following topics tell you how to back up and restore Prime Performance Manager:
Prime Performance Manager Back Up and Restore Process
The Prime Performance Manager backup and restore function allows you to retrieve user accounts, logs, reports, and security-related parts of Prime Performance Manager data files from the previous night’s backup. You should perform backup and restore in sets at the same clock time. Sets consists of a gateway and its units.
Note If backups are not performed in sets, data might become unsynchronized between the gateway and its units.
The backup and restore steps on a gateway and collocated unit include:
1. Backup is normally performed on the unit at 2:30 AM and gateway at 3:30 AM. This spreads the load so they are both not backing up at exactly the same time.
2. Restore the gateway first. Backup is restored to the gateway.
3. Restore the unit. Backup is restored to the unit.
4. Start the gateway.
5. Start the unit.
The backup and restore steps on a gateway and multiple units include:
1. Backup is normally performed on the gateway at 2:30 AM and all units at 3:30 AM.
2. Restore the gateway first. Backup is restored to the gateway.
3. Restore each unit. These can be done in parallel.
4. Start the gateway.
5. Start each unit, either serially or in parallel.
Prime Performance Manager supports backup and restore on the same machine. Prime Performance Manager does not support:
- Taking a backup on one unit and restoring to another unit.
- Taking a backup on a gateway with one IP address and restoring to a gateway with a different IP address.
Note For very large networks, system responsiveness may temporarily degrade during backups.
Prime Performance Manager automatically backs up all Prime Performance Manager data files to Prime Performance Manager installation directory daily at same clock time.
To change the time at which Prime Performance Manager automatically backs up files, Log in as the root user or user enabled with ppm superuser and change the root crontab file:
- crontab -l lists cron jobs.
- crontab -e opens up an editor so you can make changes and save them.
Backing Up Prime Performance Manager Data Files
To manually back up Prime Performance Manager data files at any time on a Solaris or Linux server:
Step 1 Log in as the root user or user enabled with ppm superuser.
Step 2 Change to the bin directory:
Step 3 Back up Prime Performance Manager files:
Prime Performance Manager backs up the data files in the installation directory.
If you installed Prime Performance Manager in the default directory, /opt, then the default backup directory is also /opt. If you installed Prime Performance Manager in a different directory, then the default backup directory is that directory.
Changing the Backup Directory
To change the directory in which Prime Performance Manager stores its nightly backup files:
Step 1 Log in as the root user or user enabled with ppm superuser.
Step 2 Change to the bin directory:
Step 3 Change the backup directory location:
./ppm backupdir directory
where directory is the new backup directory.
If the new directory does not exist, Prime Performance Manager does not change the directory, but issues an appropriate warning message.
Setting the Number of Backup Days
To set the number of days that Prime Performance Manager saves backup files:
Step 1 Log in as the root user or user enabled with ppm superuser.
Step 2 Change to the bin directory:
Step 3 Change the number of backup days (default is 1):
Step 4 Enter a value for the number of days from 1 to 30.
Prime Performance Manager will save backup files for the number of days that you entered. In this example, Prime Performance Manager saves backup files for the last five days, and deletes backup files that are older than five days.
Note Backups can take large amounts of data storage, so plan accordingly.
Restoring Prime Performance Manager Data Files
Prime Performance Manager supports backup and restore on the same machine. Prime Performance Manager does not support taking a backup on one unit and restoring to another, nor can you take a backup on a gateway with one IP address and restore it to a gateway with a different IP address.
To restore Prime Performance Manager, you can choose to restore all files, or only log files, reports, or security files.
To restore Prime Performance Manager from a previous backup:
Step 1 Log in as the root user or user enabled with ppm superuser.
Step 2 Change to the bin directory:
Step 3 Restore Prime Performance Manager data files:
To restore only parts of Prime Performance Manager, use the following keywords:
- logs —Restores only Prime Performance Manager log files.
- reports —Restores only Prime Performance Manager report files.
- security —Restores only the security-related parts of Prime Performance Manager data files. This option is useful if you inadvertently delete your user accounts or make other unwanted changes to your Prime Performance Manager security information.
- data —Restores only the database.
- etc —Restores only the configuration files and report definitions. This is useful if you removed or accidentally edited the report definition files.
Step 4 To view statistics on the backup process, enter:
Note If the number of backup days has been set to more than one day (see Setting the Number of Backup Days), Prime Performance Manager will prompt you for a server backup file restore from as there is no client backups.
Warning Do not interrupt this command. Doing so can corrupt your Prime Performance Manager data files.
Additional Backup Commands
Additional backup commands include:
- ppm backupstats—Displays backup process statistics. For information, see ppm backupstats.
- ppm backupdata {enable|disable|status} [gw|unit|both]—Specifies whether the database is included in backups. For information, see ppm backupdata.
- ppm backuprep {enable|disable|status]—Specifles whether to Include CSV reports in backups. For information, see ppm backuprep.