Friday, May 8, 2009

9 Configure Web Server

To install the PeopleSoft Pure Internet Architecture on WebSphere:

1. Go to <PS_HOME>\setup\PsMpPIAInstall.

2. Double-click on setup.<OS>.

The Welcome Screen appears.

3. Click Next in the Welcome screen, and choose the <PS_HOME> directory.

clip_image002

4. Choose IBM WebSphere Application Server and click Next.

clip_image004
choosing the IBM WebSphere Application Server

5. Specify the WebSphere 6.1 application server directory. Click Next.

clip_image006

Specifying the WebSphere application server directory

See Enterprise PeopleTools 8.49 PeopleBook: System and Server Administration.

6. Choose whether to create a new WebSphere application (domain) or to use an existing application, and specify the name of the application. Enter an application name for this web server (for example, PeopleSoft) and select the type of server you want to install

Note. The name you specify for each PeopleSoft Enterprise Application must be unique for each

WebSphere Node.

Note. You only see the option Existing WebSphere Application if there is already an application in <PS_HOME>.

If you select Create New WebSphere Application, the install automatically generates a valid application name in the application name field. If you attempt to enter an invalid application name, you'll be prompted to enter a new application name or choose an existing application.

If you select Existing WebSphere Application, you can choose from a drop-down list of existing

applications, and can select whether to install an additional PeopleSoft site, redeploy PeopleSoft Pure Internet Architecture, or deploy additional PeopleSoft application extensions.

Note. Make sure the server is up and running before installing an additional PeopleSoft site, redeploying the PeopleSoft Pure Internet Architecture, or deploying additional PeopleSoft application extensions.

Install additional PeopleSoft site: Select this option to install only the necessary files for defining an additional PeopleSoft site onto the existing WAS web server configuration.

Redeploy PeopleSoft Internet Architecture:This selection affects all of the PeopleSoft Pure Internet Architecture web applications installed to the local WebSphere Application Server profile. Select this option to redeploy PeopleSoft Enterprise Application that comprise web components of PeopleSoft Pure Internet Architecture.

Deploy additional PeopleSoft application extensions:This option is solely for use with PeopleSoft product applications. PeopleSoft application extensions are provided with certain PeopleSoft applications, and this option allows you to deploy those extensions. Consult the installation documentation for your PeopleSoft application to see whether this option is appropriate. PeopleTools does not use application extensions.

This also gives you an option of whether you want to install single-server or multi-server installaions.

Single-server installation:The Single Server Installation option creates one WebSphere Application Server

profile to hold all the PeopleSoft web applications. The installer uses the Application Name you enter for the new profile’s name.

Multi-server installation: The Multi Server Installation option splits the PeopleSoft web application into three WebSphere Application Server Profiles —PIA_<application_name>, PSOL_<application_name> (for the PeopleSoft Online Library) and PSEMHUB_<application_name> (for the PeopleSoft Environment

Management Framework). Each profile has its own JVM, so the multiserver option will be better suited for installations needing higher performance or reliability. If you are not sure which to pick, choose Single.

Note. You must select "Multi Server Installation" if you plan to host PeopleBooks on the web server on which you are installing the PeopleSoft Pure Internet Architecture.

clip_image008

Specifying a new WebSphere domain in a single server installation

7. . If there are application packages in the archives directory, you’ll be asked whether you want to deploy them. (If you’re using an existing domain, you’ll only be prompted if you selected Deploy additional PeopleSoft extensions.)

8. EEnter a PeopleSoft web site name; the default is ps.

Warning! The site name can include underscores ( _ ), but an underscore cannot be followed by a numeric character or the string “newwin” (for example, my_site_3 or my_newwin_site).

clip_image010

Entering the PeopleSoft web site name

9. Specify your application server name, its JSL (Jolt Station Listener) port number, its HTTP and HTTPS port numbers, the authentication token domain, and click Next.

Note. For the AppServer name setting, enter the name of your application server. For the JSL port

setting, enter the JSL port number you specified when setting up your application server. (The default value is 9000.)

See “Configuring the Application Server on Windows.”

Note. The HTTP/HTTPS port numbers are reset to those that you just specified when you restart your WebSphere server.

clip_image012


Note.
The value you enter for Authentication Token Domain must match the value you specify for the authentication domain when configuring your application server, as described earlier in this book. In addition, certain installation configurations require that you specify an authentication domain.

See Using Authentication Domains in the PeopleSoft Pure Internet Architecture Installation.

Note. If you enter a value for the Authentication Token Domain, the URL to invoke PeopleSoft

Pure Internet Architecture must include the network domain name in the URL. For example, if you do not enter an authentication domain, the URL to invoke PeopleSoft Pure Internet Architecture is http://MachineName:port/ps/signon.html. If you do enter a value for the authentication domain (for example, .myCompany.com), the URL to invoke PeopleSoft Pure Internet Architecture is http://MachineName.myCompany.com:port/ps/signon.html. The URL must also comply with the naming rules given earlier in this chapter.

