7/22/2019 pt851tsvt-b0810

1/421

PeopleTools 8.51 PeopleBook:

System and Server Administration

August 2010

7/22/2019 pt851tsvt-b0810

2/421

PeopleTools 8.51 PeopleBook: System and Server AdministrationSKU pt8.51tsvt-b0810

Copyright 1988, 2010, Oracle and/or its affiliates. All rights reserved.

Trademark Notice

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their

respective owners.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use anddisclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement orallowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit,perform, publish or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilationof this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you findany errors, please report them to us in writing.

Restricted Rights Notice

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S.Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS

Programs, software, databases, and related documentation and technical data delivered to U.S. Governmentcustomers are "commercial computer software" or "commercial technical data" pursuant to the applicableFederal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication,

disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in theapplicable Government contract, and, to the extent applicable by the terms of the Government contract, theadditional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

Hazardous Applications Notice

This software is developed for general use in a variety of information management applications. It is not developed orintended for use in any inherently dangerous applications, including applications which may create a risk of personalinjury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe,backup, redundancy and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates

disclaim any liability for any damages caused by use of this software in dangerous applications.

Third Party Content, Products, and Services Disclaimer

This software and documentation may provide access to or information on content, products and services from thirdparties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kindwith respect to third party content, products and services. Oracle Corporation and its affiliates will not be responsible forany loss, costs, or damages incurred due to your access to or use of third party content, products or services.

7/22/2019 pt851tsvt-b0810

3/421Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved. iii

Contents

Preface

System and Server Administration Preface ............................................................................................. xix

System and Server Administration ............................................................................................................... xix

PeopleBooks and the PeopleSoft Online Library ......................................................................................... xix

Chapter 1

Getting Started with System and Server Administration .......................................................................... 1

System and Server Administration Overview .................................................................................................. 1

PSADMIN ................................................................................................................................................ 1

Analytic Servers ....................................................................................................................................... 2

Web Servers ............................................................................................................................................. 3

Search Indexes .......................................................................................................................................... 3

PeopleSoft Configuration Manager ........................................................................................................... 4

PeopleTools Utilities ................................................................................................................................. 5

Tracing and Debugging ............................................................................................................................. 5

Jolt Configuration Options ........................................................................................................................ 6

Timeout Settings ....................................................................................................................................... 6

System and Server Administration Implementation ........................................................................................ 6

Chapter 2

Understanding PeopleSoft Internet Architecture ....................................................................................... 9

PeopleSoft Architecture Fundamentals ............................................................................................................ 9

Database Server .............................................................................................................................................. 10

Application Servers ........................................................................................................................................ 11

Application Servers ................................................................................................................................. 11

Oracle Tuxedo and Oracle Jolt ................................................................................................................ 11

Domains .................................................................................................................................................. 12

PeopleSoft Server Processes ................................................................................................................... 12

Services ................................................................................................................................................... 14

Listeners, Handlers, and Queues ............................................................................................................. 14

PeopleSoft Process Scheduler Server ............................................................................................................ 17

Web Server ..................................................................................................................................................... 18

Web server software ................................................................................................................................ 18

7/22/2019 pt851tsvt-b0810

4/421

Contents

iv Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved.

PeopleSoft Servlets ................................................................................................................................. 19

Oracle Jolt .............................................................................................................................................. 20

Web Browser ........................................................................................................................................... 21

Server Configuration Options ........................................................................................................................ 21

Logically Separate Server Configuration ................................................................................................ 21

Physically Separate Server Configuration ............................................................................................... 23

Implementation Options ................................................................................................................................. 24

Chapter 3

Working with Server Domain Configurations .......................................................................................... 27

Understanding PS_HOME and PS_CFG_HOME ......................................................................................... 27

Implementing Flexible Server Installations ............................................................................................ 28

Applying Security Restrictions ............................................................................................................... 29

Working with the Default PS_CFG_HOME ................................................................................................. 29

Locating the Default PS_CFG_HOME ................................................................................................... 29Using PSADMIN with the Default PS_CFG_HOME ............................................................................ 30

Working with Alternate PS_CFG_HOME Locations .................................................................................... 31

Specifying Alternate PS_CFG_HOME Locations .................................................................................. 31

Using the %V Meta Variable .................................................................................................................. 31

Configuring Domains in Alternate Locations of PS_CFG_HOME ........................................................ 32

Managing Domains ........................................................................................................................................ 33

Chapter 4

Using the PSADMIN Utility ....................................................................................................................... 35

