Backing up a profile on i5/OS

Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

Backing up a profile on i5/OS

This topic provides instructions on backing up a IBM^® WebSphere^® Portal Express profile on IBM i5/OS using the savWpProfile.sh (Base profile) or savNdProfile.sh (Network Deployment profile) script. The instructions describe running the script manually from a QShell session. You can also schedule the script to run periodically as part of a comprehensive backup and recovery strategy. This topic includes examples of running the script from a QShell session, as well as scheduling a backup using the Add Job Schedule Entry (ADDJOBSCDE) command.

To back up a WebSphere Portal Express profile, you will need an i5/OS user profile with the following authorities:

*ALLOBJ
*SAVSYS
*IOSYSCFG

Before saving a profile, make a note of the current WebSphere Portal Express administrator password. If the profile is later restored, you will need to supply the WebSphere Portal Express administrator password that was valid for the profile at the time it was saved.
This script does not save any remote database schemas associated with the profile. To save remote database schemas, run the savWpRmtDb.sh script in addition to savWpProfile.sh or savNdProfile.sh. For more information, see Backing up remote database schemas on i5/OS. To back up a profile on i5/OS, follow these steps:
Start the QShell Interpreter by entering the following on an i5/OS command line:
STRQSH
Change to the Workplace tools directory by entering the following:
cd /QIBM/ProdData/PortalExpress/V6/Tools
Enter the following command to back up your profile: Base profile (includes Base profiles federated into a cluster):
savWpProfile.sh parameters
Network Deployment profile:
savNdProfile.sh parameters
The command takes the following parameters as listed in the table, with these being required:

profile (-p)
either a media device or a save file library (-s)

Additionally, specify the -f parameter to force all servers to stop if you have not already stopped them manually.
Parameter names are case-sensitive.
Parameter Description
-help (-h)
Displays help for the command

-profileName (-p)
The name of the profile being saved

-mediaDevice (-m)
Specifies a media device to save to

-saveFileLib (-s)
Specifies a library where save files are created to save the data. The library name must be 10 characters or less.

-logDir (-l)
Where to save log files for this command. If a log directory is not specified using this parameter, logs are created by default in /savRstWp60.

-schemaList (-t)
Specifies a list of schemas to save with the profile. By default, the command saves all Workplace schemas associated with the profile. If this parameter is used, the script will ONLY save the schemas listed.

Schemas listed must be separated by commas, with no spaces in between.

This script does not save any remote database schemas associated with the profile. To save remote database schemas, run the savRmtDb.sh script in addition to savWpProfile.sh. For more information, see Backing up remote database schemas on i5/OS.
-noHttp (-n)
Do not save external HTTP data

-cancelRestart (-c)
Cancel restart of Workplace servers. By default, all Workplace servers are restarted after the command is run.

-forceDown (-f)
Force the servers associated with the profile to stop. If you specify this parameter, the command will automatically stop WebSphere_Portal and the HTTP server for the profile.

If you do not use this parameter, stop all servers associated with the profile manually before running the command. If any servers are running, the command will fail.

-propFilePath (-r)
The path to the savRstWp.properties file to be used for parameter input to this command. To use this parameter, first copy the file /QIBM/ProdData/PortalExpress/V6/Tools/savRstWp.properties to a new location in the Integrated File System (IFS) of the system on which you are backing up the profile, and then edit it to include the parameters you wish to use. Note that save the file with the name savRstWp.properties.

-verify (-v)
Verifies the command. If this parameter is used, the command outputs what would be done according to the parameters being used, without actually performing the backup.
When the command is run, a message is displayed indicating the backup operations being performed. If you are using a remote database, this message includes information on the remote system and the remote database schemas being used. Note that the savWpProfile.sh script does NOT back up remote database schemas. You must run an additional script to back them up. Look for a message similar to the following to determine which remote system and remote database schemas are being used:
Remote iSeries database server is being used.  List of libraries (schemas)             
to save on myserver.myco.com:                                                 
                                                                                       
