Restoring a profile on i5/OS

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

Restoring a profile on i5/OS

Follow the instructions in this topic to restore a profile on IBM^® i5/OS.
In order to perform this task, you will need to sign on with an i5/OS user profile with the following authorities:

*ALLOBJ
*SAVSYS
*IOSYSCFG

To access a profile after it has been restored, you will need to know the WebSphere Portal Express password that was valid for that profile at the time it was saved. Do not revert to a saved profile unless you know the correct WebSphere Portal Express password to use.
Before restoring the saved version of the profile, this script renames Integrated File System (IFS) data associated with the existing profile, and duplicates the schema data. This protects against the case where the user specifies the wrong profile name and the wrong profile is restored. To avoid unnecessarily using up storage on your system, delete the renamed and duplicated data after you have verified that the restore occurred successfully (check the log file for details on the renamed profile data). In addition, you can specify the -x parameter to prevent the schema data for the profile from being duplicated.
This script does not restore any remote database schemas associated with the profile. To restore remote database schemas, run therstWpRmtDb.sh script in addition to rstWpProfile.sh or rstNdProfile.sh. For more information, see Restoring remote database schemas on i5/OS. Follow these steps to restore an profile on i5/OS:
Start the QShell Interpreter by entering the following on an i5/OS command line:
STRQSH
Change to the 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):
rstWpProfile.sh parameters
Network Deployment profile:
rstNdProfile.sh parameters
The command takes the following parameters as listed in the table, with these being required:

profile (-p)
either a media device (-m) and a save date (-d) or 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 restored

-date (-d) The date of the profile data to restore. Do not use this parameter unless you are restoring from a media device. This value should be in the format used by the system for date/time values (for example, 060105 for June 1st 2005, if MDY format being used on the system). Check the QDATFMT system value to determine which format to use.
-mediaDevice (-m)
Specifies a media device to restore from

-saveFileLib (-s)
Specifies a library to restore from. 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 /QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/profile/PortalExpress/log, where profile is the name of the profile being restored.

If you specify a path using this parameter, the command will create only the last directory in the path. The other directories in the path must already exist. For example, if you specify -l /wcs01/logs, the /wcs01 directory must already exist.
-noHttp (-n)
Do not restore external HTTP data

-noSaftyNet (-x)
Do not duplicate existing schema data.

By default, the command duplicates existing schema data before deleting it. This protects against the case where the user enters the wrong profile name and the wrong profile is restored. Only use this parameter if you wish to prevent this duplication from happening.

-forceDown (-f)
Force the Workplace servers associated with the existing profile to stop. If you do not use this parameter, stop all Workplace servers associated with the existing profile manually before running the command. If any servers are running, the command will fail.

-propFilePath (-r)
Specifies a path to the savRstWp.properties file to use 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 restoring the profile, and then edit it to include the parameters you wish to use. Note that save the file with the name savRstWp.properties.

-seqNum (-q)
The starting sequence number of the file set you want to restore. Normally you will not need this parameter, but if you saved multiple copies of the same instance on the same day on the same tape, you may need to distinguish which save set you want. This parameter is only valid with -m option and the media device must be a tape drive.

-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 restore.
Check the log file to verify that the script completed successfully. Once you have verified that the restore completed as expected, you can also delete any renamed profile data.
Examples:
The following command restores profile wcs01 from media device tap01. Log files are saved to directory /mylog. The date of the backup being restored is June 1, 2005. Because the -f parameter is specified, all servers associated with the existing profile (which will be deleted as part of this process) are stopped.
rstWpProfile.sh -profileName wcs01 -mediaDevice tap01 -logDir /mylog -d 060105 -forceDown
The following command is the same as the previous example, except parameter short names are used and the -v parameter is specified to verify what the command will do before running it.
rstWpProfile.sh -v -p wcs01 -m tap01 -d 060105 -f
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.
rstWpProfile.sh -r /myprops
If the profile being restored uses remote database schemas, use a separate script to restore them. Proceed to the topic Restoring 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 restored
-date (-d)	The date of the profile data to restore. Do not use this parameter unless you are restoring from a media device. This value should be in the format used by the system for date/time values (for example, 060105 for June 1st 2005, if MDY format being used on the system). Check the QDATFMT system value to determine which format to use.
-mediaDevice (-m)	Specifies a media device to restore from
-saveFileLib (-s)	Specifies a library to restore from. 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 /QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/profile/PortalExpress/log, where profile is the name of the profile being restored. If you specify a path using this parameter, the command will create only the last directory in the path. The other directories in the path must already exist. For example, if you specify -l /wcs01/logs, the /wcs01 directory must already exist.
-noHttp (-n)	Do not restore external HTTP data
-noSaftyNet (-x)	Do not duplicate existing schema data. By default, the command duplicates existing schema data before deleting it. This protects against the case where the user enters the wrong profile name and the wrong profile is restored. Only use this parameter if you wish to prevent this duplication from happening.
-forceDown (-f)	Force the Workplace servers associated with the existing profile to stop. If you do not use this parameter, stop all Workplace servers associated with the existing profile manually before running the command. If any servers are running, the command will fail.
-propFilePath (-r)	Specifies a path to the savRstWp.properties file to use 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 restoring the profile, and then edit it to include the parameters you wish to use. Note that save the file with the name savRstWp.properties.
-seqNum (-q)	The starting sequence number of the file set you want to restore. Normally you will not need this parameter, but if you saved multiple copies of the same instance on the same day on the same tape, you may need to distinguish which save set you want. This parameter is only valid with -m option and the media device must be a tape drive.
-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 restore.