Using the Pure Internet Architecture Commands

The PeopleSoft Pure Internet Architecture (PIA) commands follow this basic syntax:

psadmin —w command —d PIA_domain

For example:

psadmin —w start —d peoplesoft

Note:

The examples in this table include line feeds for readability.

Command	Example	Result of the Example
start	psadmin -w start -d peoplesoft	Starts the peoplesoft domain.
shutdown	psadmin -w shutdown -d peoplesoft	Stops the peoplesoft domain.
shutdown!	psadmin -w shutdown! -d peoplesoft	Performs a forced shutdown of the peoplesoft domain.
status	psadmin -w status -d peoplesoft	Displays the status of the domain (started, stopped, and so on).
remove	psadmin -w remove -d peoplesoft	Deletes the domain.
import	psadmin -w import <source PS_CFG_HOME> psadmin -w import <source PS_CFG_HOME> -d peoplesoft psadmin -w import <source PS_CFG_HOME> -d peoplesoft -n peoplesoft1	Imports the peoplesoft domain from a specified PS_CFG_HOME location, <source PS_CFG_HOME>. You may use the following options as required: Use the –d option to import a specific domain if multiple domains exist in a source PS_CFG_HOME. Use the –n option if you want to specify a name for the imported domain. If the –n option is not used, the database name is used as the default name for the imported domain. Use the –r option to replace an existing domain folder in the current PS_CFG_HOME. If a domain folder exists and the –r option is not used, an error message is displayed. Use this option with all of the –import options.

Using the PeopleSoft Pure Internet Architecture Create Command

Use the following syntax to create a new PIA domain:

psadmin -w create -d PIA_domain -c c_set

The create command creates a PIA domain, using the specified configuration settings.

• PIA_domain — Enter the name of a PIA domain that you want to create, for example, peoplesoft.

• c_set (configuration settings) — Use the following order and format:

  In Microsoft Windows, the values must be separated by slashes:

  WebServer/WebServerRootDir/WebServerLoginId/WebServerLoginPwd/WebsiteName/AppserverHost/JSL Port/HTTP Port/HTTPS Port/AuthenticationTokenDomain/Web profile/WebProfUserId/WebProfUserPwd/IntegrGatewayId/IntegrGatewayPwd/AppsrvDomConnPwd/SSLKeystorePwd/RepDir

  In UNIX, the values must be separated by percent signs:

  WebServer%WebServerRootDir%WebServerLoginId%WebServerLoginPwd%WebsiteName%AppserverHost%JSL Port%HTTP Port%HTTPS Port%AuthenticationTokenDomain%Web profile%WebProfUserId%WebProfUserPwd%IntegrGatewayId%IntegrGatewayPwd%AppsrvDomConnPwd%SSLKeystorePwd%RepDir

  Note:

  To indicate an empty parameter, enter five underscore characters ( _____ ).

See Creating a PIA Domain for descriptions of the configuration settings.

Specifying PIA Domain Configuration Settings

You can use the command line to set selected domain settings using the following syntax:

psadmin —w configure —d PIA_domain —c c_set —p p_set

For example:

psadmin —w configure —d peoplesoft —c 512/512/50/example.com —p 80/443

• PIA_domain — Enter the name of a PIA domain that you want to create, for example, peoplesoft.

• c_set (configuration settings) — Use the following order and format:

  minHeapSize/maxHeapSize/maxThreads/authTokenDomain

• p_set (port settings) — Use the following order and format:

  httpPort/httpsPort

See Configuring a PIA Domain for descriptions of the configuration settings.

Specifying PIA Site Configuration Settings

You can use the command line to set selected site settings using the following syntax:

psadmin —w configure —d PIA_domain —s site —c c_set

For example:

psadmin —w configure —d peoplesoft —s ps —c SERVER01:9000/PROD/Enabled/D:\psreports/PS/password/password

• PIA_domain — Enter the name of a PIA domain that you want to create, for example, peoplesoft.

• site — Enter the web site name; for example, ps.

• c_set (configuration settings) — Use the following order and format:

  appSrvConnString/webProfile/pooling/reportPath/webProfUser/webProfPword/appSrvConnPword

The following table describes the configuration settings:

PIA configuration (c_set) settings	Description
appSrvConnString	Application server connect string, such as host:jolt port.
webProfile	The web profile the site will use (PROD, DEV, and so on).
pooling	Indicate whether Jolt pooling should be enabled. (Enabled/Disabled)
reportPath	The reports path, such as D:\psreports.
webProfUser	The user required for accessing the web profile.
webProfPword	The password for the web profile user.
appSrvConnPword	If using a domain connection password, enter that value.