WCS34JHB WCS34JHB1 WCS34JHB2 WCS34JHB3 WCS34JHB4 WCS34JHB5   
For information on backing up remote database schemas, see the topic Backing up remote database schemas on i5/OS.
Examples:
In the following example, profile wcs01 is backed up to media device tap01. Log files are saved to the /mylog directory. Because the -f parameter is specified, all servers associated with the profile are stopped.
savWpProfile.sh -profileName wcs01 -mediaDevice tap01 -logDir /mylog -forceDown
This is the same command as the previous example, except that short parameter names are used and the -v parameter is specified to verify what the command will do before running it:
savWpProfile.sh -v -p wcs01 -m tap01 -l /mylog -f
In this example, the -t parameter is used to back up the profile with a list of schemas specified by the user. Note that in this case, the command does not save any schemas other than those listed.
savWpProfile.sh -p wcs01 -s mysavlib -t wcs01,wcs01lms, wcs01lds,wcs01msg,wcs01com,wcs01wps,mylib01
The following command pulls parameter information from the savRstWp.properties file, which the user has previously saved in the /myprops directory. Note that the path does NOT include the file name. You may override parameters in the savRstWp.properties file by specifying them on the command line.
savWpProfile.sh -r /myprops -l /mylog
The following is an example of using the i5/OS command Add Job Schedule Entry (ADDJOBSCDE) to make the savWpProfile.sh script run on a regular schedule. The ADDJOBSCDE command must be run from an i5/OS command line. In this example, the script is run with a job name (JOB) of WPSBACKUP on a frequency (FRQ) of once per week with a schedule day (SCDDAY) of Sunday and a schedule time (SCDTIME) of 11:30 p.m:
ADDJOBSCDE JOB(WPSBACKUP) CMD(QSH CMD('/qibm/proddata/portalexpress/v6/tools/
savWpProfile.sh -p wcs01 -s mysavlib')) 
FRQ(*WEEKLY) SCDDATE(*NONE) SCDDAY(*SUN) SCDTIME('23:30:00')
For detailed information on the ADDJOBSCDE command and its parameters, see the IBM eServer™ i5 Information Center at http://publib.boulder.ibm.com/iseries/.
If you are using remote database schemas with your Workplace profile, run an additional script to back them up. Proceed to the topic Backing up remote database schemas on i5/OS.

Parent topic:
Backup and restore on i5/OS

Parameter	Description
-help (-h)	Displays help for the command
-profileName (-p)	The name of the profile being saved
-mediaDevice (-m)	Specifies a media device to save to
-saveFileLib (-s)	Specifies a library where save files are created to save the data. The library name must be 10 characters or less.
-logDir (-l)	Where to save log files for this command. If a log directory is not specified using this parameter, logs are created by default in /savRstWp60.
-schemaList (-t)	Specifies a list of schemas to save with the profile. By default, the command saves all Workplace schemas associated with the profile. If this parameter is used, the script will ONLY save the schemas listed. Schemas listed must be separated by commas, with no spaces in between. This script does not save any remote database schemas associated with the profile. To save remote database schemas, run the savRmtDb.sh script in addition to savWpProfile.sh. For more information, see Backing up remote database schemas on i5/OS.
-noHttp (-n)	Do not save external HTTP data
-cancelRestart (-c)	Cancel restart of Workplace servers. By default, all Workplace servers are restarted after the command is run.
-forceDown (-f)	Force the servers associated with the profile to stop. If you specify this parameter, the command will automatically stop WebSphere_Portal and the HTTP server for the profile. If you do not use this parameter, stop all servers associated with the profile manually before running the command. If any servers are running, the command will fail.
-propFilePath (-r)	The path to the savRstWp.properties file to be used for parameter input to this command. To use this parameter, first copy the file /QIBM/ProdData/PortalExpress/V6/Tools/savRstWp.properties to a new location in the Integrated File System (IFS) of the system on which you are backing up the profile, and then edit it to include the parameters you wish to use. Note that save the file with the name savRstWp.properties.
-verify (-v)	Verifies the command. If this parameter is used, the command outputs what would be done according to the parameters being used, without actually performing the backup.