Understanding PSADMIN ............................................................................................................................. 35

Starting PSADMIN ....................................................................................................................................... 36

Using PSADMIN .......................................................................................................................................... 37

Using Configuration Templates .................................................................................................................... 37

Using the Quick-Configure Menu ................................................................................................................. 38

Using the PSADMIN Command-Line Interface ........................................................................................... 39

Understanding the PSADMIN Command-Line Interface ...................................................................... 39

Using the Miscellaneous Commands ...................................................................................................... 40

Using the Application Server Commands .............................................................................................. 40

Using the Process Scheduler Commands ................................................................................................ 45

Using the Search Server Commands ....................................................................................................... 49

Using PSADMIN Executables and Configuration Files ............................................................................... 50

Understanding PSADMIN Executables and Configuration Files ........................................................... 51

Configuring a Domain ............................................................................................................................ 52

Loading a Configuration ........................................................................................................................ 53

Archiving Application Server Configuration Files ................................................................................ 53

7/22/2019 pt851tsvt-b0810

5/421

Contents

Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved. v

Booting a Domain .................................................................................................................................. 53

Stopping a Domain ................................................................................................................................. 53

Monitoring a Domain ............................................................................................................................. 54

Configuring the Application Server to Handle Cache Files and Replay Files .............................................. 54

Chapter 5

Using PSADMIN Menus ............................................................................................................................. 57

Using the Application Server Administration Menu .................................................................................... 57

Accessing the Application Server Options ............................................................................................. 58

Administering a Domain ........................................................................................................................ 58

Importing Domain Configurations .......................................................................................................... 59

Booting a Domain .................................................................................................................................. 60

Shutting Down a Domain ....................................................................................................................... 60

Checking the Domain Status .................................................................................................................. 61

Purging the Domain Cache .................................................................................................................... 62Configuring a Domain ............................................................................................................................ 64

Editing Configuration and Log Files ...................................................................................................... 65

Creating a Domain ................................................................................................................................. 66

Deleting a Domain ................................................................................................................................. 66

Configuring an Application Server Domain to Preload Cache .............................................................. 67

Cleaning Domain IPC Resources ........................................................................................................... 69

Using the Process Scheduler Menu ............................................................................................................... 70

Using the Search Server Menu ....................................................................................................................... 71

Setting Up the PeopleSoft Windows Service ................................................................................................ 71

Understanding Microsoft Windows Services .......................................................................................... 71Configuring the PeopleSoft Service ....................................................................................................... 72

Testing the Service ................................................................................................................................. 73

Editing the Service Configuration File ................................................................................................... 74

Chapter 6

Setting Application Server Domain Parameters ...................................................................................... 75

Startup Options ............................................................................................................................................. 76

DBName ................................................................................................................................................. 76

DBType .................................................................................................................................................. 76

UserID .................................................................................................................................................... 76

UserPswd ................................................................................................................................................ 77

Connect ID ............................................................................................................................................. 77

Connect Password .................................................................................................................................. 77

ServerName ............................................................................................................................................ 77

StandbyDBName ..................................................................................................................................... 78

7/22/2019 pt851tsvt-b0810

6/421

Contents

vi Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved.

StandbyDBType ...................................................................................................................................... 78

StandbyUserId ......................................................................................................................................... 78

StandbyUserPswd .................................................................................................................................... 78

Database Options .......................................................................................................................................... 78

SybasePacketSize ................................................................................................................................... 78

UseLocalOracleDB ................................................................................................................................ 78

EnableDBMonitoring ............................................................................................................................. 79PSDB Maximum Cursors ........................................................................................................................ 79

Security Options ............................................................................................................................................ 80

Validate Signon With Database ............................................................................................................. 80

DomainConnectionPwd .......................................................................................................................... 80

Workstation Listener Options ....................................................................................................................... 81

Address ................................................................................................................................................... 81

Port ......................................................................................................................................................... 81

Encryption .............................................................................................................................................. 81

Min Handlers .......................................................................................................................................... 82

Max Handlers ......................................................................................................................................... 82Max Clients per Handler ........................................................................................................................ 82

Client Cleanup Timeout ......................................................................................................................... 82

Init Timeout ............................................................................................................................................ 82

Tuxedo Compression .............................................................................................................................. 82

Jolt Listener Options ..................................................................................................................................... 83

Address ................................................................................................................................................... 83

Port ......................................................................................................................................................... 83

Encryption .............................................................................................................................................. 83

Min Handlers .......................................................................................................................................... 83