See “Understanding the PeopleSoft Pure Internet Architecture.”

In the case of Multi Server Installation type, http port and https ports can not be consequent numbers.

The range for port number will be <Port#>-<Port#>+2 for all the three application server profiles that the install creates. For example, if you select HTTP Port as 5555 and HTTPS port as 5560 then the ports are assigned as given below.


ProfileName HTTP port Number HTTPS port Number

PIA_<application_name> 5555 5560

PSEMHUB_<application_name> 5556 5561

PSOL_<application_name> 5557 5562

10. Enter the name of the web profile name in the database that will be used to configure this PeopleSoft web site. This can be the name of either a pre delivered one shown on the page, or one you intend to create yourself using PeopleTools, Web Profile Configuration, after logging in. Each site is configured according to the profile you specify here when it is first accessed after the web server is booted. The user ID and password will be used by the PIA servlets themselves at runtime to log in to the application server to retrieve the profile. For applications on PeopleTools 8.44 and above, PeopleSoft predelivers the PTWEBSERVER user ID for the purpose of configuring PIA servlets at runtime and running the Performance Monitor Agents. You may have to unlock that user profile in certain application databases. If you have any problems logging in after starting the web server, refer to the application server domain logs.

See See Enterprise PeopleTools 8.49 PeopleBook: Internet Technology

clip_image014
Entering a web profile

If you are upgrading your application database to PeopleTools 8.47 or later, you will need to set up the PTWEBSERVER user ID by doing the following:

a. Go to PeopleTools->Security->User Profiles->User Profiles, click Add a New Value.

b. Enter PTWEBSERVER for User ID, and click Add.

c. Enter and confirm a password.

d. Enter a description, the role PeopleTools Web Server and then click Save.

11. Specify the root directory for the Report Repository (c:\psreports by default), and click Next. You can install to any location.

clip_image016

Specifying the report repository


Note.
For the Report Repository directory, specify the same directory that you specify as the Home Directory. Make sure that this directory is shared.

See Setting Up Process Scheduler on Windows Setting Up the Process Scheduler to Transfer Reports and Logs to Report Repository.

12. Verify all your selections. Click Back if you need to make any changes and click Next to begin the installation. An indicator shows the progress of your installation.

clip_image018

Verifying Installation options window

13. Click Finish to complete the installation. The default installation directory is <PS_HOME>\webserv\<profile-name>

1.1.1 Encrypting the Password (AIX Only)

If you installed either the WebLogic or WebSphere web server on an AIX operating system, you must encrypt the password manually.

1. Navigate to <PS_HOME>/webserv/<domain_name>, where the default value for <domain_name> is

peoplesoft.

2. Run the following commands, substituting your User ID and its password for <userid> and <password>:

PSCipher.sh <userid>

PSCipher.sh <password>

The commands return encrypted values. Save these values.

3. Navigate to <PS_HOME>/webserv/<domain_name>/applications/peoplesoft/PORTAL/WEB-INF

/psftdocs/<site_name>.

The default values for <domain_name> and <site_name>, respectively, are peoplesoft and ps. If you used

other values when setting up the PeopleSoft Pure Internet Architecture, use those values here.

4. Open the file configuration.properties in a text editor.

5. Replace the values of WebUserId and WebPassword in this file with the encrypted values for <userid> and <password>, respectively, from step 2.

1.1.2 Starting and Stopping WebSphere Application Servers

By default, all of the servers of WAS instance are stopped when you install PIA. You need to start the server in order to access the PeopleSoft Enterprise Application.

To start WebSphere Application Server:

1. Change directories to the folder in which WebSphere Application Server profile is installed, which is the bin directory under the WebSphere home directory <ps_home>\webserv\<profilename>\bin.

2. Enter the command

On Windows:

startServer.bat <server_name> -profileName <profilename>

where <profilename> indicates the application name that you have selected during the PIA install and <server_name> will be the server that gets created when the application server profile is created.

3. To stop the server, enter the command:

On Windows:

stopServer.bat <server_name> -profileName <profilename>

1.1.3 Accessing the PeopleSoft Signon

To access the PeopleSoft signon:

1. Open your web browser.

2. Enter the name of the site you want to access—for example (the default value for <site_name> is ps):

http://<machine_name>:<http_port>/<site_name>/signon.html

clip_image020

Sign in to the PeopleSoft system by entering a valid user ID and password.

Different applications use different default user IDs and passwords. For instance, for HRMS applications you enter PS for the user ID and the password. For Financials applications, you enter VP1 for the user ID and the password. Your application-specific install instructions contain any custom/delivered user IDs that you should use for the demonstration environment.

No comments: