Using the Miscellaneous Commands

Following are the available miscellaneous PSADMIN commands:

Command Description 
psadmin -h

Displays command help and syntax.

 
psadmin -v

Displays the PSADMIN version number, as in Version 8.59.

 
psadmin -env

Displays your current environment variables.

 
psadmin -defaultPS_CFG_HOME

Displays the current PS_CFG_HOME environment variable.

 
psadmin -envsummary

Displays a summary of PS_HOMEs and domains.

 
psadmin -replicate -ch <source PS_CFG_HOME>
psadmin -replicate -ch <source PS_CFG_HOME> -r

Replicates a PS_CFG_HOME and its configured domains, including a PIA domain, to a new location, where they can be started without manual reconfiguration.

The replicate originates from the source PS_CFG_HOME in the command line parameter and copies to the current PS_CFG_HOME that the user is working with as defined either by the value of the PS_CFG_HOME environment variable or the default location PSADMIN is using for the operating system. That is, you copy an existing PS_CFG_HOME into the current PS_CFG_HOME used by PSADMIN.

If the current PS_CFG_HOME contains any existing domains, the replication process will abort and will display a message. You can overwrite the existing domains in the current PS_CFG_HOME using the –r option.

Note: If the current PS_CFG_HOME contains any existing domains, ensure that the domains are shut down before you execute the replicate command. If the domains are not shut down, an error is displayed. 

psadmin -refresh
psadmin -refresh -keepbackup

Refreshes the domains in PS_CFG_HOME and applies the latest configuration settings to the domains.

If any of the domains is started, the refresh process will first shut down the domain, refresh it, and then start the domain. A stopped domain will just be refreshed.

Use the –keepbackup option to keep a back-up copy of a domain. The back-up copies of a domain are stored in PS_CFG_HOME with the following naming convention: <domain>_<date>_<time>.bak.

For example, peoplesoft_081315_2158.bak.

Note: Using this command does not update the integrationGateway.properties file on the web server. Save the integrationGateway.properties file so that you can replace it after using this command. See Integration Broker Administration: Backing Up the Integration Gateway Properties File.