Max Handlers ......................................................................................................................................... 83Max Clients per Handler ........................................................................................................................ 84

Client Cleanup Timeout ......................................................................................................................... 84

Init Timeout ............................................................................................................................................ 84

Client Connection Mode ........................................................................................................................ 84

Jolt Compression Threshold ................................................................................................................... 84

Additional Prompt .................................................................................................................................. 85

Jolt Relay Adapter Options ........................................................................................................................... 85

Listener Address ..................................................................................................................................... 85

Listener Port ........................................................................................................................................... 85

Domain Settings ............................................................................................................................................ 86Domain ID .............................................................................................................................................. 86

Add to PATH ......................................................................................................................................... 86

Spawn Threshold .................................................................................................................................... 86

Log Directory .......................................................................................................................................... 87

Restartable .............................................................................................................................................. 87

Allow Dynamic Changes ....................................................................................................................... 87

LogFence ................................................................................................................................................ 88

AppLogFence ......................................................................................................................................... 88

7/22/2019 pt851tsvt-b0810

7/421

Contents

Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved. vii

Trace-Log File Character Set ................................................................................................................. 89

PeopleCode Debugger Options ..................................................................................................................... 89

Trace Options ................................................................................................................................................ 89

TraceSQL ............................................................................................................................................... 89

TraceSQLMask ...................................................................................................................................... 90

TracePC .................................................................................................................................................. 90

TracePCMask ......................................................................................................................................... 90TracePPR and TracePPRMask ............................................................................................................... 90

TracePIA and TracePIAMask ................................................................................................................ 92

TraceAE ................................................................................................................................................. 92

TraceAnalytic and Trace AnalyticMask ................................................................................................. 92

TracePPM ............................................................................................................................................... 92

DumpMemoryImageAtCrash ................................................................................................................. 92

DumpManagerObjectsAtCrash .............................................................................................................. 92

Log Error Report, Mail Error Report ..................................................................................................... 93

Write Crash Dump to Separate File ....................................................................................................... 93

Cache Settings ............................................................................................................................................... 93EnableServerCaching ............................................................................................................................. 93

CacheBaseDir ......................................................................................................................................... 94

ServerCacheMode .................................................................................................................................. 94

MaxCacheMemory ................................................................................................................................. 95

EnableDBCache ...................................................................................................................................... 95

PreLoadCache and PreLoadMemoryCache ........................................................................................... 95

Remote Call Options ..................................................................................................................................... 96

RCCBL Redirect ..................................................................................................................................... 96

RCCBL PRDBIN .................................................................................................................................... 96

PSAPPSRV Options ..................................................................................................................................... 97Min Instances ......................................................................................................................................... 97

Max Instances ......................................................................................................................................... 97

Service Timeout ..................................................................................................................................... 97

Recycle Count ........................................................................................................................................ 97

Percentage of Memory Growth .............................................................................................................. 98

Allowed Consec Service Failures .......................................................................................................... 99

Max Fetch Size ....................................................................................................................................... 99

Auto Select Prompts ............................................................................................................................... 99

AutoLoad JVM ........................................................................................................................................ 99

Serial Recycle ........................................................................................................................................ 100PSANALYTICSRV Options ...................................................................................................................... 100

Min Instances ....................................................................................................................................... 100

Max Instances ....................................................................................................................................... 100

Analytic Instance Idle Timeout ............................................................................................................ 101

PSSAMSRV Options .................................................................................................................................. 101

Min Instances ....................................................................................................................................... 101

Max Instances ....................................................................................................................................... 101

Service Timeout ................................................................................................................................... 101

7/22/2019 pt851tsvt-b0810

8/421

Contents

viii Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved.

Recycle Count ...................................................................................................................................... 101

Allowed Consec Service Failures ........................................................................................................ 102

Max Fetch Size ..................................................................................................................................... 102

PSQCKSRV Options .................................................................................................................................. 102

Min Instances ....................................................................................................................................... 102

Max Instances ....................................................................................................................................... 102

Service Timeout ................................................................................................................................... 102Recycle Count ...................................................................................................................................... 103

Allowed Consec Service Failures ........................................................................................................ 103

Max Fetch Size ..................................................................................................................................... 103

Serial Recycle ........................................................................................................................................ 103

PSQRYSRV Options .................................................................................................................................. 103

Min Instances ....................................................................................................................................... 103

Max Instances ....................................................................................................................................... 104

Service Timeout ................................................................................................................................... 104

Recycle Count ...................................................................................................................................... 104

Allowed Consec Service Failures ........................................................................................................ 104Max Fetch Size ..................................................................................................................................... 104

Use Dirty-Read ..................................................................................................................................... 104

Serial Recycle ........................................................................................................................................ 105

Integration Broker Server Processes ........................................................................................................... 105

SMTP Settings ............................................................................................................................................ 105

SMTPServer ......................................................................................................................................... 106

SMTPPort ............................................................................................................................................. 106

SMTPServer1 ....................................................................................................................................... 106

SMTPPort1 ........................................................................................................................................... 106

SMTPSender ........................................................................................................................................ 106SMTP BlackberryReplyTo ................................................................................................................... 106

SMTPSourceMachine .......................................................................................................................... 106

SMTPCharacterSet ............................................................................................................................... 106

SMTPEncodingDLL ............................................................................................................................ 106

SMTPGuaranteed ................................................................................................................................. 107

SMTPTrace .......................................................................................................................................... 107

SMTPSendTime ................................................................................................................................... 107

SMTPUserName .................................................................................................................................. 107

SMTPUserPassword ............................................................................................................................. 107

SMTPUserName1 ................................................................................................................................. 107SMTPUserPassword1 ............................................................................................................................ 107

SMTPTimeToWaitForResult ................................................................................................................ 108

SMTPUseSSL ...................................................................................................................................... 108

SMTPSSLPort ....................................................................................................................................... 108

SMTPClientCertAlias ........................................................................................................................... 108

SMTPSSLPort1 ..................................................................................................................................... 108

SMTPUseSSL1 ..................................................................................................................................... 108

SMTPClientCertAlias1 ......................................................................................................................... 108

7/22/2019 pt851tsvt-b0810

9/421

Contents

Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved. ix

SMTPDNSTimeoutRetries .................................................................................................................... 108

SMTP Further Considerations .............................................................................................................. 109

Interface Driver Options ............................................................................................................................. 109

SCP_LOCALE ...................................................................................................................................... 109

PSTOOLS Options ...................................................................................................................................... 109

EnablePPM Agent ................................................................................................................................ 109

Add to CLASSPATH ........................................................................................................................... 110JavaVM Options ................................................................................................................................... 110

Proxy Host ............................................................................................................................................ 111

Proxy Port ............................................................................................................................................. 111

Non Proxy Hosts .................................................................................................................................. 111

Usage Monitoring State ......................................................................................................................... 111

Character Set ........................................................................................................................................ 112

Suppress App Error Box (Microsoft Windows Only) .......................................................................... 112

DbFlags ................................................................................................................................................ 112

Suppress SQL Error ............................................................................................................................. 113

Integration Broker Options ......................................................................................................................... 114Min Message Size for Compression ..................................................................................................... 114

Thread Pool Size .................................................................................................................................. 114

Search .......................................................................................................................................................... 114

Search Indexes ............................................................................................................................................ 115

PSRENSRV Options ................................................................................................................................... 115

log-severity_level ................................................................................................................................. 115

io_buffer_size ....................................................................................................................................... 115

default_http_port .................................................................................................................................. 115

default_https_port ................................................................................................................................. 115

default_auth_token ............................................................................................................................... 115PSPPMSRV Options ................................................................................................................................... 116

Min Instances ........................................................................................................................................ 116

Max Instances ........................................................................................................................................ 116

Select Server Process Options ..................................................................................................................... 116

Do you want the Publish/Subscribe servers configured? ..................................................................... 116

Move quick PSAPPSRV services into a second server (PSQCKSRV)? ............................................. 117

Move long-running queries into a second server (PSQRYSRV)? ....................................................... 117

Do you want JOLT configured? ........................................................................................................... 117

Do you want JRAD configured? .......................................................................................................... 117

Do you want WSL Configured? ........................................................................................................... 117Do you want to enable PeopleCode Debugging (PSDBGSRV)? ........................................................ 117

Do you want Event Notification configured (PSRENSRV)? ............................................................... 117

Do you want MCF Servers configured? ............................................................................................... 118

Do you want Performance Collators configured? ................................................................................ 118

Do you want Analytic Servers configured? ......................................................................................... 118

Do you want Domains Gateway configured? ....................................................................................... 118

7/22/2019 pt851tsvt-b0810

10/421

Contents

x Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved.

Chapter 7

Working with Oracle WebLogic .............................................................................................................. 119

Understanding WebLogic ........................................................................................................................... 119

Working With the WebLogic Server Administration Console ................................................................... 120Starting WebLogic ...................................................................................................................................... 121

Starting WebLogic on Microsoft Windows ......................................................................................... 121

Starting WebLogic on UNIX ............................................................................................................... 123

Stopping WebLogic .................................................................................................................................... 123

Stopping WebLogic Using the Administration Console ....................................................................... 123

Stopping WebLogic Using the Command Line .................................................................................... 124

Using WebLogic Server Administration Console to Monitor PeopleSoft Sessions ................................... 124

Setting Up Reverse Proxy Servers .............................................................................................................. 125

Understanding Reverse Proxy Servers For PeopleSoft Implementations ............................................. 126

Configuring Microsoft IIS as an RPS .................................................................................................. 126Configuring Microsoft IIS 7.0 as an RPS ............................................................................................. 128

Configuring WebLogic as an RPS ....................................................................................................... 131

Configuring Sun Java System Web Server as an RPS ......................................................................... 134

Configuring Apache HTTP as an RPS ................................................................................................. 137

Setting The HTTP Session Timeout ........................................................................................................... 138

Setting Authentication Failure Timeout ....................................................................................................... 138

Enabling or Disabling HTTP Keep Alive ................................................................................................... 138

Changing WebLogic User Passwords ......................................................................................................... 139

Implementing WebLogic SSL Keys and Certificates ................................................................................. 141

Understanding SSL Encryption with WebLogic .................................................................................. 141Obtaining Encryption Keys .................................................................................................................. 141

Preparing Keys and Certificates for the Keystore ................................................................................ 144

Importing Keys and Certificates Into the Keystore .............................................................................. 146

Configuring WebLogic SSL Encryption Keys ..................................................................................... 148

Enabling TLS-Only on WebLogic ............................................................................................................... 150

Configuring TLS-Only on WebLogic Server ........................................................................................ 150

Configuring Browsers for TLS ............................................................................................................. 150

Configuring Reverse Proxy Servers for TLS ........................................................................................ 151

Working With WebLogic Session Cookies ................................................................................................. 151

Securing Servlets on WebLogic ................................................................................................................... 152Adjusting the JVM Heap Size ..................................................................................................................... 154

Determining the Service Pack Level ........................................................................................................... 155

Enabling HTTP Access Log ....................................................................................................................... 156

7/22/2019 pt851tsvt-b0810

11/421

Contents

Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved. xi

Chapter 8

Working with IBM WebSphere ................................................................................................................ 159

Understanding WebSphere Application Server Within Your PeopleSoft Implementation ......................... 159

Deploying PeopleSoft Applications With WebSphere ......................................................................... 159Using The Integrated Solutions Console ............................................................................................... 160

WebSphere Application Server Profiles ............................................................................................... 161

IBM HTTP Server ................................................................................................................................. 162

Starting and Stopping WebSphere Application Servers .............................................................................. 163

Starting the WebSphere Server ............................................................................................................. 163

Stopping the WebSphere Server ........................................................................................................... 163

Configuring Reverse Proxy Servers For WebSphere .................................................................................. 163

Understanding Reverse Proxy Servers With IBM WebSphere ............................................................. 164

Configuring IBM HTTP Server as a Reverse Proxy Server ................................................................. 164

Configuring Microsoft IIS as a Reverse Proxy Server .......................................................................... 165Configuring Sun Java System Web Server as a Reverse Proxy Server ................................................ 167

Setting Up SSL For WebSphere .................................................................................................................. 169

Understanding WebSphere Key Stores ................................................................................................. 169

Generating a Certificate Using pskeymanager ...................................................................................... 170

Configuring the WebSphere Container to Support SSL ....................................................................... 172

Enabling TLS-Only on WebSphere ............................................................................................................. 173

Configuring WebSphere for TLS .......................................................................................................... 173

Configuring Browsers for TLS ............................................................................................................. 174

Testing TLS ........................................................................................................................................... 174

Configuring Reverse Proxy Servers for TLS ........................................................................................ 174Securing The Administrative Console and Applications For WebSphere ................................................... 175

Understanding WebSphere Security ..................................................................................................... 175

Securing the Administrative Console .................................................................................................... 176

Configuring Application Security ......................................................................................................... 179

Setting HTTP Session Timeout ................................................................................................................... 181

Setting Authentication Failure Timeout ....................................................................................................... 182

Working With JVM Heap Size .................................................................................................................... 182

Working with Logging and Tracing Options ............................................................................................... 183

Enabling HTTP Access and HTTP Error Logging ............................................................................... 183

Enabling General Logging and Tracing ................................................................................................ 183

Chapter 9

Configuring Search and Building Search Indexes ................................................................................. 185

Understanding PeopleSoft Search Indexes ................................................................................................. 185

Overview of Search Indexes .................................................................................................................. 185

7/22/2019 pt851tsvt-b0810

12/421

Contents

xii Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved.

Types of Indexes .................................................................................................................................. 186

Components of the Search Architecture ............................................................................................... 186

Index Building ...................................................................................................................................... 188

Search Index Limitations ..................................................................................................................... 189

User Search Strategies .......................................................................................................................... 190

Configuring PeopleSoft Search .................................................................................................................... 191

Understanding PeopleSoft Search Configurations ................................................................................ 191Configuring Search to run within the Application Server (Type-1) ..................................................... 193

Configuring Search to Run as a Separate Process (Type-2) ................................................................. 193

Configuring a Separate Search Server (Type-3) ................................................................................... 194

Search Server Administration ............................................................................................................... 198

Working with Indexes .................................................................................................................................. 200

Understanding Common Controls ........................................................................................................ 200

Understanding Supported MIME Types .............................................................................................. 201

Opening Existing Collections ............................................................................................................... 202

Creating New Collections .................................................................................................................... 202

Building Record-Based Indexes .................................................................................................................. 203Modifying Record-Based Index Properties .......................................................................................... 203

Adding Subrecords to Search Indexes ................................................................................................. 206

Building File System (Spider) Indexes ....................................................................................................... 207

Setting File System Options ................................................................................................................. 207

Defining What to Index ........................................................................................................................ 208

Building HTTP Spider Indexes ................................................................................................................... 209

Defining HTTP Gateway Settings ........................................................................................................ 209

Defining What to Index ........................................................................................................................ 211

Administering Search Indexes .................................................................................................................... 211

Specifying the Index Location ............................................................................................................. 211Administering the Search Index ........................................................................................................... 212

Editing Properties ................................................................................................................................. 213

Scheduling Administration ................................................................................................................... 214

Sharing Indexes Between Application Servers and PeopleSoft Process Scheduler ............................. 214

Modifying the VdkVgwKey Key ................................................................................................................ 215

Chapter 10

Using PeopleSoft Configuration Manager ............................................................................................... 217

Understanding PeopleSoft Configuration Manager .................................................................................... 217

Common Elements in PeopleSoft Configuration Manager ................................................................... 218

Starting PeopleSoft Configuration Manager ............................................................................................... 218

Specifying Startup Settings ........................................................................................................................ 218

Specifying Display Settings ........................................................................................................................ 220

Specifying Crystal Report, Business Interlink, and JDeveloper Settings ................................................... 222

Specifying Trace Settings ........................................................................................................................... 223

7/22/2019 pt851tsvt-b0810

13/421

Contents

Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved. xiii

Specifying Workflow Settings .................................................................................................................... 224

Specifying Remote Call/AE Settings ........................................................................................................... 224

Configuring Developer Workstations .......................................................................................................... 225

Importing and Exporting Environment Settings .......................................................................................... 226

Configuring User Profiles ............................................................................................................................ 227

Defining a Profile .................................................................................................................................. 227

Specifying Databases and Application Servers ..................................................................................... 228Configuring Process Scheduler ............................................................................................................. 230

Configuring nVision .............................................................................................................................. 232

Specifying Common Settings ............................................................................................................... 234

Specifying Command Line Options ............................................................................................................ 235

Setting Up the PeopleTools Development Environment ............................................................................ 236

Understanding the PeopleTools Development Environment ................................................................ 236

Understanding the Client Setup Process .............................................................................................. 237

Verifying PS_HOME Access ............................................................................................................... 237

Verifying Connectivity ......................................................................................................................... 237

Verify Supporting Applications ........................................................................................................... 237Using the Configuration Manager ......................................................................................................... 238

Running the Client Setup Process ........................................................................................................ 238

Chapter 11

Using PeopleTools Utilities ....................................................................................................................... 241

Understanding the PeopleTools Utilities ..................................................................................................... 241

Using the System Information Page ........................................................................................................... 241

Understanding the System Information Page ........................................................................................ 242Viewing the System Information Page ................................................................................................. 242

Using Administration Utilities .................................................................................................................... 244

Signon Event Message .......................................................................................................................... 245

PeopleTools Options ............................................................................................................................. 248

Message Catalog .................................................................................................................................. 259

Spell Check System Dictionary ............................................................................................................ 261

Translate Values ................................................................................................................................... 262

Load Application Server Cache ........................................................................................................... 263

Tablespace Utilities .............................................................................................................................. 268

Tablespace Management ...................................................................................................................... 269DDL Model Defaults ............................................................................................................................ 270

BOE Integration Administration ........................................................................................................... 272

Strings Table ........................................................................................................................................ 272

Lookup Exclusion ................................................................................................................................. 273

XML Link Function Registry ............................................................................................................... 273

Merchant Integration Utilities .............................................................................................................. 273

TableSet IDs ......................................................................................................................................... 274

7/22/2019 pt851tsvt-b0810

14/421

Contents

xiv Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved.

Record Group ....................................................................................................................................... 274

TableSet Control .................................................................................................................................. 275

Convert Panels to Pages ....................................................................................................................... 275

Update Utilities .................................................................................................................................... 278

Remote Database Connection .............................................................................................................. 278

URL Maintenance ................................................................................................................................ 279

Copy File Attachments ......................................................................................................................... 286Query Administration ........................................................................................................................... 287

Sync ID Utilities ................................................................................................................................... 287

nVision Report Request Admin ............................................................................................................ 288

Analytic Server Administration ............................................................................................................ 288

Upgrade Conversion .............................................................................................................................. 288

Analytic Model Viewer ......................................................................................................................... 288

Analytic Instance Load/Unload ............................................................................................................. 288

Analytic Instance Create/Del/Copy/ ...................................................................................................... 288

Pre-Load Cache Utilities ....................................................................................................................... 288

Gather Utility ........................................................................................................................................ 289QAS Administration .............................................................................................................................. 291

Oracle Resource Management ............................................................................................................... 291

Using Audit Utilities ................................................................................................................................... 291

Using the Record Cross Reference Component ................................................................................... 291

Performing a System Audit ................................................................................................................... 293

Performing Database Level Auditing ................................................................................................... 294

Using Debug Utilities ................................................................................................................................. 294

Using the PeopleTools Test Utilities Page ............................................................................................ 294

Replay Appserver Crash ........................................................................................................................ 296

Using the Trace PeopleCode Utility ...................................................................................................... 297Using the Trace SQL Utility ................................................................................................................. 297

Using International Utilities ........................................................................................................................ 297

Setting International Preferences .......................................................................................................... 297

Setting Process Field Size .................................................................................................................... 298

Administering Time Zones ................................................................................................................... 298

Managing Languages ........................................................................................................................... 298

Using Optimization Utilities ....................................................................................................................... 300

Using PeopleSoft Ping ................................................................................................................................ 300

PeopleSoft Ping Chart .......................................................................................................................... 301

PeopleSoft Ping Delete .......................................................................................................................... 302PeopleSoft Ping Options ....................................................................................................................... 302

Chapter 12

Tracing, Logging, and Debugging ............................................................................................................ 303

Setting Up the PeopleCode Debugger ........................................................................................................ 303

7/22/2019 pt851tsvt-b0810

15/421

Contents

Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved. xv

Debugging for a Two-Tier Connection ................................................................................................ 303

Debugging for a Three-Tier Connection .............................................................................................. 304

Using the PeopleCode Debugger ......................................................................................................... 306

Configuring PeopleCode Trace ................................................................................................................... 306

Configuring SQL Trace .............................................................................................................................. 308

Enabling IDDA Logging .............................................................................................................................. 308

Understanding IDDA Logging .............................................................................................................. 309Enabling IDDA Logging ....................................................................................................................... 310

Working with IDDA Functional Categories ......................................................................................... 310

Configuring Logging Options ............................................................................................................... 311

Viewing IDDA Logging Output ........................................................................................................... 312

Chapter 13

Working with Jolt Configuration Options .............................................................................................. 315

Configuring Jolt Failover and Load Balancing ............................................................................................ 315Configuring Weighted Load Balancing ................................................................................................ 315

Configuring Jolt Failover ...................................................................................................................... 316

Configuring Jolt Session Pooling ................................................................................................................. 316

Configuring Domain Connection Password ................................................................................................ 316

Understanding Jolt Internet Relay ............................................................................................................... 317

Jolt Internet Relay Architecture ........................................................................................................... 317

Implementation Considerations ............................................................................................................ 318

Configuring JRLY ...................................................................................................................................... 319

Configuring JRAD ...................................................................................................................................... 321

Running Jolt Relay ...................................................................................................................................... 321Using the JRLY Administration Program ............................................................................................ 321

Running Jolt Relay on Windows .......................................................................................................... 322

Running Jolt Relay on UNIX ............................................................................................................... 323

Appendix A

Securing PS_HOME and PS_CFG_HOME ............................................................................................ 325

Understanding PS_HOME and PS_CFG_HOME Security ......................................................................... 325

Understanding PS_HOME Security ...................................................................................................... 325

Understanding Minimum Access Required by The User Starting Domains ........................................ 326

Understanding PS_CFG_HOME Security ............................................................................................ 327

Securing PS_HOME on UNIX .................................................................................................................... 327

Managing a Secure PS_HOME on UNIX .................................................................................................... 328

Working with User Accounts ................................................................................................................ 328

Configuring Partial PS_HOME Access ................................................................................................ 328

Securing PS_HOME on Windows ............................................................................................................... 329

7/22/2019 pt851tsvt-b0810

16/421

Contents

xvi Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved.

Multiple Administrator User Accounts ................................................................................................. 329

Local User Accounts ............................................................................................................................. 331

Managing a Secure PS_HOME on Windows .............................................................................................. 333

Working With Mapped Drives, UNC Paths, and TM_TUXIPC_MAPDRIVER ................................. 333

Working With Oracle ProcMGR Windows Service ............................................................................. 334

Managing TM_TUXIPC_MAPDRIVER .............................................................................................. 335

Resolving Initialization Timeout Issues ................................................................................................ 335Implementing PS_CFG_HOME Security .................................................................................................... 335

Securing PS_CFG_HOME on UNIX .................................................................................................... 336

Securing PS_CFG_HOME on Windows .............................................................................................. 337

Appendix B

WebLogic Managed Server Architecture ............................................................................................... 339

PeopleSoft Internet Architecture Servlets and Applications ....................................................................... 339

WebLogic Domain Types ........................................................................................................................... 340Understanding WebLogic Domain Types ............................................................................................. 340

Single-Server Domains ........................................................................................................................ 340

Multi-Server Domains .......................................................................................................................... 342

Distributed Managed Servers ............................................................................................................... 345

Common Default Settings .................................................................................................................... 347

WebLogic Domain Directory Structure and Files ...................................................................................... 351

WebLogic Domain Directory Structure ................................................................................................ 351

WebLogic Domain File Listing by Type .............................................................................................. 352

J2EE Application Files ......................................................................................................................... 355

PIA Install and Reinstall Options ............................................................................................................... 356Administering a WebLogic Server Life Cycle ........................................................................................... 357

Understanding the WebLogic Server Life Cycle .................................................................................. 357

Starting and Stopping Single-Server Processes ................................................................................... 357

Starting and Stopping Multi-Server Processes ..................................................................................... 358

Starting and Stopping a Distributed Managed Server .......................................................................... 362

Tuning Performance and Monitoring Resources ........................................................................................ 362

Managing JVM Heap Size ................................................................................................................... 363

Monitoring HTTP Session Count for PeopleSoft Portal ...................................................................... 364

Changing Configuration Settings ................................................................................................................. 365

Understanding the WebLogic Server Configuration Files ................................................................... 365Changing the WebLogicAdmin Server's Listen Ports .......................................................................... 365

Changing Application and Server Deployment Targets ...................................................................... 366

Appendix C

PeopleSoft Timeout Settings .................................................................................................................... 369

7/22/2019 pt851tsvt-b0810

17/421

Contents

Copyright 1988, 2010, Oracle and/or its affiliates. All Rights Reserved. xvii

Web Server Timeouts .................................................................................................................................. 369

Session-Timeout .................................................................................................................................... 371

Web Server Default System Timeout .................................................................................................... 371

Application Server Timeouts ...................................................................................................................... 372

Process Scheduler Timeouts ....................................................................................................................... 374

Search Server Timeouts .............................................................................................................................. 374

PIA Timeouts .............................................................................................................................................. 376

Appendix D

Ensuring Session Stickiness ...................................................................................................................... 377

Working With Session Cookie Names ........................................................................................................ 377

Using Enterprise Portal and Content Providers ........................................................................................... 377

Working With Absolute URLs .................................................................................................................... 378

Setting The Cookie Domain ......................................................................................................................... 379

Working with Load Balancer Timeouts ....................................................................................................... 379Configuring The Session Cookie Name for WebSphere ...................................................................... 379

Configuring The Cookie Domain for WebSphere ......................................