PeopleSoft Enterprise Environment Management Plug-in for Oracle Enterprise Manager Implementation Guide
Add to my manuals136 Pages
advertisement
PeopleSoft Enterprise Environment
Management Plug-in for Oracle
Enterprise Manager Implementation
Guide
October 2006
PeopleSoft Enterprise Environment Management Plug-in for Oracle Enterprise Manager Implementation Guide
SKU PT848PLUGINDOCR0
Copyright © 2006, Oracle. All rights reserved.
The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the
Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited.
The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose.
If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS
Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are “commercial computer software” or “commercial technical data” pursuant to the applicable Federal
Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987).
Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065.
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee’s responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs.
The Programs may provide links to Web sites and access to content, products, and services from third parties.
Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.
Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or its affiliates.
Other names may be trademarks of their respective owners.
Open Source Disclosure
Oracle takes no responsibility for its use or distribution of any open source or shareware software or documentation and disclaims any and all liability or damages resulting from use of said software or documentation. The following open source software may be used in Oracle’s PeopleSoft products and the following disclaimers are provided.
Apache Software Foundation
This product includes software developed by the Apache Software Foundation (http://www.apache.org/). Copyright
© 2000-2003. The Apache Software Foundation. All rights reserved. Licensed under the Apache License, Version
2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the
License at http://www.apache.org/licenses/LICENSE-2.0.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an
“AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under the License.
OpenSSL
Copyright © 1998-2005 The OpenSSL Project. All rights reserved.
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit
(http://www.openssl.org/).
THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT “AS IS” AND ANY EXPRESSED OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
OF SUCH DAMAGE.
Loki Library
Copyright © 2001 by Andrei Alexandrescu. This code accompanies the book: Alexandrescu, Andrei. “Modern C++
Design: Generic Programming and Design Patterns Applied”. Copyright © 2001 Addison-Wesley. Permission to use, copy, modify, distribute and sell this software for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.
Helma Project
Copyright © 1999-2004 Helma Project. All rights reserved. THIS SOFTWARE IS PROVIDED “AS IS”
AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE HELMA PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Helma includes third party software released under different specific license terms. See the licenses directory in the
Helma distribution for a list of these license.
Sarissa
Copyright © 2004 Manos Batsis.
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General
Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
ICU
ICU License - ICU 1.8.1 and later COPYRIGHT AND PERMISSION NOTICE Copyright © 1995-2003
International Business Machines Corporation and others. All rights reserved.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, provided that the above copyright notice(s) and this permission notice appear in all copies of the Software and that both the above copyright notice(s) and this permission notice appear in supporting documentation. THE SOFTWARE IS PROVIDED “AS IS,” WITHOUT WARRANTY
OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD
PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS
NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES,
OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder.
All trademarks and registered trademarks mentioned herein are the property of their respective owners.
Sun’s JAXB Implementation – JDSDK 1.5 relaxngDatatype.jar 1.0 License
Copyright © 2001, Thai Open Source Software Center Ltd, Sun Microsystems. All rights reserved.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS
IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
W3C IPR SOFTWARE NOTICE
Copyright © 2000 World Wide Web Consortium, (Massachusetts Institute of Technology, Institut National de
Recherche en Informatique et en Automatique, Keio University). All Rights Reserved.
Note: The original version of the W3C Software Copyright Notice and License could be found at http://www.w3.org/Consortium/Legal/copyright-software-19980720.
THIS SOFTWARE AND DOCUMENTATION IS PROVIDED “AS IS,” AND COPYRIGHT HOLDERS MAKE
NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO,
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE
USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS,
COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS. COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR
ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF
THE SOFTWARE OR DOCUMENTATION.
Contents
PeopleSoft Environment Management Plug-in for Oracle Enterprise Manager
PeopleSoft Environment Management Plug-in Preface...................................................
Getting Started with PeopleSoft Environment Management Plug-in..................... ..........1
Monitoring and Managing Each of the PeopleSoft Target Types.........................................
Installing the PeopleSoft Environment Management Plug-in............................... ..........3
Defining Support for the PeopleSoft Environment Management Plug-in................................
Understanding the PeopleSoft Environment Management Plug-in Installation........................
Downloading the PeopleSoft Environment Management Plug-in Installation Software...............
Installing the PeopleSoft Environment Management Plug-in to the Oracle Management Service. .
Installing the Management Agent for the PeopleSoft Environment Management Plug-in............
Installing the PeopleSoft Environment Management Plug-in to the Management Agent.............
Understanding the PeopleSoft Environment Management Plug-in Extensions Installation.......
Installing the PeopleSoft Environment Management Plug-in Extensions...........................
Installing PeopleSoft Environment Management Plug-in Patches for OMS........................
Using Enterprise Manager Grid Control for the First Time............................................
Copyright © 2006, Oracle. All rights reserved.
v
Contents
Understanding the PeopleSoft Environment Management Plug-in....................... . .. .. .. .19
PeopleSoft Environment Management Plug-in Overview.................................................
Common Terms Used in This Book......................................................................
Features of the PeopleSoft Environment Management Plug-in..........................................
Accessing Enterprise Manager Grid Control Console.................................................
PeopleSoft Environment Management Plug-in Pages.....................................................
The Enterprise Manager Homepage ....................................................................
Common Elements on Homepages......................................................................
Common Elements on Administration Pages...........................................................
vi Copyright © 2006, Oracle. All rights reserved.
Contents
The PS Process Scheduler Domain Homepage ...........................................................
Copyright © 2006, Oracle. All rights reserved.
vii
Contents
The PeopleSoft System Homepage......................................................................
Automated PeopleSoft System Creation................................................................
viii Copyright © 2006, Oracle. All rights reserved.
Contents
Copyright © 2006, Oracle. All rights reserved.
ix
Contents x Copyright © 2006, Oracle. All rights reserved.
PeopleSoft Environment Management Plug-in for Oracle Enterprise Manager Preface
This preface describes the PeopleSoft Environment Management Plug-in for Enterprise Manager.
PeopleSoft Environment Management Plug-in Preface
This product has been developed as an integration with Oracle Enterprise Manager Framework to enhance
PeopleSoft system administration. By using Oracle Enterprise Manager Grid Control features, PeopleSoft environments can be monitored and managed in a graphical interface.
This book assumes that you are familiar with Oracle Enterprise Manager features and terms, and that you have experience with PeopleSoft system administration utilities.
Copyright © 2006, Oracle. All rights reserved.
xi
Preface xii Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
1
Getting Started with PeopleSoft Environment
Management Plug-in
This chapter discusses:
• Sources of additional information
• PeopleSoft Environment Management Plug-in installation
• PeopleSoft target discovery
• Monitoring and managing each of the PeopleSoft target types
Sources of Additional Information
The PeopleSoft Environment Management Plug-in runs within the framework of Oracle Enterprise Manager.
Therefore, as you install and use the features of Enterprise Manager, you may need to get more information than is provided in this guide.
Many of the concepts and tasks described in this book relate to PeopleSoft system administration tasks.
See Enterprise PeopleTools 8.48 PeopleBook: System and Server Administration
Oracle Documentation
Enterprise Manager provides a wide range of information for different types of users at many different levels of expertise.
There are four major information sources for Oracle Enterprise Manager:
• Online help screenwatches
Enterprise Manager comes with a comprehensive set of narrated tutorials (screenwatches) covering major functional areas of Enterprise Manager. Screenwatches are 10- to 15-minute-long narrated demonstrations that cover everything from performing routine tasks, such as creating blackouts, to using specialized features such as Application Service Level Management. Screenwatches can be accessed directly from the Enterprise Manager console, from the online help system, and from the Enterprise Manager product area on Oracle Technology Network.
• Oracle Technology Network (OTN)
The Enterprise Manager product center on OTN (available at http://www.oracle.com) is your source for the latest Enterprise Manager information. There you will find newly released documentation and screenwatches, whitepapers, tutorials, internet seminars, and technology/application-specific literature.
Major product feature enhancements such as Enterprise Manager framework extensibility is also available.
• Printed documentation
Copyright © 2006, Oracle. All rights reserved.
1
2
Getting Started with PeopleSoft Environment Management Plug-in Chapter 1
Enterprise Manager books can help you install and configure Enterprise Manager, as well as provide you with important concepts that can save you time. You can find the complete Enterprise Manager documentation library on OTN at http://www.oracle.com/technology/documentation/oem.html.
• Online help
Online help is available from any Enterprise Manager page. In most cases, clicking Help displays a context-sensitive help topic that contains information about the features available on the current page and related topics. The online help system provides substantial technical and reference information such as a complete metric reference, detailed conceptual information, and procedural instruction on how to carry out both simple and complex administrative tasks with Enterprise Manager.
Online help is your best resource for learning Enterprise Manager.
PeopleSoft Environment Management Plug-in Installation
You install the PeopleSoft Environment Management Plug-in after you have installed the Oracle Enterprise
Manager software and PeopleSoft PeopleTools Release 8.48.
See Chapter 2, “Installing the PeopleSoft Environment Management Plug-in,” page 3.
For detailed information about Enterprise Manager hardware and software requirements, configurations, and certified web browsers, open the Oracle Technology Network Enterprise Manager Product Center site.
The minimum release of Oracle Enterprise Manager Grid Control software that is supported for the PeopleSoft
Environment Management Plug-in is 10.2.0.2.0. It cannot install with an earlier version of Enterprise Manager.
See http://www.oracle.com/technology/products/oem/index.html
PeopleSoft Target Discovery
After you have installed all of the required software, you can begin the discovery of the PeopleSoft targets.
PeopleSoft targets refer to the elements of a PeopleSoft environment, such as an application server, application database, PeopleSoft website, and so on.
The discovery process identifies and registers PeopleSoft targets in Enterprise Manager so that they can be monitored and managed.
See Also
Chapter 4, “Discovering PeopleSoft Targets ,” page 39
Monitoring and Managing Each of the PeopleSoft Target Types
After the PeopleSoft targets have been discovered you can begin monitoring and managing PeopleSoft systems and targets. Concepts and tasks relating to systems and targets are discussed in individual chapters of this guide.
Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
2
Installing the PeopleSoft Environment
Management Plug-in
This chapter includes:
• Defining Support for the PeopleSoft Environment Management Plug-in
• Understanding the PeopleSoft Environment Management Plug-in Installation
• Downloading the PeopleSoft Environment Management Plug-in Installation Software
• Installing PeopleSoft Products
• Installing Oracle Enterprise Manager (OMS)
• Installing the PeopleSoft Environment Management Plug-in to the Oracle Management Service
• Installing the Management Agent for the PeopleSoft Environment Management Plug-in
• Installing the PeopleSoft Environment Management Plug-in to the Management Agent
• Installing Patches
• Using the Enterprise Manager Grid Control Console
Defining Support for the PeopleSoft Environment
Management Plug-in
Oracle’s PeopleSoft Environment Management Plug-in allows you to use the Oracle Enterprise Manager to monitor and manage your PeopleSoft products.
The PeopleSoft Plug-in is supported on the following RDBMS platforms:
• DB2 UDB for Linux, UNIX, and Windows
• Informix
• Microsoft SQL Server
• Oracle
• Sybase
The PeopleSoft Plug-in is supported on the following operating system platforms:
• Windows Server 2003
• Solaris 9 and Solaris 10
• AIX 5.2 and AIX 5.3
Copyright © 2006, Oracle. All rights reserved.
3
Installing the PeopleSoft Environment Management Plug-in
• HP-UX 11.23 for IA64 (Agent only)
• HP-UX 11.23 for IA64 (Agent only)
• Red Hat Enterprise Linux 4.0 for x86
• SuSE Enterprise Linux 9.0 for x86
Chapter 2
Understanding the PeopleSoft Environment Management
Plug-in Installation
Oracle’s PeopleSoft Environment Management Plug-in allows you to use Oracle Enterprise Manager to monitor and manage your PeopleSoft products. This section describes the installation of the components needed to use the PeopleSoft Environment Management Plug-in. The PeopleSoft Environment Management
Plug-in is compatible with PeopleSoft PeopleTools 8.48.
With the PeopleSoft Environment Management Plug-in, you can use the graphical user interface of Oracle
Enterprise Manager Grid Control Console to manage PeopleSoft Components such as the Application Server
Domain, Process Scheduler Domain, and PIA. You can also use the PeopleSoft Environment Management
Plug-in to perform many of the functions carried out by PSADMIN in pre-8.48 PeopleTools releases.
Please continue to log cases with the Global Support Center for PeopleSoft Environment Management
Plug-in related issues.
4
Downloading the PeopleSoft Environment Management
Plug-in Installation Software
You can download the software discussed in this chapter from the Oracle E-Delivery site, as described below:
1. Open https://edelivery.oracle.com in a browser.
2. After reading the contents of the welcome screen, click Continue.
3. Enter the Full Name, Company name, email address and country in the text boxes provided.
4. Read and understand the Notice, Electronic Delivery Trial License Agreement and Export Restrictions sections of the Export Validation Screen.
Select the Yes check box under the Electronic Delivery Trial License Agreement and Export
Restriction to indicate your understanding.
5. Click the Continue option at the bottom of the screen.
6. On the Media Pack Search screen, select Oracle Enterprise Manager in the Select a Product Pack drop-down.
7. Choose the appropriate platform and click Go.
8. Select the Application Management Pack for PeopleSoft Enterprise from the Results list and click
Continue.
9. Click Download.
10. Unzip the file.
Copyright © 2006, Oracle. All rights reserved.
Chapter 2
Installing the PeopleSoft Environment Management Plug-in
Note. If necessary, you can download zip and unzip utilities from the same page in https://edelivery.oracle.com.
The media downloaded from Oracle E-Delivery will have a structure similar to the following:
---Disk1
---------5016553.zip
---------stage (directory)
---------README.txt
The file 5016553.zip can be used to deploy the PeopleSoft Plug-in extension to agents via OMS as a patch.
This is covered in detail in the task Installing the PeopleSoft Environment Management Plug-in Extensions.
The file README.txt contains information about the prerequisites necessary to install this version of the
PeopleSoft Environment Management Plug-in and the bugs that are fixed for this version of the PeopleSoft
Environment Management Plug-in.
Place the downloaded files in a directory and make a note of the location. This chapter refers to the directory with the install files as <INSTALL_DIRECTORY>.
Installing PeopleSoft Products
Install PeopleSoft PeopleTools release 8.48 and applicable PeopleSoft applications. Refer to the PeopleTools and application installation guides for detailed steps, if needed.
Note. Though the Oracle Management Repository itself runs an Oracle database that stores information about the managed targets, there is no restriction on which PeopleSoft database platform is supported. All databases supported by PeopleTools are supported by the PeopleSoft Environment Management Plug-in.
See Enterprise PeopleTools 8.48 Installation Guides, PeopleSoft Customer Connection, (Site index, installation guides and notes, Enterprise. Select PeopleTools or your application for the appropriate installation guide).
Installing Oracle Enterprise Manager (OMS)
Oracle Enterprise Manager includes the Oracle Management Agent, Oracle Management Service (OMS), and Oracle Management Repository Database. The installation procedure for Oracle Enterprise Manager, the
Management Repository, and Oracle Management Service is available on the Oracle Technology Network
(OTN). This documentation refers to the Oracle Management Repository Database as the Management
Repository.
/doc/nav/portal_booklist.htm
The minimum version of Oracle Enterprise Manager Grid Control required in order to install the PeopleSoft
Environment Management Plug-in is 10.2.0.2, but the installation depends upon the operating system platform.
For example, for OMS on Solaris 9, you will have to install 10.2.0.1 Full Release and then the 10.2.0.2
patch-set on top of the 10.2.0.1 OMS. See the table at the end of this task for more details on the software version and patches needed for specific operating systems.
Copyright © 2006, Oracle. All rights reserved.
5
Installing the PeopleSoft Environment Management Plug-in
Chapter 2
If you install the OMS-side PeopleSoft Extensions on any non-Windows platforms you must install OMS
10.2.0.1, and download the 10.2.0.2 patch set for the appropriate platform from https://metalink.oracle.com.
To download the patch set from Metalink:
1. Log on to https://metalink.oracle.com.
2. Select the Patches and Updates tab, and then select the Simple Search link.
3. Select Patch Number from the Search By drop-down list. Enter 3731593 in the Patch Number textbox.
4. Choose the appropriate platform and click Go.
5. In the results table select link 3731593, for the version 10.2.0.2.
6. Verify that the platform is correct on the next screen and click Download.
7. Apply the patch set to upgrade the OMS to 10.2.0.2.
This installation method will only enable you to do a mass deployment of 10.2.0.1 Management Agents. To do a mass deployment of 10.2.0.2 Managements Agents, you must also download the 10.2.0.2 Mass Agent
Deployment from Metalink. To download the patch set from Metalink:
1. Log on to https://metalink.oracle.com.
2. Select the Patches and Updates tab, and then select the Simple Search link.
3. Select Patch Number from the Search By drop-down list. Enter 3731596 in the Patch Number textbox.
4. Choose the appropriate platform and click Go.
5. In the results table select link 3731596, for the version 10.2.0.2.
6. Verify that the platform is correct on the next screen and click Download.
7. After downloading, stage this shiphome on the OMS.
For example, you may have a Windows-based OMS that manages PeopleSoft products running on HP or
AIX. In that event, you will want to stage the 10.2.0.2 HP and AIX agents on the Windows OMS such that you can later take advantage of the ability to do a mass deployment of the agent. See the agent installation section later in this document.
See Chapter 2, “Installing the PeopleSoft Environment Management Plug-in,” Installing the Management
Agent for the PeopleSoft Environment Management Plug-in, page 9.
See Oracle Enterprise Manager Downloads, http://www.oracle.com/technology/software/products/oem
/htdocs/agentsoft.html
/htdocs/agentdownload_script_readme.pdf
See Oracle E-Delivery, https://edelivery.oracle.com
See Oracle Enterprise Manager Installation and Basic Configuration http://download-west.oracle.com
/docs/cd/B16240_01/doc/nav/portal_booklist.htm
Use the information in the table below to plan which version of the software and which patch you need for your operating system platform:
6 Copyright © 2006, Oracle. All rights reserved.
Chapter 2
Installing the PeopleSoft Environment Management Plug-in
Operating System
Platform
Windows Server 2003
Red Hat Enterprise Linux
4.0 for x86
SuSE Enterprise Linux 9.0
for x86
HP-UX PA64 11.11/11.23
HP-UX IA64 11.23
Solaris 9 and Solaris 10
AIX 5.2 and AIX 5.3
OMS and Management
Repository
10.2.0.2 full release
Management Agent installed using Mass
Deployment Agent
(Recommended)
10.2.0.2
10.2.0.1 + 10.2.0.2 patch set 10.2.0.2
10.2.0.1 + 10.2.0.2 patch set 10.2.0.2
10.2.0.1 + 10.2.0.2 patch set 10.2.0.2
NA 10.2.0.2
10.2.0.1 + 10.2.0.2 patch set 10.2.0.2
10.2.0.1 + 10.2.0.2 patch set 10.2.0.2
Management Agent using interactive
Oracle Universal
Installer
10.2.0.2 Agent
10.2.0.1 Agent + 10.2.0.2
patch set
10.2.0.1 Agent + 10.2.0.2
patch set
10.2.0.1 Agent + 10.2.0.2
patch set
10.2.0.2
10.2.0.1 Agent + 10.2.0.2
patch set
10.2.0.1 Agent + 10.2.0.2
patch set
See Also
/B16240_01/doc/nav/portal_booklist.htm
Installing the PeopleSoft Environment Management
Plug-in to the Oracle Management Service
After you have installed Oracle Enterprise Manager, the Management Repository, and the Oracle Management
Service, you install the PeopleSoft extensions to the Oracle Management Service and Management Repository.
This phase uses Oracle Universal Installer to:
• Validate that the Oracle Management Service has stopped.
• Install PeopleSoft extensions to Oracle Management Service.
• Create custom schema components for the PeopleSoft Environment Management Plug-in within the
Management Repository.
• Install online help files and register them with Enterprise Manager.
• Automatically start the Oracle Management Service.
Copyright © 2006, Oracle. All rights reserved.
7
Installing the PeopleSoft Environment Management Plug-in
Chapter 2
Note. There is no process to uninstall (or de-install) the OMS-side components of the PeopleSoft
Environment Management Plug-in. If the installation process fails for any reason, you must manually run
PSEMDROPALL.sql
against the Management Repository before you can retry the installation. This SQL file has to be run from within SQLPLUS, and must be run against the EM Repository and not against the PeopleTools database. This script will delete all the PSEM schema elements from the EM Repository.
Any data that is stored in these tables prior to running PSEMDROPALL.sql will be lost. Please consult
SQLPLUS documentation for more information.
The PSEMDROPALL.sql file is located in the Oracle home directory of the Oracle Management Service:
$ORACLE_HOME/sysman/admin/emdrep/sql/psem/latest
Note. The PeopleSoft Environment Management Plug-in extensions that you install can be downloaded from
Oracle E-Delivery at the URL https://edelivery.oracle.com.
To install the PeopleSoft Environment Management Plug-in extensions into the Oracle Management Service:
1. Stop the Oracle Management Service using the following command:
$ORACLE_HOME/opmn/bin/opmnctl stopall
See http://download-west.oracle.com/docs/cd/B16240_01/doc/em.102/b16242/emctl.htm#sthref157
2. Run one of these commands:
• For Windows, select Start, Programs, OMS10g, Oracle Installation Products, Universal Installer.
• For all other platforms, open a command shell and change directory to the Oracle Home of the OMS.
Change directory to oui/bin, and execute the file runInstaller
.
3. Click Next on the Oracle Universal Installer welcome screen.
4. Click the Browse button and choose the file products.xml in the directory <INSTALL_DIRECTORY>
/Disk1/stage on the Specify Source Location window.
5. Click Next. The Select a Product to Install page appears.
6. Accept the default selection for installation for the Oracle Management Service Server.
7. Click Next to display the Specify Oracle Home Location screen.
8. Enter values for the following:
• Name: Select the Oracle HOME of the Oracle Management Service where the PeopleSoft
Environment Management Plug-in is to be installed. The default value is the first Oracle HOME
(alphabetically) that is stored in the inventory file.
• Path: The path for the Oracle HOME selected above will be populated in this drop-down. You need not change anything in this drop-down list.
9. The Specify Credentials screen appears. Enter a value for SYS password.
Enter the password value of the SYS user for the Management Repository that the Oracle Management
Service is connected to.
If the system does not accept the password, an error message appears with an OK button.
Click Help to launch the standard Oracle Help window that explains the error further. Click OK to return to the Specify Credentials screen to retry.
8 Copyright © 2006, Oracle. All rights reserved.
Chapter 2
Installing the PeopleSoft Environment Management Plug-in
10. Click Next to display the Summary screen.
11. Review the Summary screen to make sure it is correct.
12. Click Install to begin the installation.
A processing message screen appears followed by an End of Installation screen. Next, the Oracle
Management Service is automatically started.
Installing the Management Agent for the PeopleSoft
Environment Management Plug-in
This section discusses:
• Planning the Management Agent Installation
• Installing the Management Agent
Planning the Management Agent Installation
This section describes considerations about the installation of the Management Agent that could significantly affect the runtime operation of the PeopleSoft Environment Management Plug-in. Review and follow these guidelines based on whether you have Linux/UNIX or Windows platforms.
The following two sections discuss the:
• Management Agent and PeopleSoft installations performed by the same user. (Recommended)
• Management Agent installed by a different user than the user that installs PeopleSoft.
Note. Just before starting the installation of the EM Agent, make sure that the psconfig.sh script is not run from any <PS_HOME>. It is required that the psconfig.sh not be run in any shell that is used to start the
Enterprise Manager Agent. Please make sure that any of the profiles for the user do not source the file psconfig.sh or execute it in any other form.
Installations Done by the Same User
The recommended way to install the Management Agent is to have the same operating system user install both the Management Agent and the PeopleSoft installations, that is the <PS_HOME> directories.
This eliminates any potential issues involving:
• Permissions when the agent attempts to monitor or manage the PeopleSoft targets.
• The update of the Management Agent logs as you perform actions on PeopleSoft targets.
Installations Done by Different Users
Be aware that if you install the Management Agent on a system where you have already installed PeopleSoft components (Application Server, Process Scheduler, and so on), you must install the Management Agent from a user account that belongs to the same OS Groups that was used to install PeopleSoft. Otherwise, you cannot monitor the metrics that are generated by the PeopleSoft components.
UNIX and Linux platforms:
Copyright © 2006, Oracle. All rights reserved.
9
Installing the PeopleSoft Environment Management Plug-in
Chapter 2
It is important that the <PS_HOME> directories of the application server or other PeopleSoft components have a group read and group execute permission. Because the Management Agent user belongs to the same groups as the PeopleSoft user, the agent should be allowed to read and execute files within each <PS_HOME> that has a managed PeopleSoft component. This permission change will be handled by the Discovery process.
You do not need to manually make any permission changes at this time.
To see which group was used to install the application server, enter ls -l on the command line in the directory containing opmn.xml: <AS_ORACLE_HOME>/opmn/conf.
To see the groups to which you belong, type groups on the command line. You may be a member of several groups; however, it is not sufficient to be a member of the group used to install the PeopleSoft software—that group must be your current group.
To see which user group you are currently using, type id on the command line. Use the newgrp command to change to the group used to install the PeopleSoft software. Oracle recommends installing all software using a single group.
The user installing the Management Agent must have a UMASK of 022. In addition, make sure that the directory <AGENT_ORACLE_HOME>/sysman/log is group writable. When installing a 10.2.0.2 agent via the agent pull mechanism, this should be handled properly by the installer. If you are installing a 10.2.0.1 agent and then installing the 10.2.0.2 patchset for the agent, this may need to be manually set.
Consequently, anything that this user creates can be edited by all members of all groups to which this user belongs. After you have set up the UMASK, validate that the user installing the Management Agent and the user installing the PeopleSoft software are in the same group. Then, you may proceed with the agent installation.
Also, if the EM Agent and PeopleSoft software are installed as different users, it is recommended that the
PeopleSoft software not be installed under the user’s home directory.
Make sure that the parent directories of PS_HOMEs that are to be managed by this Plug-in have a group read and execute. This is applicable even if PeopleSoft is installed in a user’s home directory.
Windows platforms:
• The user installing PeopleSoft must be assigned Full Control for the agent’s <ORACLE_HOME> directory and subdirectories.
• The user installing the Management Agent must be assigned Full Control for all <PS_HOME> directories and their subdirectories.
Installing the Management Agent
There are a number of mechanisms available for installation of the agent. This section discusses the specific recommendations for installing the agent that have been evaluated for use with the PeopleSoft Environment
Management Plug-in. This section assumes that you have successfully installed a 10.2.0.2 Oracle Management
Service previously.
Refer to the Enterprise Manager documentation for information on how to stage an agent on the OMS.
/docs/html/B28832_01/toc.htm
10 Copyright © 2006, Oracle. All rights reserved.
Chapter 2
Installing the PeopleSoft Environment Management Plug-in
Note. The agent that is staged on the OMS by default will have the agent registration password in the response file as was entered when the OMS was secured. Thus when using the agent download mechanism for installing the agent, this password will be used for securing the agent. Optionally, it can be overridden by setting the
AGENT_INSTALL_PASSWORD environment variable. For the agent download kits which allow the staging of additional platform agents, the response file will not have the password. Thus, users must secure the agent by taking advantage of the AGENT_INSTALL_PASSWORD environment variable.
For Windows or HP-Itanium, the recommended methods are as follows:
• Install the agent using the interactive Oracle Universal Installer. (Recommended)
• Install the agent using the “Agent Download” or “pull” mechanism, which pulls the agent software from a staging area on the OMS and then runs the agent installer.
For information on the “Agent Download Installation,” see “Enterprise Manager Grid Control Installation and Basic Configuration” located at http://download-west.oracle.com/docs/cd/B16240_01/doc/nav/portal_ booklist.htm or http://www.oracle.com/technology/software/products/oem/htdocs/agentdownload_script_ readme.pdf.
You can also get additional information on the Agent Download or “Pull” mechanism in this location: http://<OMS_host>:<OMS_port>/agent_download/agent_install_readme.html
Note. Be aware that “Agent Download” requires the “wget” utility. Refer to the documentation listed above for additional details.
For Linux/UNIX, the recommended methods are:
• Install the agent using the “Agent Download” or “Pull” mechanism, which pulls the agent software from a staging area on the OMS and then runs the agent installer. (Recommended)
• For information on the “Agent Download Installation”, see “Enterprise Manager Grid Control Installation and Basic Configuration” located at http://download-west.oracle.com/docs/cd/B16240_01/doc/nav/portal_ booklist.htm or http://www.oracle.com/technology/software/products/oem/htdocs/agentdownload_script_ readme.pdf.
You can also get additional information about the Agent Download or “Pull” mechanism in this location: http://<OMS_host>:<OMS_port>/agent_download/agent_install_readme.html
• Install the 10.2.0.1 agent from the interactive Oracle Universal Installer. Then install the necessary patch to bring the agent to 10.2.0.2.
1. Navigate to the directory where you downloaded the file, p3731593_10202_<PLATFORM>.zip, where <PLATFORM> is the platform on which you are performing the install.
2. Unzip the zip file to a directory on the local machine, called $PATCH_UNZIP_DIR for purposes of this exercise.
3. cd $PATCH_UNZIP_DIR/3731593/Disk1.
4. Run the script runInstaller
.
For example, if you unzip the patch file to /home/oracle/EMGC/10.2.0.2/: cd /home/oracle/EMGC/10.2.0.2/ cd 3731593 cd Disk1
./runInstaller
Copyright © 2006, Oracle. All rights reserved.
11
Installing the PeopleSoft Environment Management Plug-in
Chapter 2
5. Choose the appropriate Agent from the list of ORACLE_HOMES to install 10.2.0.2 Patch to the
10.2.0.1 Oracle Enterprise Manager Agent.
Installing the PeopleSoft Environment Management
Plug-in to the Management Agent
This section discusses:
• Understanding the PeopleSoft Environment Management Plug-in Extensions Installation
• Installing the PeopleSoft Environment Management Plug-in Extensions
Understanding the PeopleSoft Environment Management
Plug-in Extensions Installation
Installing the PeopleSoft Environment Management Plug-in extensions to the Management Agent that will manage the PeopleSoft targets is the final step of the installation procedure.
There are two options for installing the extensions:
• Installing the extensions from the delivered media using the Oracle Universal Installer.
This copies the necessary files to the appropriate agent directories and configures the agent to run the
PeopleSoft Environment Management Plug-in
• Uploading a patch file to Enterprise Manager and deploying to agents with the patch mechanism.
Installing the PeopleSoft Environment Management
Plug-in Extensions
Use the Oracle Universal Installer and perform almost the same steps that you did to install the extensions to the Oracle Management Service.
See Chapter 2, “Installing the PeopleSoft Environment Management Plug-in,” Installing the PeopleSoft
Environment Management Plug-in to the Oracle Management Service, page 7.
1. Use the following command to stop the Oracle Agent: emctl stop agent
See http://download-west.oracle.com/docs/cd/B16240_01/doc/em.102/b16242/emctl.htm#sthref157
2. Depending on the platform, perform one of the following two actions:
• For Windows, select Start, Programs, Agent 10g, Oracle Installation Products, Universal Installer.
• For all other operating systems platforms, open a command shell and change directory to the
Oracle Home of the Agent.
Change directory to oui/bin, and execute the file runInstaller.
3. Click Next.
4. Click the Browse button and choose the file products.xml in the directory <INSTALL_DIRECTORY>
/Disk1/stage.
12 Copyright © 2006, Oracle. All rights reserved.
Chapter 2
Installing the PeopleSoft Environment Management Plug-in
The Oracle Universal Installer page appears followed by the Select a Product to Install screen.
5. Select the second option PeopleSoft Environment Management Plug-in (Agent) 8.48.0.1.0.
6. Click Next to display the Specify Oracle Home Location screen.
7. Enter the following:
• Name: Select the Oracle HOME of the Oracle Agent where the PeopleSoft Environment
Management Plug-in is to be installed.
• Path: The path for the Oracle HOME selected above will be populated in this drop-down list; you do not need to change anything in this drop-down.
8. Click Next to display the Summary screen.
9. Review the Summary screen to make sure it is correct.
10. Click Install to begin the installation.
11. A processing message screen appears followed by an End of Installation screen.
To install as a patch:
To install the PeopleSoft Environment Management Plug-in agent extensions as a patch, you’ll use a patch file and the Deployments page of Enterprise Manager.
Unzip the downloaded files to a location on the file system. Please make a note of that location.
1. From the Enterprise Manager home page, select the Deployments tab, and then click on the View
Patch Cache link.
2. Click the Upload Patch File button.
3. Click the Browse button and navigate to the directory where the installer was unzipped. Change directory to Disk1. Choose the file, 5016553.zip.
4. Enter a description.
5. Choose Oracle System Management Products as Product Family.
6. Click on the search icon (flashlight) next to Product and choose Intelligent Agent in the popup page.
7. Click the Select button.
8. Enter 10.2.0.2 as the Release, and choose Generic Platform from the Platform drop-down list.
9. Click the Upload button.
Enterprise Manager takes you to Deployments/General Page.
10. Highlight the row in the table with 5016553 as the Patch Number and click the Patch button.
11. Select Oracle Homes from the Destination Type drop-down.
12. Choose the Agents for which the PeopleSoft Environment Management Plug-in needs to be installed.
Please consult Enterprise Manager Documentation on how to patch Oracle Homes for more information.
west.oracle.com/docs/cd/B19306_01/em.102/b16241/Managing_Deployments.htm#BABFEEFC),
Copyright © 2006, Oracle. All rights reserved.
13
Installing the PeopleSoft Environment Management Plug-in
Chapter 2
Installing Patches
This section discusses:
• Installing PeopleSoft Environment Management Plug-in Patches for OMS
• Installing Patches for Management Agent
Installing PeopleSoft Environment Management
Plug-in Patches for OMS
Use the instructions in this section to download the patchset from the FTP site:
To download patches:
1. Log on to Metalink, https://metalink.oracle.com.
2. Select the Patches and Updates tab, and then select Advanced Search.
3. Click the flashlight icon beside the Product or Product Family textbox.
4. Enter Oracle System Management Products in the Search and Select window and click Go.
5. Select the link Oracle System Management Products Family from the results list.
6. Click the flashlight icon next to the Release box and choose the appropriate release.
7. Choose the appropriate platform and click Go to search for patches.
8. Choose the appropriate patch to be applied from the search results.
Double-click and download the patch in the next screen.
The steps to patch PSEM using the Patchset are identical to the steps required to install the PSEM OMS extensions. The process is identical to the initial install, as described earlier in this chapter.
See Chapter 2, “Installing the PeopleSoft Environment Management Plug-in,” Installing the PeopleSoft
Environment Management Plug-in to the Oracle Management Service, page 7.
Installing Patches for Management Agent
To download patches from the FTP site:
1. Log on to Metalink, https://metalink.oracle.com.
2. Select the Patches and Updates tab, and then select Advanced Search.
3. Click the flashlight icon beside the Product or Product Family textbox.
4. Enter Oracle System Management Products in the Search and Select window and click Go.
5. Select the link Oracle System Management Products Family from the results list.
6. Click the flashlight icon next to the Release box and choose the appropriate release.
7. Choose the appropriate platform and click Go to search for patches.
8. Choose the appropriate patch to be applied from the search results.
Double-click and download the patch in the next screen.
To install the patches:
14 Copyright © 2006, Oracle. All rights reserved.
Chapter 2
Installing the PeopleSoft Environment Management Plug-in
1. Log on to Enterprise Manager.
2. Navigate to the Deployments Tab.
3. Click on View Patch Cache.
4. Remove any patch files that are displayed in the grid with the Patch Number, 5016553.
5. Click Upload Patch file.
6. For Patch Number, enter 5016553, the number of the patch zip file that you downloaded.
7. Select PatchSet from the Patch Type drop-down list.
8. Navigate to the directory where the downloaded zip file was downloaded. Change directory to Disk1 and choose the file 5016553.zip.
9. Enter the following values for these parameters:
Product Family Oracle System Management Products
Product
Release
Enterprise Manager Grid Control or Intelligent Agent
10.2.0.2 or above as applicable
Platform Generic Platform
10. Enter comments and description if desired.
11. Upload the file.
Now this patch file can be applied to multiple Agents running on different platforms.
/docs/cd/B16240_01/doc/em.102/b16241/Managing_Deployments.htm#sthref505
You can install patches to the PeopleSoft Enterprise Manager Agent using the Enterprise Manager Patching mechanism.
To install patches using Enterprise Manager:
1. Navigate to the Deployments Tab
2. Click View Patch Cache.
3. Select the appropriate Patch and click the Patch button.
4. Select the targets from the left side of the list box and move them to the right side.
5. Click Next and provide the Credentials.
Use the user ID and password of the user that started the agent on the machine that you are going to patch.
6. Click Next and choose Stage Or Apply the patch.
7. Click Next and provide Schedule information on when the patch should be applied.
A summary screen appears that provides information about the Patch Job that is about to be submitted.
Make sure that all of the information is correct before submitting the job.
Copyright © 2006, Oracle. All rights reserved.
15
Installing the PeopleSoft Environment Management Plug-in
Chapter 2
Using the Enterprise Manager Grid Control Console
This section discusses:
• Using Grid Control for the First Time
• Creating a Super Administrator Account
Using Enterprise Manager Grid Control for the First Time
The Enterprise Manager Grid Control Console provides support for creating and managing Enterprise Manager administrator accounts. The Enterprise Manager administrators you create and manage in the Enterprise
Manager Grid Control Console are granted privileges and roles to log in to the Enterprise Manager Grid
Control Console and to manage specific target types and to perform specific management tasks.
During installation, these tasks are performed automatically:
• A default Super Administrator SYSMAN account is created with the password you specified.
• The SYSMAN account is automatically configured to receive email notifications, if you provided the email notification settings at installation time.
Email notifications are set up with default Notification Rules for the critical conditions.
After installation, you can immediately log in to the Enterprise Manager Grid Control Console with the
SYSMAN username and your password to perform management tasks. The next step is to create a new Super
Administrator account to monitor and manage the PeopleSoft targets.
Note. The SYSMAN account owns the database schema containing the Management Repository and should
not be used after the initial log in.
See http://download-west.oracle.com/docs/cd/B16240_01/doc/em.102/b16228/getting_started_with_
enterprise_manager.htm#CHDDGHAF
To access Enterprise Manager Grid Control, use one of the following URLs to log in to the Grid Control
Console: http://<Oracle Management Service_hostname>.<domain>:<port>/em or https://<Oracle Management Service_hostname>.<domain>:<port>/em
For example, http://machine_host.bigcompany.com:1159/em
Creating a Super Administrator Account
To create a new Super Administrator account:
Note. Enterprise Manager’s online help has detailed instructions for creating administrator accounts. Access the Setting Up Enterprise Manager directory of the online help.
1. Click Setup (in upper right-hand part of the page) from any Enterprise Manager Grid Control page.
2. In the left-hand column of the page, click Administrators.
The Enterprise Manager Configuration, Administrators page appears.
16 Copyright © 2006, Oracle. All rights reserved.
Chapter 2
Installing the PeopleSoft Environment Management Plug-in
3. Click Create.
The Create Administrator: Properties page appears.
a.
Enter information in the required fields.
b.
Select the Super Administrator check box.
Click Next.
c.
The Create Administrator <name>: Review page appears.
Click Finish.
Copyright © 2006, Oracle. All rights reserved.
17
Installing the PeopleSoft Environment Management Plug-in
Chapter 2
18 Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
3
Understanding the PeopleSoft Environment
Management Plug-in
This chapter discusses:
• PeopleSoft Environment Management Plug-in overview
• PeopleSoft Environment Management Plug-in features
• PeopleSoft target types
• The discovery process
• Enterprise Manager Grid Control Console
• PeopleSoft Environment Management Plug-in pages
• Target homepages
• Target administration
PeopleSoft Environment Management Plug-in Overview
The PeopleSoft Environment Management Plug-in uses Oracle Enterprise Manager to provide an integrated, graphical user interface for monitoring and managing components of a PeopleSoft environment.
The entities that Enterprise Manager monitors and manages are called managed targets—separately manageable and named entities within the enterprise; for example, databases, application servers, web servers, and so on.
The Oracle Enterprise Manager product includes the Management Agent, Oracle Management Service,
Management Repository Database, and the Grid Control Console, which is a browser-based central console through which administrators can perform monitoring, administration, and configuration tasks for the enterprise.
Common Terms Used in This Book
Administrator Account
Alerts
Administrator accounts provide users permission to perform administrative tasks and access administrative information. You can set up each administrator account to have its own roles, privileges, and notification rules. There are two types of administrator accounts: Super Administrator and Administrator.
Indicates a potential problem; either a warning or critical threshold for a monitored metric has been crossed. An alert can also be generated for various target availability states. Enterprise Manager provides various options to respond to alerts. Administrators can be automatically notified when an
Copyright © 2006, Oracle. All rights reserved.
19
Understanding the PeopleSoft Environment Management Plug-in
Chapter 3
Beacon
Dashboard
Discovery Process
Enterprise Manager Grid
Control Console
Management Agent
Management Repository
Oracle Management
Service
PeopleSoft System
PeopleSoft Global Unique
Identifier (GUID)
Policies
Preferred Credentials alert triggers and can set up corrective actions to resolve an alert condition automatically.
A special target installed on an agent that runs a defined service test and reports the results to the Oracle Management Service to determine the status and performance of a service.
Presents information using intuitive icons and graphics that let you spot recent changes and quickly identify and respond to problems.
The process of identifying and registering targets in Enterprise Manager so that they can be monitored and managed from the Enterprise Manager console.
Targets are discovered one host at a time.
The Oracle Enterprise Manager web-based user interface for centrally managing the entire PeopleSoft computing environment. It can be accessed from a client workstation that meets the minimum client requirements of the
Enterprise Manager.
A process deployed as binaries on each of the monitored hosts. It is responsible for monitoring all targets in the host, communicating the information to the middle-tier management service, and managing and maintaining the host and its targets.
This is an Oracle database that contains all the available information about administrators, targets, and applications managed within Enterprise Manager.
Captured data is uploaded to the repository through the Oracle Management
Service. The Repository organizes the data and makes it available for data retrieval—allowing the data to be shared between any administrators accessing the Grid Control Console.
A web application (J2EE-compliant) that renders the user interface for the Oracle Enterprise Manager Grid Control Console. It works with all management agents to process monitoring and job information, and uses the Management Repository as its data store. The Oracle Management
Service resides in the layer above an Oracle Application Server (OAS).
Therefore, when the Oracle Management Service is installed, it also installs the application server.
A group of targets that are associated with one PeopleSoft application database.
A unique identifier that ties each target together and defines it as a system. The
GUID is generated and resides at the database layer. During the discovery process, the application server connects to the PeopleSoft application database and retrieves the GUID. This value is derived from the PSOPTIONS table.
Define the desired behavior or characteristics of systems. By using preconfigured or custom policies, automated assessments of systems and applications are performed. Through alerts, you are notified of any deviations, such as inappropriate settings or incorrect system configurations.
Simplify access to managed targets by storing target login credentials in the
Management Repository. With preferred credentials set, users can access a target that recognizes those credentials without being prompted to log in to the target’s host machine. Preferred credentials are set on a per user per target basis, thus ensuring the security of the environment.
20 Copyright © 2006, Oracle. All rights reserved.
Chapter 3
Roles
Service
System
Super Administrator
Account
Topology Viewer
Understanding the PeopleSoft Environment Management Plug-in
Enable you to group Enterprise Manager system and target privileges, and grant these to administrators or to other roles. Privileges give the administrator rights to perform management actions within Enterprise Manager. Creating roles is an easy way to grant a predefined set of privileges to a group of administrators. If you change a role, the changes are automatically propagated to all administrators who are assigned that role.
An entity that models a business process or application. Examples of services are CRM applications, online banking, and email services. You can define services by creating one or more service tests that simulate common end-user functions. Using these service tests, you can measure the performance and availability of critical business functions, receive alerts when there is a problem, identify common issues, and diagnose causes of failures.
A set of targets (hosts, databases, application servers, and so on) that function together to host one or more applications or services.
Can manage all other administrator accounts and set up all administrator credentials. In addition, the super administrator can:
• Create privileges and roles.
• Perform the initial setup of Enterprise Manager.
• Add targets to Enterprise Manager.
• Perform actions on targets in the system.
Note. Enterprise Manager is installed with a default super administrator account named SYSMAN. You use the SYSMAN account for the initial login to Enterprise Manager. Then, create new super administrator accounts as needed in your system.
Enables you to view the relationships between targets within the context of a system. You can perform some management actions from this view.
Features of the PeopleSoft Environment Management Plug-in
The PeopleSoft Environment Management Plug-in:
• Discovers and registers PeopleSoft targets.
• Monitors and manages PeopleSoft targets, including actions such as start, stop, configure, and other specific tasks relevant to each target type.
• Displays configuration data in a graphical user interface that is driven by metadata.
This ensures that you enter appropriate values and helps limit potential errors in configuration.
• Provides log management for PeopleSoft targets, including the ability to search, view, export, and purge log files.
• Creates a PeopleSoft system in Enterprise Manager.
This enables you to see how all the targets in the system are related to the PeopleSoft application database.
• Generates a graphical topology that displays the relationships between targets.
Copyright © 2006, Oracle. All rights reserved.
21
Understanding the PeopleSoft Environment Management Plug-in
Chapter 3
You can execute selected actions on targets from this view.
• Creates a service that simulates a transaction, such as login and logout, to monitor the availability of an application.
Using the Enterprise Manager Service Level Monitoring feature, you can also check the availability of a system or a feature of an application.
The PeopleSoft Environment Management Plug-in delivers a login and logout transaction service for a PeopleSoft system.
• Provides custom policies to evaluate configuration data for PeopleSoft target types.
PeopleSoft Target Types
PeopleSoft-specific target types allow monitoring and management of a PeopleSoft environment. They are:
PS Application Database
(PS App DB)
PS Application Server
Domain
Refers to the PeopleSoft application database—and contains a PeopleSoft application such as CRM or HCM. There can only be one PeopleSoft application for each installed application database.
Key target type of a PeopleSoft environment. It does all of the complex logic and computations and builds the contents that the web server uses to display pages.
PS Process Scheduler
Domain
PS PIA
Enables batch job processing.
Allows Enterprise Manager to manage the PIA component. It corresponds to a Web domain in Weblogic, server in WebSphere, and application/OC4J in
OAS. This target type contains one or more PS Web Site targets.
PS Web Site Comprises the specific web application and its corresponding HTML files, image files and resource files; it also includes configurations and page content.
PS Web Site targets always belong to a PS PIA target.
PS Search Server Domain Refers to a remote server that allows application servers, which are on platforms that do not support Verity, to perform Verity search functions.
The Discovery Process
Discovery is the process of searching for and registering PeopleSoft targets so that Enterprise Manager can monitor and manage them. It is the first step to be performed after you have installed all of the required software.
During this process, you use a series of Enterprise Manager screens to:
• Select the target types to be discovered.
• Enter credentials so that Enterprise Manager has access to the host where discovery is to be performed.
• Register the discovered targets in Enterprise Manager.
22 Copyright © 2006, Oracle. All rights reserved.
Chapter 3
Understanding the PeopleSoft Environment Management Plug-in
• Set environment variables needed to connect to the PeopleSoft application database.
• Identify and register the associated application database.
• Review the registered targets.
See Chapter 4, “Discovering PeopleSoft Targets ,” Registering Targets , page 42.
Enterprise Manager Grid Control Console
This section discusses:
• The initial use of Enterprise Manager Grid Control Console.
• How to access Enterprise Manager Grid Control Console.
Initial Use of Enterprise Manager Grid Control Console
The Enterprise Manager Grid Control Console provides support for creating and managing Enterprise Manager administrator accounts. The accounts that you create and manage in the console are granted privileges and roles to log in to the console and to manage specific target types and to perform specific management tasks.
During its installation, the Enterprise Manager performs the following tasks:
• A default Super Administrator (SYSMAN) account is created with the password you specified.
• The SYSMAN account is automatically configured to receive email notifications, if you provided the email notification settings during installation.
After installation, you can immediately log in to the Enterprise Manager Grid Control Console with the
SYSMAN user name and your password (set during Oracle Management Service installation) to perform management tasks. The next step is to create a new Super Administrator account to monitor and manage the PeopleSoft targets.
Note. The SYSMAN account owns the database schema containing the Management Repository and should not be used after the initial log in.
Accessing Enterprise Manager Grid Control Console
Use the following URL to log in to the Grid Control Console: http://<Oracle Management Service_ hostname>.<domain>:<port>/em or https://<Oracle Management Service_hostname>.<domain>:<port>/em
For example, https://machine.domain.com:1159/em
Super Administrator Accounts
To create a new super administrator account:
1. Click Setup (in the upper right-hand part of the page) from any Enterprise Manager Grid Control page.
2. In the left-hand column of the page, click Administrators.
The Enterprise Manager Configuration, Administrators page appears.
3. Click Create.
Copyright © 2006, Oracle. All rights reserved.
23
Understanding the PeopleSoft Environment Management Plug-in
Chapter 3
The Create Administrator: Properties page appears.
4. Enter information in the required fields.
5. Select the Super Administrator check box.
6. Click Next.
The Create Administrator <name>: Review page appears.
7. Click Finish.
Note. Enterprise Manager’s online help has detailed instructions for creating administrator accounts (Setting
Up Enterprise Manager section).
PeopleSoft Environment Management Plug-in Pages
This section discusses:
• The Enterprise Manager homepage
• The Targets tab
• The PeopleSoft subtab
• Target homepages
• Target administration pages
The Enterprise Manager Homepage
The Enterprise Manager homepage gives you an at-a-glance view of the overall status of all the targets being monitored. It summarizes key monitoring areas such as availability across all managed targets, open alerts, policy violations, and recent problems with job executions. Links on this page enable you to drill down to access detailed performance information.
The homepage is the first page that appears when you log on to Enterprise Manager.
24 Copyright © 2006, Oracle. All rights reserved.
Chapter 3
Understanding the PeopleSoft Environment Management Plug-in
Enterprise Manager Grid Control Console homepage
The Targets Tab
Select Targets to display a row of subtabs that further define targets by type, such as hosts, databases, application servers, and so on.
The PeopleSoft subtab is on the far right-hand side of the screen. (Tabs can be reordered in Preferences,
Target Subtabs):
Copyright © 2006, Oracle. All rights reserved.
25
Understanding the PeopleSoft Environment Management Plug-in
Chapter 3
Targets tab, Hosts subtab page
The PeopleSoft Subtab
This subtab provides the starting point for discovering and accessing PeopleSoft targets.
Select Targets, PeopleSoft to display a page listing all of the PeopleSoft targets discovered and registered in
Enterprise Manager and a summary of their respective statuses. You can filter the view so that only specific target types are shown.
The target types that display depend on the access rights or privileges that have been set for the user.
26
PeopleSoft subtab page
You can initiate the discovery process from this page by selecting Add PeopleSoft Targets.
Copyright © 2006, Oracle. All rights reserved.
Chapter 3
Understanding the PeopleSoft Environment Management Plug-in
From the PeopleSoft page, you can create domains for the PS Application Server, PS Search Server, and PS
Process Scheduler targets. You can also remove targets registered in Enterprise Manager. Removing a target from Enterprise Manager does not delete it from its managed host.
If PS PIA or PS Web Sites are related and you want to remove them from Enterprise Manager, Oracle recommends that you remove them together to avoid status and functional inconsistencies.
Note. The create domain option on this page is equivalent to the Create Domain menu in the PSADMIN utility.
Target Homepages
This section describes the fields or links that appear on PeopleSoft target homepages. Not all elements will appear on every target homepage.
Common Elements on Homepages
General
Status
Start
Stop
Blackout
Availability % (availability percentage)
Services Impacted
Features
Alerts and Host Alerts
Related Links
Area that shows the general status of the target in terms of availability, CPU usage, memory usage and so on. If the host contains more than one CPU, CPU usage the value shown is the cumulative usage of all the CPUs.
When relevant, this region also lists the related PS Application Database, PS
Search Server, system, and host. Links that appear enable you to open either another page for more information or to access the page listed.
Indicates the target’s availability.
Select to start the target.
Select to stop the target.
See Enterprise PeopleSoft PeopleTools 8.48: System and Server
Administration.
Select to manage or create a blackout for the target.
Shows the percentage of time, excluding any blackouts, that the target has been available since it was registered in Enterprise Manager.
Shows the number of services that are impacted by the failure. (Displays only if a service is associated with the target and if the target’s status is down because of a service failure).
(PS Application Server Domain and PS Process Scheduler Domain targets only). Area that displays all of the PeopleSoft features available for the domain such as Quick Server, PUBSUB, Master Process Scheduler, and so on. This list appears only after the target’s configuration data is saved in
Enterprise Manager.
Area that lists any alerts that have been generated. When a metric threshold value is reached, an alert is generated. The most recent alerts are listed first. You can change the sorting by clicking the appropriate column header.
By clicking a specific alert message, you can drill down to explicit details about the metric in alert.
Area that lists all of the related links appearing on target homepages. Not all links will appear on every target homepage.
Copyright © 2006, Oracle. All rights reserved.
27
Understanding the PeopleSoft Environment Management Plug-in
Chapter 3
Policy Violations Violations listed here reflect configuration issues that Enterprise Manager has detected. Click the links in this region to view the Policy Violations page where details about the violation appear.
Monitoring Configuration Displays target properties such as domain name, PS_HOME, and PeopleTools version.
Note. Do not change these values unless instructed by technical support.
Alert History
Access
All Metrics
Blackouts
Displays a complete alert history of the target.
Displays access type and the privilege associated with the target.
Shows all of the metrics defined for the target.
Target Properties Shows target properties such as line of business, location, and contact.
Metric and Policy Settings Displays the metric thresholds and policies defined for the domain.
Reports
Displays the blackouts that have been defined for the target history. You can also set up a blackout from this page.
Open Telnet Session
Displays standard Enterprise Manager reports available for the target.
Enables the user to open an ad hoc telnet session to the host of the target.
(Appears only if the host of the target is UNIX-based).
Policies The PeopleSoft Environment Management Plug-in delivers policies and any deviations to your systems or applications are reported. Examples of deviations include inappropriate settings and incorrect system configurations.
Target Administration Pages
This section describes the links that appear on PeopleSoft target administration pages. Not all elements will appear on every target administration page.
Common Elements on Administration Pages
Configure Domain Opens the Configure Domain page where an administrator can edit domain configurations and save the changes.
See Enterprise PeopleSoft PeopleTools 8.48: System and Server
Administration
• If this domain is up and the allow dynamic changes property is selected, only dynamic fields can be edited. All others are disabled.
• If this domain is down, all fields are enabled.
From the Configure Domain page, you can select Configure Environment
Variables to edit settings that establish the connection from the domain to the application database. Depending on the database type of the domain, there are default required environment settings shown. However, you must enter the values.
28 Copyright © 2006, Oracle. All rights reserved.
Chapter 3
Understanding the PeopleSoft Environment Management Plug-in
• Configuration details region.
- Move the mouse over the information icon to display a description of the field.
- If the dynamic icon is present, it means that the field is dynamic and a restart of the domain is not necessary if there were changes (and if the allow dynamic changes option is set).
- Enable check boxes display for some fields to accommodate any commented out properties within the configuration files. If desired, you can enable the commented out properties by selecting the check box.
Note. Refer to the section describing the importance of setting environment variables correctly.
Create Like Domain
See Chapter 4, “Discovering PeopleSoft Targets ,” Setting Environment
Equivalent to the Import Domain from another PS Application Server Domain or PS Process Scheduler Domain in the PeopleTools administration utility.
You can create a like domain only within the same host and PS_HOME.
Compares one domain configuration to another domain configuration.
Compare Domain
Configurations
Compare to Multiple
Configurations (Jobs)
Last Collected
Configuration
Compares one domain to two or more other domains or snapshots of saved domain configurations.
Displays the latest configuration data gathered from the target. For example, if the target is an application server, this page shows its configuration properties collected from the psappsrv.cfg (Configuration tab) and psappsrv.ubx (Features tab) files and stored in the Management Repository.
You can also select to save, compare, compare multiple options, and refresh.
• Save saves a copy of the configuration in the Management Repository. This may be retrieved later on using the View Saved Configurations link.
• Refresh enables you to request an on-demand configuration collection.
Configuration collection values display after a refresh.
View Saved Configurations Enables you to retrieve previously saved configurations. Saving a configuration snapshot is done from the Last Collected Configuration page.
History Enables you to view a historical log of configuration changes to the target. The
Category field defaults to the target type from which the link was invoked, in this case the application server.
Copy Configurations Copies configuration files from one existing domain to other domains within the same host. To make the changes effective, you must select the Configure
Domain action in the target domains after the configuration copy. This overwrites the configuration files on the managed host.
Note. This feature does not work on domains that are up.
Copyright © 2006, Oracle. All rights reserved.
29
Understanding the PeopleSoft Environment Management Plug-in
Start Domain
Start Domain (Parallel)
Stop Domain
Stop Domain (Forced)
Purge/Archive Cache
Delete Domain
Messaging Server
Chapter 3
Starts the domain serially. This is the usual start process from the PeopleSoft administration utility.
Note. If needed, you can abort the start process from the processing page.
This option initiates the start for all processes at the same time, which speeds up the boot up process. To view the status of this start, click the Process
Status link on the Administration tab.
This action shuts down the domain gracefully and is equivalent to the normal stop domain process in the PeopleSoft administration utility.
Note. If needed, you can abort the start process from the processing page.
Initiates a forced shutdown of the domain. This is useful for aborting processes that hang.
Enables you to purge and archive (optional) the server cache files of a domain.
The domain does not need to be down.
If you select Archive, enter the archive location. The default archive directory is %PS_HOME%/<domain>/archive. Ensure you have the fully qualified directory name; if the directory does not exist, the archive process will try to create it.
Note. If the domain is up, the output includes the Tuxedo boot process output for each application server process because this forces a restart of each application server process to remove memory cache.
Sharing violation errors may occur on Windows machines during the file copy to the archive directory. These are normal.
The domain must be down before you can initiate a delete action. Selecting this action physically deletes the domain on the host and removes it from
Enterprise Manager.
(Link not available if the domain was created using the developer template.)
Enables you to create dedicated publication and subscription (PUBSUB) servers for certain messaging queues. An administrator uses this feature if there are high volumes of messages for certain channels or queues, and there is a requirement for prioritization of messages.
Full target privileges are required to create, configure, and delete messaging queues.
When you click the Messaging Server link, the Messaging Server
Administration page appears showing a summary of all messaging servers that were previously created. From this view, you can select a messaging server and remove or reconfigure it, or create a new messaging server.
To create a messaging server, click Create. You are prompted for a messaging server name, messaging type (Publication Broker, Publication Contractor or
Subscription Contractor), and at least one messaging queue.
A unique messaging queue name is required for queues of the same type across different messaging servers.
30 Copyright © 2006, Oracle. All rights reserved.
Chapter 3
Understanding the PeopleSoft Environment Management Plug-in
Preload File Cache
Clean IPC resources
Access Tuxedo Command
Line (TMADMIN)
Process Status
Client Status
Queue Status
Execute Host Command
Windows Services
Management
For changes to take effect, you must configure and restart the domain.
Enables you to preload server cache to the domain in order to achieve better performance in the application. The domain must be down and there must be a configured project file in the PreloadFileCache setting of the configuration file before performing this action.
Enables you to free memory by cleaning IPC resources that may still be resident in the memory. This action requires the domain to be down; if not, the domain will be shut down.
Enables you to execute certain Tuxedo commands in the Enterprise Manager agent. The Access Tuxedo Command Line page appears with a free text field where you can enter commands. Click Execute to initiate the command. The results display in the scrollable region below the command field. If needed, you can abort this process.
Shows the status of each process running within the PS Application Server, PS
Process Scheduler, and PS Search Server Domains. This feature includes a
View Status drop-down list that enables you to refresh the data being displayed either manually, every 30 seconds; every minute or every 5 minutes. This is equivalent to server status in the PeopleSoft administration utility.
Displays the status, user name, and workstation name of all clients that are connected to the PS Application Server Domain or PS Search Server
Domain. From this view, you can monitor the users connecting to your application server domain.
Shows the number of requests queued for each PS Application Server process,
PS Process Scheduler process, and PS Search Server process. This data helps determine whether more handlers need to be started to accommodate a large backlog or queued requests.
Allows for the use of customized scripts that help manage PeopleSoft environments. Any type of shell or batch script is supported.
Enter the path, script name and parameters in the Command text box, then click Execute. The output of the script is shown in the Output text box.
(Available only if the host operating system of the application server or
Process Scheduler is Windows.) Enables you to configure and install a
Windows service that can start and stop your application servers and Process
Scheduler servers.
If selected, a Configure Windows Services page appears. You can edit the service for Service Start Delay.
A table displays that lists application servers and Process Schedulers that can be started from the Windows Service. You can add to or delete from this list.
After adding the domains, you can click one of these:
• Save: To save the configuration changes to the psntsrv.cfg file.
• Save & Install: To save the configuration changes to the psntsrv.cfg file and install the windows service at the same time.
• Delete: To delete the Windows service.
• Cancel: To return you to the Administration page without any further action.
Copyright © 2006, Oracle. All rights reserved.
31
Understanding the PeopleSoft Environment Management Plug-in
Chapter 3
Edit setEnv/ server.xml/ opmn.xml
Start PIA
Stop PIA
Weblogic
Console/WebSphere
Administration
Console/(iAS) Console
Edit web.xml
Customize Start/Stop
Scripts
Configure Site
Click the link to access the file in text format using Enterprise Manager’s
Remote File Editor. Filenames depend on the web server type.
The most common configuration adjusted in these files is the JVM heap size that is being used by PIA.
• Weblogic: setEnv.sh/setEnv.cmd
• WebSphere: server.xml
• OAS: opmn.xml
Click Save to have changes made to the file saved directly to the managed host. You can also select the Export to File feature. You must restart PIA for these changes to take effect.
Executes the delivered PeopleSoft start script unless you have a predefined custom script.
Note. Starting an OAS web server depends on the services managed by the
Oracle Process Monitor (OPMN), which include an HTTP server service and the JVMs that host the PeopleSoft applications. These services are managed separately in Enterprise Manager. The OPMN and HTTP server services must be started to access and manage PIA.
Brings down the PS PIA target using either the delivered or a predefined custom PeopleSoft stop script.
The link available depends on the type of web server installed. This URL link must be defined in the PeopleSoft System URL Setup link in a PeopleSoft
System homepage.
See Chapter 10, “PeopleSoft Systems and Services,” PeopleSoft System
Launches the Enterprise Manager Remote File Editor to display the web.xml
file. You can edit the file in text format, then save the changes. Also, you can export the configuration file to your local machine. However, changes made to web.xml are not available in the Enterprise Manager configuration management historical changes.
Enables users to change the startup and shutdown scripts used for each PS
PIA target.
Click this link to display a page to add or remove custom scripts. To add a script, select a file to search for or enter the path and filename in the field.
Only one pair of start and stop scripts may be added.
To revert to the PeopleSoft delivered scripts, delete the custom scripts.
Enables you to edit and save changes to your site configuration. The changes are saved to the configuration.properties file in the host.
Click Save to save your changes to the file.
You can configure PS Web Sites even when the site is running. However, you must restart PIA for configuration changes to take effect.
32 Copyright © 2006, Oracle. All rights reserved.
Chapter 3
Web Profile
Integration Broker
PIA Signon
Understanding the PeopleSoft Environment Management Plug-in
Opens a new browser window that accesses the Web Profile page in the
PeopleSoft application. The URL for the Web Profile must be predefined in the PeopleSoft System URL page.
See Chapter 7, “PS Process Scheduler Domain Targets ,” Managing a Process
Opens a new browser window for the Integration Broker page in the
PeopleSoft application. The URL must be predefined in the PeopleSoft
System URL Systems page.
Enables you to test the availability of PIA signon page and the PeopleSoft application as a whole. The URL for PIA Signon must be predefined in the PeopleSoft System URL page.
Target Log Management
The PeopleSoft Enterprise Management Plug-in log feature enables you to view PeopleSoft specific logs, traces or dumps for a target. Host credentials are required for this page to display.
Select Targets, PeopleSoft, <a target>, Logs. The Log page of the target type you selected appears. For example, if your target is a PS Application Server target, the PS Application Server Log page appears:
Copyright © 2006, Oracle. All rights reserved.
33
Understanding the PeopleSoft Environment Management Plug-in
Chapter 3
34
PS Application Server Domain Log page
Select the Logs tab to display the Log Management page where you can view application logs and select other available features.
Copyright © 2006, Oracle. All rights reserved.
Chapter 3
Understanding the PeopleSoft Environment Management Plug-in
Note. CORE files cannot be viewed, exported locally, or searched against.
Viewing a Log File
To view a log file, click the log filename. The View Log File page appears.
View Log File page
If you have searched for a string, you can also click the link by the line number or the string (in the results area) to display the View Log File page.
The initial view contains 500 lines and the string is the last one shown. Click Previous, Next, Top, or Bottom to navigate through the file.
The log filename is also available within the search results area.
Click Refresh to refresh the screen.
Exporting a Log File
To export the log file to your workstation, click Export to File on the View Log File page. Click OK to go back to the Log Management page.
Searching for Strings in a Log File
To search for a string in a log file, enter the desired search settings and click Search. When the string is found, the Log Management page appears with the results displayed in the lower part of the page. If needed, you can narrow the search criteria.
Copyright © 2006, Oracle. All rights reserved.
35
Understanding the PeopleSoft Environment Management Plug-in
Chapter 3
The log information displayed includes the line number in the log file in which the string is found, the date and time, the server process involved, and the phrase or sentence containing the string.
Host Log Alert Settings
To set a log alert, select Host, then Metric and Policy Setting in the Related Links region. From the Metric list, select Log File Pattern Matched Line Count and click Advanced Setting to adjust the patterns to be searched and their thresholds.
View the results by selecting Log File Alerts in the Related Links region in the homepage of the target’s host.
Log Management Setup
The log management feature enables you to view PeopleSoft specific logs, traces or dumps for a target.
You can also:
• Customize the type of log file patterns to manage.
• Schedule purge and archive of log files.
Click Log Management Setup in the Related Links region to display the Log Management Setup page where you can define the log file type to manage for each target. From this page you can also schedule purge and archive jobs.
36 Copyright © 2006, Oracle. All rights reserved.
Chapter 3
Understanding the PeopleSoft Environment Management Plug-in
Log Management Setup page
Schedule Purge and Archive Jobs
To set up the schedule for a purge, click Schedule Purge and Archive Job. The Create PS Purge Archive Log Job page appears. From this page you can define the log patterns you want to purge, or archive and set a schedule.
General
Parameters
Enter a name and description for the job. The targets available for a scheduled purge or archive are listed in the Targets region.
Displays all of the log patterns being managed for a target. Select which log patterns to purge or archive.
The retention period is the length of time that the log file should be saved before being archived or purged. The default for purge is 7 days.
The remaining job options are standard Enterprise Manager features.
Copyright © 2006, Oracle. All rights reserved.
37
Understanding the PeopleSoft Environment Management Plug-in
Chapter 3
38 Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
4
Discovering PeopleSoft Targets
This section provides an overview and discusses how to:
• Add PeopleSoft targets
• Register targets
Understanding the Discovery Process
Discovery is the process of an agent identifying predefined target types, registering them in Enterprise
Manager, and collecting their target properties and initial configuration data. The agent sends this data to the
Oracle Management Service, which processes the data and loads it into the Management Repository. From there, Enterprise Manager can access data about the target to monitor and manage it.
Note. Discovery requires that you be assigned the role of a super administrator.
The following steps outline how to initiate the discovery of PeopleSoft targets:
• From the PeopleSoft subtab page, click Add PeopleSoft Targets, select the target types to be discovered.
Specify the host, discovery path for PS_HOMEs, and subdirectory crawl depth.
• From the Target Credentials page, enter the user ID and password for the host where discovery executes.
• After discovery, register the specific target in Enterprise Manager.
• Set environment variables for platforms requiring them, and add a PeopleSoft application database
(discovering a PS Application Database target).
See Chapter 4, “Discovering PeopleSoft Targets ,” Registering Targets , page 42.
Adding PeopleSoft Targets
To begin discovery, select Targets, PeopleSoft. Click Add PeopleSoft Targets. The Add PeopleSoft Targets page appears:
Copyright © 2006, Oracle. All rights reserved.
39
Discovering PeopleSoft Targets
Chapter 4
40
Add PeopleSoft Targets page
From this page, you can select one or more target types for discovery within one host.
If you want to search for a host from which to discover targets, click the Host search icon to display the
Select Host for Discovery page.
Select the appropriate host and click Select. Enter the remaining values on the Add PeopleSoft Targets page.
Note. The first discovery process should be run on a host containing any of the Tuxedo domain targets, which are PS Application Server, PS Process Scheduler, and PS Search Server Domains. The host should have the same timezone as the PS Application Database to which it’s connected, and the same timezone of most of the other PeopleSoft servers or hosts. During this initial discovery, the system expects that the PS
Application Database will be also be discovered.
The PeopleSoft Enterprise Manager Plug-in can monitor only PS Application Databases from Tuxedo domain targets that are in the same timezone. When the database is registered in Enterprise Manager, it must be the database of most of the Tuxedo domain targets.
Say you have a PeopleSoft environment with 4 UNIX servers with PS Application Server domains in the
US/Pacific timezone and 1 Windows 2003 server with a Process Scheduler domain in the America/Los
Angeles timezone. You should execute the first discovery on one of the 4 UNIX servers (assuming that the PS
Application Server Domains are configured so that the PS Application Database can be discovered with its configuration (meaning that they are fully configured in psappsrv.cfg and can connect to a valid database).
You should not execute the discovery first on the Windows 2003 server.
PeopleSoft Target Types
PS Target Types
Host
All target types are selected by default. The PS_HOME target check box cannot be cleared because Enterprise Manager must discover it first. When the PS_HOME directory is found, the search continues for any PeopleSoft targets present (for example, an application server, web server, Process
Scheduler, and so on).
A PS Web Site cannot be registered without a parent PS PIA target having been registered in a current or a previous discovery process.
Select the host in which the target you want to discover reside.
Copyright © 2006, Oracle. All rights reserved.
Chapter 4
Discovering PeopleSoft Targets
Note. The list of host values only displays when Enterprise Manager agents have been installed and have been registered with the OMS.
Discovery Path
By default, only hosts that have PeopleSoft installations are available. The system verifies that you have entered a valid host.
Enter the paths from which the search (crawl) for PS_HOMEs should begin.
Separate multiple paths with a semicolon.
Note. When discovering PS PIA and PS Web Site targets in OAS, Enterprise
Manager searches the directory structure of any existing OAS targets.
Crawl Depth
Modify OS Group
Permissions of PS_HOMEs
Specify the number of nested directories that an agent crawls during the discovery process. The default is 5. Crawl depth applies to each directory entered.
For example, if you specify a value of 3 and have more than one discovery path listed, the agent searches 3 levels in each directory.
Allows the group of PS_HOMEs’ user ID to read, write and execute permissions on all the PS_HOMEs that will be discovered. (Disabled in
Windows).
• When the check box is selected, Enterprise Manager modifies the file system permission on discovered PS_HOMEs to:
- User: read, write and execute
- Group: read and execute
- Other: read
- UNIX: terms 754
• When the check box is not selected, a script is created in the
<PS_HOME>/psem/permission.sh directory so that a system administrator can run the script manually.
Note. If you do not set the permissions correctly, Enterprise Manager cannot collect monitoring information and you may see unpredictable results.
Note. If Enterprise Manager detects any warnings during discovery, a Discovery Warnings link appears below the discovery results. Click the link to open a page that lists all the warnings encountered.
One common warning involves the psconfig.sh process being run before the Enterprise Manager agent has been started. In this case, discovery will be unsuccessful. The warning message instructs you to shut down the agent, restart it and then run psconfig.sh.
Target Naming Conventions
Enterprise Manager requires that all discovered targets be assigned a unique name that serves as the target’s key. The following table describes target naming conventions.
Copyright © 2006, Oracle. All rights reserved.
41
Discovering PeopleSoft Targets
Chapter 4
Target Type
PS Application Database
PS Application Server Domain
<DBName>+db.+<PeopleSoft
GUID>
Naming Convention
<domain>+<app>+<host>+<PS_
HOME>
Example
CRMPRD.db.66ce0b93-85bb-11d9-
92af-fa37c30c4526 where DBName = CRMPRD,
GUID = 66ce0b93-85bb-11d9-92affa37c30c4526
CNVCRM.app.server1.usr_local
where domain = CNVCRM Host = server1 PS_HOME = /usr/local
CNVCRM.prcs.server1.usr_local
PS Process Scheduler Server Domain <domain>+<prcs>+<host>+<PS_
HOME>
PS Search Server Domain <domain>+<srch>+<host>+<PS_
HOME>
CNVCRM.srch.server1.usr_local
PS PIA using Weblogic or WebSphere <PIA domain name>+<pia>+<host>+
<PS_HOME> peoplesoft.pia.server1.usr_local
where PIA domain name = peoplesoft
PS PIA using OAS
PS Web Sites using Weblogic or
WebSphere
<domain>+<pia>+<host>+<OAS_
ORA_HOME>
<site name.PIA domain name>+site+<host>+<PS_HOME> peoplesoft.pia.server1.usr_local_oas
where OAS_ORA_HOME =
/usr/local/oas ps.peoplesoft.site.server1.usr_local
where site name = ps
PS Web Sites using OAS <site name.PIA domain name>+site+
<host>+WEBSERVER_ORA_HOME ps.peoplesoft.site.server1.usr_local_
oas
Additional naming conventions:
• If the host name has the fully qualified DNS name, the name server1.peoplesoft.com becomes server1.
• A Windows path, for example C:\pt8.48\appserv, becomes c_pt848_appserver. Any dots (.) or colons (:) are removed, and backslashes (\) and spaces are replaced with an underscore (_).
Target Credentials
When you have entered all discovery values, click Next. The Credentials page appears.
Enter your operating system user name and password for the machine on which you want to run the discovery process. After your credentials are accepted, discovery begins. The screen displays the discovery processing message.
Registering Targets
After the discovery process completes, you must register the targets in Enterprise Manager.
42 Copyright © 2006, Oracle. All rights reserved.
Chapter 4
Discovering PeopleSoft Targets
The steps for registering targets are:
1. When discovery is finished, a page displays a list of the discovered PeopleSoft targets that are not yet registered in Enterprise Manager. Any targets previously discovered and registered are excluded from the list.
All listed targets are selected by default on the Add PeopleSoft Targets page. Clear any discovered targets that you do not want to register.
Note. A PS PIA target can be registered without a corresponding PS Web Site target. However, a PS
Web Site target cannot be registered without also having a registered PS PIA (parent) target.
2. Click Next.
All targets selected are registered in Enterprise Manager. Their initial configuration values are collected and loaded into the repository.
The discovery process continues for the PS Application Databases.
3. The Add PeopleSoft Application Database page appears showing a list of targets for which environment variables may need to be set.
The list includes all PS Application Server Domains, PS Process Scheduler Domains, and PS Search
Server Domains registered in Enterprise Manager in this or a previous discovery.
Set Environment Variables Click to configure settings that enable connection to an application database—use this following your selection in the Select column.
Select Check box to determine for which targets you want to allow editing of the environment variables.
Name Name of the PS Application Server Domain, Process Scheduler
Domain, or PS Search Server Domain that can have a PS Application
Database.
This value displays as a hyperlink to the target homepage, which you can select to open in a new window.
Target Type
DB Type
Environment Set
The type of target being registered.
The type of database to which the target is connecting.
Shows a green check mark when environment variables have been set for the database (if required for a specific database type); shows a red
X when environment variables have not been set.
The environment variables referred to in this field are database connectivity parameters and vary depending on the database type.
Databases Discovered Shows a green check mark when the application database is successfully discovered which means that Enterprise Manager can collect configuration data from the target and collect the PeopleSoft
GUID from the application database.
Shows a red X when discovery is unsuccessful. Possible reasons are:
• The environment variables have not been set correctly. Verify them on the Set Environment Variables page.
• The database information is incorrect. Select the target to open it in a new window. Select the Administration tab, then Configure
Copyright © 2006, Oracle. All rights reserved.
43
Discovering PeopleSoft Targets
Chapter 4
Domain to display configuration data. Validate database information here.
• The configuration collection has failed. Select the hyperlink for the target in the Name column. The target homepage appears where you can check for metric collection errors displayed above the
Alerts section.
Discover Related Databases Click this icon to initiate discovery.
4. Click Next.
The green check mark indicates that the application database associated with that target is registered in
Enterprise Manager.
Note. If you need to set environment variables, see the following section.
5. When prompted, click OK on confirmation pages. When finished, click Next.
The processing page for registering the specific application database appears. When complete, the system displays a page reporting the summary of discovery results.
6. The PeopleSoft subtab homepage appears showing the newly discovered targets.
Note. There is a difference between creating a target and adding a target. If you use the create feature,
Enterprise Manager creates a new domain on the managed host. If you use the add feature (Add PeopleSoft
Targets), Enterprise Manager searches for existing domains in the managed host that have not been registered in the Enterprise Manager.
Setting Environment Variables
Setting environment variables means specifying basic database connectivity parameters for the database type you are using. When you select Set Environment Variables for any target, the Set Environment Variables page appears showing two columns listing the required environment variables and corresponding values.
After you have entered the values on the Set Environment Variables page, they are added to the Environment
Variables list if they do not already exist. Therefore, based on the database type previously configured, the regions on this page may have tables prepopulated with the required environment variables.
Database Type
Oracle
Informix
Sybase
DB2 (OS390 on UNIX)
Microsoft SQL Server
Required Environment Variables
$ORACLE_HOME
$INFORMIXDIR
$INFORMIXSERVER
$SYBASE
$SYBASE_OCS
$DB2DIR
$DB2INSTANCE
Entry of environment variables not required; default values from MSSQLSERVER inserted.
44 Copyright © 2006, Oracle. All rights reserved.
Chapter 4
Discovering PeopleSoft Targets
Note. The environment variable values are not validated when you enter them. Furthermore, an agent does not inherit the environment variable values of the user initiating an action. For an action to be successful, values for environment variables must be set correctly.
By default, some environment variables appear on the Set Environment Variables page that displays during discovery (see table above), where you can set the values. However, other environment variables, such as
LD_LIBRARY_PATH, PATH, SHLIB_PATH, and LIBPATH may also need to be set for each discovered domain.
If you have only one installed PeopleTools and Tuxedo version on a managed host machine, you can set environment variables for an agent prior to starting that agent. However, if you have multiple installed versions of PeopleTools or Tuxedo on a managed host machine, the environment variables must be set for each discovered domain as part of the discovery process.
See Enterprise PeopleTools 8.48 PeopleBook: System and Server Administration.
Copyright © 2006, Oracle. All rights reserved.
45
Discovering PeopleSoft Targets
Chapter 4
46 Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
5
PeopleSoft Application Database Targets
This chapter provides an overview and discusses:
• The PS Application Database homepage
• PS Application Database configuration
Understanding PS Application Database Targets
The PeopleSoft Application Database target type refers to the database that contains the PeopleSoft application.
The application database target type is not intended to manage the underlying database (RDBMS) itself.
However, depending on your database type, Enterprise Manager may provide additional management and monitoring features.
If the database is Oracle, you can monitor and manage the database by selecting Targets, Database from the
Enterprise Manager homepage.
Note. If you have backed up, and then restored a database, you must set the GUID in the database to blanks before attempting the discovery process.
To get the current value of the database GUID, execute the following SQL Statement: select GUID from PSOPTIONS
Then, depending on your database syntax, execute the appropriate update statement to set the GUID column in
PSOPTIONS to ’ ’. For example: update PSOPTIONS set GUID = ’’
The PS Application Database Homepage
Select Targets, PeopleSoft, then click the application database link that you want to view. The PS Application
Database homepage appears:
Copyright © 2006, Oracle. All rights reserved.
47
PeopleSoft Application Database Targets
Chapter 5
48
PS Application Database homepage
Fields listed in the General section are:
• Status
• Availability
• Database Name
• Database Type
• PeopleTools Version
• PeopleTools System
Links listed in the Related Links section are:
• Monitoring Configuration
• Alert History
• Access
• All Metrics
• Blackouts
• Target Properties
• Metric and Policy Settings
• Reports
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Common Elements on
Copyright © 2006, Oracle. All rights reserved.
Chapter 5
PeopleSoft Application Database Targets
The PS Application Database Configuration Page
This page shows standard configuration properties of the application database, such as release version, database name and type, and so on. It also displays the PeopleSoft application patches applied to this database.
Copyright © 2006, Oracle. All rights reserved.
49
PeopleSoft Application Database Targets
Chapter 5
50 Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
6
PS Application Server Domain Targets
This chapter discusses:
• The PS Application Server Domain homepage
• How to create PS application server domains
• PS application server domain performance
• PS application server domain administration
• PS application server domain logs
The PS Application Server Domain Homepage
This target type enables an administrator to manage PeopleSoft application server domains.
Note. Many of the features in this section are described in Enterprise PeopleSoft PeopleTools 8.48: System
and Server Administration, “Setting Application Server Domain Parameters” chapter.
Select Targets, PeopleSoft, then click the specific application server that you want to view.
Copyright © 2006, Oracle. All rights reserved.
51
PS Application Server Domain Targets
Chapter 6
52
PS Application Server Domain homepage
Fields listed in the General section are:
• Status
• Availability
• Domain
• PS_HOME
• PS Application Database
• PS Search Server
Copyright © 2006, Oracle. All rights reserved.
Chapter 6
PS Application Server Domain Targets
• PeopleTools Version
• Application Release
• PeopleSoft System
• Operating System
• IP Address
• Host
Links listed in the Related Links section are:
• Monitoring Configuration
• Alert History
• Access
• All Metrics
• Blackouts
• Target Properties
• Metric and Policy Settings
• Reports
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Common Elements on
Creating PS Application Server Domain Targets
This section discusses how to create an application server domain target in Enterprise Manager.
Note. You must have a super administrator account to create new application server domains.
There are predefined configuration templates based on the number of concurrent users expected to connect to the domain:
• Small (1-100 users)
• Medium (100-500 users)
• Large (500-1000 users)
• Developer (for a development system)
You may also have custom templates that include their own default values.
Note. You must set the correct environment variables for new domains created within Enterprise Manager.
Refer to the section describing how to set environment variables.
See Chapter 4, “Discovering PeopleSoft Targets ,” Setting Environment Variables , page 44.
To create a PS Application Server Domain target:
1. Select Targets, PeopleSoft.
Copyright © 2006, Oracle. All rights reserved.
53
PS Application Server Domain Targets
Chapter 6
2. Select the value from the Create drop-down list, then click Go.
The Create PS Application Server Domain page appears.
3. Enter the appropriate values and select the desired check boxes, then click OK.
A processing page appears. You cannot abort this process and must wait for the process to finish.
4. If you do not import the configuration from a file, click OK.
The domain will be created without a configuration. You can configure the domain at a later time by selecting the Configure Domain link from the Administration tab of the target.
Depending on the options that you selected when creating the domain, any one of the following pages appear next, the:
• Configure Domain page.
• Administration page of the PS Application Server Domain that you just created.
• Homepage of the PS Application Server Domain that you just created.
54
Create PS Application Server Domain page
Properties
Domain Name
Host
PS_HOME
Enter a unique name (within the host) not greater than 8 characters and not containing any spaces or punctuations.
Click the icon to display the Host Target selection window and select the host where you want to create the domain.
Based on the host, the available list is limited to the PS_HOMEs on the host that contain the software necessary to create a domain.
You can discover additional PS_HOMEs to augment this list. If you click
Discover PS_HOMEs in the Related Links region of this page, the Add
Copyright © 2006, Oracle. All rights reserved.
Chapter 6
PS Application Server Domain Targets
Configuration Template
Configure Domain
Import Domain
Configuration from file
PeopleSoft Targets page with the PS_HOMEs check box selected appears.
Continue through the discovery process, when finished, control returns to this page.
Select a template from the drop-down list.
(Optional) Click Get Latest Configuration Templates in the Related Links region of this page to retrieve the latest template list from the host. You are required to enter your credentials in a subsequent page to connect with a managed host.
The configuration template you select determines the default values of the domain.
Default selection is to configure the domain. If selected, the Configure
Domain page appears after the domain is created.
Select to enable the entry of the filename and path of the host’s configuration file.
Ensure that the source configuration file resides in the host or an error appears during the create process. Use the Find icon to verify the path or to populate this field by selecting the path to the file.
The Browse and Select: File and Directory page opens in a separate browser.
Select folders to drill down further until the desired file is found. Select the file and click Select.
Related Links
Discover PS_HOMEs
Manage PS_HOMEs
Get Latest Configuration
Template
Select to open the Add PeopleSoft Targets page.
Select to open the Manage PS_HOMEs page where you can remove a
PS_HOME from the Enterprise Manager repository.
Select to get the latest configuration template. Enter your credentials when prompted.
PS Application Server Domain Performance
The Performance tab shows a graphical view of the domain host’s CPU, memory utilization, disk read/write frequency for the drive where the application logs reside, number of queued processes for PSAPPSRV,
BROKER, SUBSCRIBER, and PUBLISHER, number of PSAPPSRV handlers spawned and total number of
Tuxedo connections. You can select the time frame for which you want to view performance data.
If the PUBSUB feature is not active, the graphs for Broker, Subscriber, and Publisher are blank.
Click Performance to display the PS Application Server Domain Performance page.
Copyright © 2006, Oracle. All rights reserved.
55
PS Application Server Domain Targets
Chapter 6
56
PS Application Server Domain Performance page
The CPU and memory utilization shown on the PS Application Server Domain Performance page includes more detailed information than that on the homepage.
Copyright © 2006, Oracle. All rights reserved.
Chapter 6
PS Application Server Domain Targets
The frequency of the disk read/write indicates how much the application server is caching—this value may affect the performance of the application.
The amount of queuing on the main processes of a PS application server indicates if the defined handlers are sufficient for the domain. Greater queuing causes a slow response on application functions.
Note. A statement of no data found may appear in the graphic region. This occurs because there is no target data available in Enterprise Manager when this graph is rendered.
For more information about changing the view of performance data, see Enterprise Manager documentation.
PS Application Server Domain Administration
Most of the tasks available on the Administration page correspond to menu items in the PeopleTools administration utility.
Select Administration to display the PS Application Server Domain Administration page.
Note. The links displayed on this page depend upon the target privileges associated with the user. All links are available to a super administrator account, or a user assigned full privileges and Add Target System privilege on this target. Users with operator or view target privileges will have fewer number of links available.
If a link appears available it does not mean that a particular user has automatic access to that action. Host credentials are still required for certain actions to execute on the target.
PS Application Server Domain Administration page
Configuration Management links that appear on this page:
Copyright © 2006, Oracle. All rights reserved.
57
PS Application Server Domain Targets
Chapter 6
• Configure Domain
Information icon that appears next to certain fields on the Configure
Domain page. To display a description of the field , move your mouse over the icon.
Dynamic icon that appears next to certain fields on the Configure Domain page. Indicates the field is dynamic and does not require a domain restart of the domain if the field was changed. The allow dynamic changes option must be selected.
• Create Like Domain
• Compare Domain Configurations
• Compare to Multiple Configurations (Jobs)
• Last Collected Configuration
• View Saved Configuration
• History
• Copy Configuration
Domain Management links that appear on this page:
• Start Domain
• Start Domain (Parallel)
• Stop Domain
• Stop Domain (Forced)
• Purge/Archive Cache
• Delete Domain
• Preload File Cache
• Clean IPC Resources
• Messaging Server
Tuxedo Management links that appear on this page:
• Access Tuxedo Command Line (TMADMIN)
• Process Status
• Client Status
• Queue Status
Additional Utilities links that appear on this page:
• Execute Host Command
• Windows Service Management (Available only for targets that have a Windows host).
58 Copyright © 2006, Oracle. All rights reserved.
Chapter 6
PS Application Server Domain Targets
PS Application Server Domain Logs
The PS Application Server Domain log feature enables you to view PeopleSoft-specific logs, traces or dumps for a target. In addition, you can search the log for string patterns, schedule a purge and archive job, and export log files to your workstation. Host credentials are required for this page to display.
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Target Log Management
Copyright © 2006, Oracle. All rights reserved.
59
PS Application Server Domain Targets
Chapter 6
60 Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
7
PS Process Scheduler Domain Targets
This chapter discusses:
• The PS Process Scheduler Domain homepage
• How to create a PS Process Scheduler Domain target
• PS Process Scheduler Domain performance
• PS Process Scheduler Domain administration
• PS Process Scheduler Domain logs
• How to manage a Process Scheduler in PIA
The PS Process Scheduler Domain Homepage
You access and use the PS Process Scheduler Domain homepage in the same way that you access and use the
PS Application Server Domain homepage. Minor differences include labels and alerts that are specific to a Process Scheduler domain.
Select Targets, PeopleSoft, then select the desired PS Process Scheduler Domain target. The homepage appears.
Copyright © 2006, Oracle. All rights reserved.
61
PS Process Scheduler Domain Targets
Chapter 7
62
PS Process Scheduler Domain homepage
Fields listed in the General section are:
• Status
• Availability
• Domain
• PS_HOME
• PS Application Database
• PeopleTools Version
• Application Release
• PeopleSoft System
Copyright © 2006, Oracle. All rights reserved.
Chapter 7
PS Process Scheduler Domain Targets
• Operating System
• IP Address
• Host
Links listed in the Related Links section are:
• Monitoring Configuration
• Alert History
• Access
• All Metrics
• Blackouts
• Target Properties
• Metric and Policy Settings
• Reports
• Open Telnet Session (Available only for targets that have a UNIX-based host)
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Common Elements on
Creating PS Process Scheduler Domain Targets
You create a PS Process Scheduler domain in the same way that you create a PS Application Server domain.
See Chapter 6, “PS Application Server Domain Targets,” Creating PS Application Server Domain Targets
PS Process Scheduler Domain Performance
The PS Process Scheduler Domain Performance page shows data that is similar to the PS Application
Server Domain target.
Graphs shown on this page include the host CPU usage, host memory usage, PSPRCSRV, and PSDSTSRV queued processes.
PS Process Scheduler Domain Administration
Select Administration to display the PS Process Scheduler Server Domain Administration page.
Copyright © 2006, Oracle. All rights reserved.
63
PS Process Scheduler Domain Targets
Chapter 7
64
PS Process Scheduler Domain Administration page
Configuration Management links that appear on this page:
• Configure Domain
• Create Like Domain
• Compare Domain Configurations
• Compare to Multiple Configurations (Jobs)
• Last Collected Configuration
• View Saved Configuration
• History
• Copy Configuration
Domain Management links that appear on this page:
• Start Domain
• Stop Domain
• Stop Domain (Forced)
• Clean IPC Resources
• Delete Domain
• Manage Process Scheduler in PIA
Tuxedo Management links that appear on this page:
• Process Status
• Queue Status
Copyright © 2006, Oracle. All rights reserved.
Chapter 7
PS Process Scheduler Domain Targets
Additional Utilities link that appears on this page is Execute Host Command.
Note. Windows Service Management link is available if the target’s host is Windows.
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Target Administration
Managing a Process Scheduler in PIA
You can manage several Process Scheduler configurations in PIA. For example, you can:
• Schedule specific processes
• Monitor processes with Process Monitor
• Run Application Engine programs
Select Administration, Manage Process Scheduler in PIA. A browser page opens showing the PIA login page.
After you have successfully logged in, the Process Scheduler Administration page displays. (You should have previously defined the Process Scheduler URL in the PeopleSoft System URL Setup page).
See Chapter 10, “PeopleSoft Systems and Services,” PeopleSoft System URLs, page 86.
PS Process Scheduler Domain Logs
The PS Process Scheduler Domain log feature is the same as in the PS Application Server Domain.
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Target Log Management
Copyright © 2006, Oracle. All rights reserved.
65
PS Process Scheduler Domain Targets
Chapter 7
66 Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
8
PS PIA and PS Web Site Targets
This chapter discusses:
• PS PIA targets
• PS Web Site targets
PS PIA Targets
This section discusses:
• The PS PIA homepage
• PS PIA target performance
• PS PIA target administration
• PS PIA target logs
The PS PIA Homepage
The PS PIA target acts as a container for one or more PS Web Site targets and together they are a PeopleSoft web server.
Select Targets, PeopleSoft, then select the desired PS PIA target. The homepage for PS PIA appears.
Copyright © 2006, Oracle. All rights reserved.
67
PS PIA and PS Web Site Targets
Chapter 8
68
PS PIA homepage
The PS PIA target can be compared to a domain in Weblogic, a server in WebSphere, and an application/OC4J in OAS.
Note. Before attempting to discover or access a PS PIA and PS Web Site in Enterprise Manager, verify that your PeopleSoft application is running and that you can log in from a PIA page.
Fields listed in the General section are:
• Status
- In Weblogic, represents the aggregate status of the different servers in a clustered environment. Up displays if there is at least one server in the cluster that is up; otherwise, a down displays. The
Weblogic administration server must be running to retrieve an accurate status of the managed servers and for start or stop operation.
Copyright © 2006, Oracle. All rights reserved.
Chapter 8
PS PIA and PS Web Site Targets
- In OAS, the OPMN service must be up and running for an accurate retrieval of PS PIA status and for start or stop operation.
- Start and Stop—By default these buttons call the delivered PeopleSoft start and stop scripts. However you can use customized scripts registered in Enterprise Manager. Customized scripts are important when the PeopleSoft web server architecture involves a cluster.
• Availability
• Name
• HTTP Port
• HTTPS Port
• PS_HOME
• Web Sites
• Web Server
• Reverse Proxy
A value of yes means that PS PIA is connected to a reverse proxy server.
See Enterprise PeopleTools 8.48 PeopleBook: Internet Technology, ”Understanding Reverse Proxy
Servers”
• PeopleTools Version
• PeopleSoft System
• Operating System
• IP Address
• Host
Links listed in the Related Links section are:
• Monitoring Configuration
• Alert History
• Access
• All Metrics
• Blackouts
• Target Properties
• Metric and Policy Settings
• Reports
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Common Elements on
PS PIA Target Performance
Select Performance to view metric data for the Host CPU Utilization and Host Memory Utilization.
Copyright © 2006, Oracle. All rights reserved.
69
PS PIA and PS Web Site Targets
PS PIA Target Administration
Select Administration for access to administrator tools and utilities relevant to PS PIA management.
Chapter 8
70
PS PIA Administration page
Configuration Management links that appear on this page:
• The first link varies depending on the target’s web server type. Edit setEnv.cmd (Weblogic on Windows platform), Edit setEnv.sh (UNIX), Edit server.xml (WebSphere), or Edit opmn.xml (OAS).
• Edit web.xml
• Compare Configurations
• Compare to Multiple Configurations (Jobs)
• Last Collected Configuration
• View Saved Configuration
• History
PIA Management links that appear on this page:
• Start PIA
• Stop PIA
• Weblogic Console/WebSphere Administration Console/(iAS) Console (depends on web server type)
Additional Utilities links that appear on this page:
• Execute Host Command
• Customize Start/Stop Scripts
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Target Administration
PS PIA Target Logs
The PS PIA Log page has the same features as the PS Application Server Domain Log page except that trace files are not supported in PS PIA.
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Target Log Management
Copyright © 2006, Oracle. All rights reserved.
Chapter 8
PS PIA and PS Web Site Targets
PS Web Site Targets
This section discusses:
• The PS Web Site homepage
• PS Web Site performance
• PS Web Site administration
PS Web Site targets comprise the second part of a PeopleSoft web server. This level contains all of the PS PIA settings and files; hence, a PS Web Site target requires a tandem PS PIA target in order to be activated. There can be one or multiple sites attached to a PS PIA target. The PS Web Site’s key role is configuration.
To access the PS Web Site target type, select Targets, PeopleSoft and select a PS Web Site target.
The PS Web Site Homepage
The PS Web Site homepage shows basic information for a web site. Select Targets, PeopleSoft, and select the desired PS Web Site target. The PS Web Site homepage appears.
Copyright © 2006, Oracle. All rights reserved.
71
PS PIA and PS Web Site Targets
Chapter 8
72
PS Web Site homepage
Fields listed in the General section are:
• Status
The status shown on this page reflects the status of the parent PS PIA.
You cannot perform stop or start from this page—you must do that on the PS PIA target page.
• Availability
• Site Name
• PS_HOME
• PS PIA
• PeopleTools Version
• PeopleSoft System
Copyright © 2006, Oracle. All rights reserved.
Chapter 8
PS PIA and PS Web Site Targets
• Operating System
• IP Address
• Host
Links listed in the Related Links section are:
• Monitoring Configuration
• Alert History
• Access
• All Metrics
• Blackouts
• Target Properties
• Metric and Policy Settings
• Reports
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Common Elements on
PS Web Site Performance
The graphs and metrics displayed on the Performance page are similar to that of PS PIA showing the CPU and memory utilization of the host.
See Chapter 8, “PS PIA and PS Web Site Targets,” PS PIA Target Performance , page 69.
PS Web Site Administration
Select Administration to display the PS Web Site Administration page.
PS Web Site Administration page
Configuration Management links that appear on this page:
• Configure Site
• Web Profile
Copyright © 2006, Oracle. All rights reserved.
73
PS PIA and PS Web Site Targets
Chapter 8
• Integration Broker
• Compare Configurations
• Compare to Multiple Configurations (Jobs)
• Last Collected Configuration
• View Saved Configuration
• History
Additional Utilities link that appears on this page is PIA Signon.
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Target Administration
74 Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
9
PS Search Server Domain Targets
This chapter provides an overview and discusses:
• The PS Search Server Domain homepage
• How to create a PS Search Server Domain
• PS Search Server Domain performance
• PS Search Server Domain administration
• PS Search Server Domain logs
Understanding PS Search Server Domain Targets
The PS Search Server Domain target type allows for the application server search function in PeopleSoft applications.
The PS Search Server Domain accommodates users:
• Of a Verity search engine whose platforms are not supported by Verity; for example, zLinux.
• Who choose to implement a search server on a platform separate from the application server.
One search server domain can be associated to more than one application server domain; however, an application server domain can have just one search server.
The PS Search Server Domain Homepage
Select Targets, PeopleSoft, then select a PS Search Server Domain target. The homepage appears:
Copyright © 2006, Oracle. All rights reserved.
75
PS Search Server Domain Targets
Chapter 9
PS Search Server Domain homepage
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Common Elements on
Creating a PS Search Server Domain
You can create a PS Search Server Domain in the PeopleSoft subtab. Select PS Search Server from the Create drop-down list and click Go. The Create PS Search Server Domain page appears. The Import Configuration from File option is not available when creating a PS Search Server Domain.
Note. Not all platforms support a separate search server domain. Therefore, the system checks whenever you try to create a search server domain manually. If a separate search server domain target type is not supported on your platform, an error occurs.
76 Copyright © 2006, Oracle. All rights reserved.
Chapter 9
PS Search Server Domain Targets
See Chapter 6, “PS Application Server Domain Targets,” Creating PS Application Server Domain Targets
PS Search Server Domain Performance
This page displays the same information as the PS Process Scheduler Domain Performance page except that the process in the Queued Process graph is the PSSRCHSRV.
PS Search Server Domain Administration
This page displays information similar to that displayed on the PS Application Server Domain Administration page.
PS Search Server Domain Administration page
Configuration Management links that appear on this page:
• Configure Domain
• Compare Domain Configurations
• Compare to Multiple Configurations (Jobs)
• Last Collected Configuration
• View Saved Configuration
• History
Copyright © 2006, Oracle. All rights reserved.
77
PS Search Server Domain Targets
Chapter 9
Domain Management links that appear on this page:
• Start Domain
• Stop Domain
• Stop Domain (Forced)
• Delete Domain
• Clean IPC Resources
Tuxedo Management links that appear on this page:
• Access Tuxedo Command Line (TMADMIN)
• Process Status
• Client Status
• Queue Status
Additional Utilities link that appears on this page is Execute Host Command.
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Target Administration
PS Search Server Domain Logs
This page displays the same features as the PS Application Server Domain Logs page.
See Chapter 3, “Understanding the PeopleSoft Environment Management Plug-in,” Target Log Management
78 Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
10
PeopleSoft Systems and Services
This chapter provides an overview and discusses how to:
• Define PeopleSoft systems
• Edit PeopleSoft systems
• Remove PeopleSoft systems
• Manage PeopleSoft systems
Understanding PeopleSoft Systems
PeopleSoft targets sharing the same application database can be grouped into a PeopleSoft system. A
PeopleSoft system can comprise an application database, multiple PS PIA targets, PS Web Sites, PS Process
Scheduler Domains, PS Search Server Domains, and PS Application Server Domains. For example, a typical PeopleSoft system might be a production CRM application, which could include various PeopleSoft entities—like an application server, web server, search server, Process Scheduler, and an application database.
The PeopleSoft application database is the target that binds all of the other PeopleSoft targets together in the PeopleSoft system.
Note. If you use automated system creation PeopleSoft, all PeopleSoft targets that are associated with a particular PeopleSoft application database are added to this system. Only PeopleSoft targets that have been registered in Enterprise Manager can be in a system.
PS PIA and PS Web Site targets do not appear in an automatically generated system, unless they have been logged into previously.
Understanding Services
A service is defined as an entity that provides a useful function to its users; specifically, it models a business process or application. An administrator defines a service test to determine whether or not the service is available and performing. A beacon is a target type in Enterprise Manager that performs a service test.
The PeopleSoft Environment Management Plug-in delivers a service test that enables administrators to monitor the availability of a PeopleSoft application by simulating a login-logout activity.
Note. The delivered service test checks only the login and logout capability of the PeopleSoft application by simulating it (using the URL entered by the user). However, administrators can create their own services in
Enterprise Manager to track specific areas of their applications, such as in payroll processing or call center services. They can also modify the generated service.
Copyright © 2006, Oracle. All rights reserved.
79
PeopleSoft Systems and Services
Chapter 10
Creating PeopleSoft Systems
The section discusses:
• The PeopleSoft System homepage
• Automated PeopleSoft system creation
• Manual PeopleSoft system creation
The PeopleSoft System Homepage
To view the Systems homepage, click Targets, Systems, then select a PeopleSoft system. The PeopleSoft
System homepage appears.
80
PeopleSoft System homepage
Copyright © 2006, Oracle. All rights reserved.
Chapter 10
PeopleSoft Systems and Services
Automated PeopleSoft System Creation
To create a PeopleSoft system, select Targets, Systems. Select PeopleSoft System in the Add field and click Go.
The Create PeopleSoft System page appears:
Create PeopleSoft System page
Automated PeopleSoft System Creation
PS App DB
System Name
Timezone
Select the PeopleSoft database that should be associated to the new system.
The list includes all the PS Application Databases that have been registered in
Enterprise Manager.
Enter a new system name. Enterprise Manager automatically assigns a system name as <DBName>+[01-99].PSSystem. If there is already a system with that name, the new name is incremented by 1. You can change the system name to one that is more descriptive.
Select the appropriate time zone. The default is the time zone of the Oracle
Management Service.
Service Configuration
Create Service
Service Name
(Optional) Select to configure the service that the PeopleSoft Environment
Management Plug-in automatically creates for every valid PeopleSoft system.
This service simulates the login-logout action to the PeopleSoft application.
If you leave the check box cleared, the remaining fields are unavailable for selection.
Enter a service name. The default is <System Name>+. Service.
Copyright © 2006, Oracle. All rights reserved.
81
PeopleSoft Systems and Services
Chapter 10
Beacon
Timezone
Click the icon to open a browser listing predefined beacons. Select the beacon you want associated with the service.
Select the appropriate time zone for the service. The default is the time zone of the Oracle Management Service.
PS Web Sites and User IDs Lists the PS Web Sites detected in the PeopleSoft system. You must define the
URL for the PeopleSoft page of each PS Web Site and specify login credentials.
1. Enter the PeopleSoft application homepage URL (the first page to appear after the PeopleSoft login page). The format is
<protocol>://<hostname>/psp/<web site>/<portal>/<node>/h/<tab
ID>
For example: http://myserver.peoplesoft.com/psp/ps/EMPLOYEE
/PT_LOCAL/h/?tab=DEFAULT
2. Enter a user ID and password for use as the login to these URLs.
3. To remove a web site from the service, click Delete at the end of the row.
Note. A service can be created only if there is at least one URL and one PS Web Site listed in the grid.
Click OK to proceed with the automated system creation.
Note. All system properties are defaulted when the system is created automatically.
There are no defaults for charts and metric data and they must be set up manually, if desired.
Manual System Creation
To select components individually for system creation, click the Manual PeopleSoft System Creation link in the lower left-hand part of the Create PeopleSoft System page.
82 Copyright © 2006, Oracle. All rights reserved.
Chapter 10
PeopleSoft Systems and Services
Manual Create PeopleSoft System page
Name
Components
Enter a name for your new PeopleSoft system.
Click Add to display the Search and Select Targets page. Select the targets you want to add to the PeopleSoft system.
Select the appropriate time zone for this system.
Timezone
1. Enter or select values for the fields listed above.
2. Because you are manually creating a system by adding targets, you must also manually specify the target associations.
To define the associations or relationships among the target types, click Topology.
3. There are several additional steps needed to create a PeopleSoft system manually. Refer to the
Enterprise Manager documentation for more information.
4. Click OK when you have added all the desired components.
Editing PeopleSoft Systems
From the Edit PeopleSoft Systems page, you can add and remove targets from a PeopleSoft system and redefine associations shown in the topology.
Select Targets, Systems, then select the PeopleSoft system that you want to edit and click Configure. The
Edit PeopleSoft System page appears:
Copyright © 2006, Oracle. All rights reserved.
83
PeopleSoft Systems and Services
Chapter 10
Edit PeopleSoft System page
Removing PeopleSoft Systems
Removing a PeopleSoft system means you are removing a grouping of targets in Enterprise Manager.
However, you are not removing the targets from the Enterprise Manager or their installations from the server.
The member targets remain in Enterprise Manager and can be managed and used for building other systems.
To remove a PeopleSoft system, select Targets, Systems, then the existing system that you want to remove.
Click Remove.
Managing PeopleSoft Systems
This section discusses:
• PeopleSoft system administration
• PeopleSoft system components
• PeopleSoft system URL
84 Copyright © 2006, Oracle. All rights reserved.
Chapter 10
PeopleSoft Systems and Services
• PeopleSoft system topology
PeopleSoft System Administration
You can create jobs and blackouts from the PeopleSoft System Administration page. Also, the PeopleSoft
URLs that have been defined for a PeopleSoft system appear in the PeopleSoft URL section of the PeopleSoft
System’s Administration page. The URLs are listed as links and when selected, a new browser page opens showing the website that was defined.
Select Targets, Systems, a specific PeopleSoft system. From the homepage, select Administration.
PeopleSoft System Administration page
PeopleSoft System Components
The PeopleSoft System Components page lists all of the PeopleSoft targets included in the system. You can click an individual target to display that target’s homepage.
Select Targets, Systems and a specific PeopleSoft system. From the homepage, select Components.
Copyright © 2006, Oracle. All rights reserved.
85
PeopleSoft Systems and Services
Chapter 10
86
PeopleSoft System Components page
PeopleSoft System URLs
You can define different system URLs to be accessed in Enterprise Manager. Only users who have full target privileges can manage PeopleSoft system URLs in Enterprise Manager.
PeopleSoft delivers the following system URL types for you to create and associate URLs to your PeopleSoft system.
Note. The system administrator is responsible for populating the correct URL fields. The system does not verify the URL and by default, the URL fields are blank.
• Process Scheduler Management
You can enter the URL for any of the submenus used in PeopleTools Process Scheduler; for example,
Process Monitor and Application Engine. Once you have defined this system URL, you can access it by selecting Administration for the PS Process Scheduler Domain target, then click Manage Process
Scheduler in PIA.
• Web Profile Search
This URL is associated with a PS Web Site target. Enter the URL from a PeopleSoft application to open its web profile page. The naming convention for this URL is <WebSite_Name>+_Web Profile Search.
• PIA Signon
Copyright © 2006, Oracle. All rights reserved.
Chapter 10
PeopleSoft Systems and Services
You may have multiple values for PIA—however, the PS Web Site is the primary key. The PS Web
Site drop-down list in the Create URL page shows only the PS Web Sites that have been defined in the
PeopleSoft system. If there are no PS Web Sites present in the PeopleSoft system you cannot create a PIA
Signon URL entry. The naming convention for this URL is <WebSite_Name>+_PIA Signon.
• Integration Broker Monitor Message
This URL is associated with a PS Web Site target. Enter the URL from a PeopleSoft application to open its
Integration Broker profile page. The naming convention for this URL is <WebSite_Name>+_Integration
Broker Monitor Message.
• Web Server Administration
This refers to WebSphere, Weblogic, or OAS web server administration site. Enter the URL here to access the web server administration site from Enterprise Manager. You may have multiple values here, while the PS PIA target is the primary key. The naming convention for this URL is <<PIA_Name>+_Web
Server Administration.
• Performance Monitor
Enter the URL of the Performance Monitor system that is monitoring your PeopleSoft servers.
• PeopleBooks
Enter the URL of your PeopleBook web site for access from Enterprise Manager.
Click the PeopleSoft System URL Setup link in the Related Links region of the PeopleSoft System homepage.
The PeopleSoft System URL page appears.
PeopleSoft System URL page
Edit
Remove
Create
Select a URL , then click to enter changes to previously created PeopleSoft system URLs.
Click to remove a PeopleSoft system URL.
Click to display the Create PeopleSoft System URL page. Select the URL type and make other appropriate selections. Click Save.
Note. By default, the system adds http:// to the front of the URL, if not already present, when saving the record.
PeopleSoft System Topology
The Topology page shows a graphical view of a PeopleSoft system and enables you to perform several tasks.
Copyright © 2006, Oracle. All rights reserved.
87
PeopleSoft Systems and Services
Chapter 10
From the Topology page, you can:
• See the status of each target—icons are green (up), red (down), light gray (unknown), dark gray (blackout).
• Display data that is refreshed every 30 seconds, or manually if specified.
• Zoom in and out by clicking the icons in the left-hand column. Show summary information on the number of alerts and policy violations on a per target or system basis.
• You can initiate common PeopleSoft actions for a target by right-clicking on the target’s icon.
The actions available depend on the target type and your target privileges. For example, if you have operator level target privileges, you can only start, stop and purge.
The actions available by target type with full target privileges are
- PS Application Database has no actions available, it is display only.
- PS Application Server Domain allows start, stop, configure, and purge/archive.
- PS Search Server Domain allows start, stop, and configure.
- PS Process Scheduler Domain allows start, stop, and configure.
- PS PIA allows start and stop.
- PS Web Site allows configure.
To view a PeopleSoft system in the Topology Viewer, select Targets, Systems and select a PeopleSoft system.
The homepage appears, select Topology. The Topology Viewer opens.
88 Copyright © 2006, Oracle. All rights reserved.
Chapter 10
PeopleSoft Systems and Services
PS System Topology page
Copyright © 2006, Oracle. All rights reserved.
89
PeopleSoft Systems and Services
Chapter 10
90 Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
11
Security for PeopleSoft Environment
Management Plug-in
This chapter provides an overview and discusses:
• Target privileges
• Target preferred credentials
• Target credentials
Understanding Enterprise Manager Security
The PeopleSoft Environment Management Plug-in relies on Oracle Enterprise Manager’s security framework for most security features.
Enterprise Manager identifies administrators to manage the Enterprise Manager administration accounts.
There are three administrator access categories:
Administrator
Super Administrator
Repository Owner
This is considered the regular Enterprise Manager administrator.
This is considered the most powerful Enterprise Manager administrator with full access privileges to all targets and administrator accounts within the Enterprise Manager environment. Only super administrators can perform administrative operations on regular administrator accounts.
See Chapter 3, “Understanding the PeopleSoft Environment Management
Plug-in,” Super Administrator Accounts, page 23.
This is the database administrator for the Management Repository. This account cannot be modified, duplicated, or deleted.
From the Enterprise Manager Grid Control Console, you can create and manage new administrator accounts.
Each administrator account includes its own login credentials, and a set of roles and privileges that are assigned to the account.
Target Privileges
Target privileges enable an administrator to perform operations on a target. Certain privileges are automatically given to administrators based on other privileges. For example, granting any privileges on a target automatically grants the View target privilege on the host.
Copyright © 2006, Oracle. All rights reserved.
91
Security for PeopleSoft Environment Management Plug-in
Chapter 11
Target privileges are divided into three groups:
View Enables the administrator to view properties, inventory and monitor information about a target. The view privilege is propagated to all members of aggregate targets such as groups and systems.
Note. The view privilege must also be assigned to the agent of the target.
Operator
Full
Enables the administrator to perform the following operations on a target: startup, shutdown, edit target properties, view the components of the system, modify system membership, add charts to the system, create or edit system topology, customize the dashboard associated with the system, change the columns that appear on the System Members page, black out the system and its components. The Operator Target privilege does not automatically propagate to members of the System.
Implicitly grants all the target privileges and enables the administrator to delete a target and configure credentials for maintenance operations of a target.
When you create a system, you become its owner and automatically receive full privileges for the system and view on all targets. Certain privileges are automatically given to administrators based on other privileges. For example, granting any privileges on a target automatically grants the View target privilege on the host.
See Also
Appendix B, “Roles and Privileges,” Target Actions and Privileges, page 101
Target Preferred Credentials
Target Preferred Credentials is a credential specifically applied to a single target for a particular user.
Note. PeopleSoft targets do not use host preferred credentials for PeopleSoft-specific actions.
Managing Preferred Credentials
Preferred credentials simplify access to managed targets by storing target login credentials in the Management
Repository. With preferred credentials set, users can access an Enterprise Manager target that recognizes those credentials without being prompted to log into the target. Preferred credentials are set on a per user, per target basis, thus ensuring the security of the managed enterprise environment.
To manage Enterprise Manager preferred credentials:
1. Click Preferences at the top of any Enterprise Manager Grid Control page.
2. Click Preferred Credentials in the vertical navigation bar.
Enterprise Manager displays the Preferred Credentials page. The first column lists all the target types.
3. Click the Set Credentials icon (last column) that corresponds to the target type for which you want to manage the preferred credentials.
The specific target type’s preferred credentials page appears.
92 Copyright © 2006, Oracle. All rights reserved.
Chapter 11
Security for PeopleSoft Environment Management Plug-in
4. Enter the host user name and host password, as desired.
If you need help using the Preferred Credentials page, click Help at any time.
Target Credentials
Each of the target privilege levels are assigned actions that can be performed whenever the privilege is assigned to a role or user.
See Appendix B, “Roles and Privileges,” page 101.
The Target Credentials page is used to verify credentials.
Depending on what actions you want to perform, you may be required to enter a user name and password in the Target Credentials page.
If desired, you can select the Saved Preferred Credentials check box, and the system will not prompt for credentials the next time you initiate the action for this target (when you are the current user in Enterprise
Manager).
Target Credentials page
Copyright © 2006, Oracle. All rights reserved.
93
Security for PeopleSoft Environment Management Plug-in
Chapter 11
94 Copyright © 2006, Oracle. All rights reserved.
C
HAPTER
12
Validating Policies
This chapter provides an overview and discusses:
• Enterprise Manager policy validation.
• PeopleSoft policy definitions
Understanding Policies
Policies define the optimal configurations of systems and any deviations to your systems or applications are reported. Examples of deviations include inappropriate settings and incorrect system configurations.
PeopleSoft Policy Definitions
The PeopleSoft Environment Management Plug-in delivers predefined policies.
See Chapter 12, “Validating Policies,” PeopleSoft Policy Definitions, page 95.
Enterprise Manager’s Policy Validation
The PeopleSoft Environment Management Plug-in uses the policy validation of Enterprise Manager. It enables you to verify the configurations of different targets and identify inconsistencies or possible issues.
Note. There are no policies for PS Application Database, PS Process Scheduler, or PS Search Server Domain targets.
Policy validation is initially set to run once every 24 hours. However, it occurs automatically when PeopleSoft targets are discovered. You can change the collection schedule of each policy by:
• Selecting the Metric and Policy Setting link for the target homepage.
The Metric and Policy Settings page appears.
• From the Policies tab, click the Collection schedule before each policy to change their individual schedules.
Click OK every time you change a policy setting, otherwise, Enterprise Manager does not update the changed values.
Once the collection is run on a scheduled basis, Enterprise Manager retrieves the corresponding metric in the repository and compares it to the condition defined in the policy. If the policy condition is met
(identifies a violation), violation data is generated and you can view it in the Violation Summary region of the target homepage.
Copyright © 2006, Oracle. All rights reserved.
95
Chapter 12
Violations can be viewed from the Policy Violations page. Select the Policies tab in Enterprise Manager, then
Count from the Policy Violations. From this page, you can access the Policy Violation Detail page.
The count of violations can be viewed from a target’s homepage in the Policy Violations section. Click the violation count link to open the Policy Violations page, then click the count to open the Policy Violation
Detail page.
Policy Violation Detail
Access the Policy Violation Detail page by clicking a value in the Violation Count column of the Policy
Violation page.
96
Policy Violation Details page
The Policy Violation Details page shows detail about the violation; a graph showing the percentage of this violation within the target; the violation’s impact; the recommended fix; and a grid listing the occurrences of each violation.
Click Suppress Violation to display the Suppress Violation page where you can specify which policies to suppress.
To edit policy definitions such as disabling the policy check for a target or changing its threshold select the
Edit Policy Rule Settings from the Related Links.
Copyright © 2006, Oracle. All rights reserved.
A
PPENDIX
A
Configuration and Metric Data Collected
This appendix discusses:
• Configuration data collected
• Metric data collected
Configuration Data Collected
Enterprise Manager collects configuration data from each target type’s configuration. Configuration data is collected on a regular basis—the default is once a day—and is transmitted to the Oracle Management Service.
The first configuration collection occurs after the initial discovery process.
For subsequent configuration collections, the Oracle Management Service receives and parses the data and saves updates to the Management Repository. In addition to the regularly scheduled configuration collection process, collections are triggered every time you change a target’s configuration from within Enterprise
Manager.
The following table shows the configuration data collected for each PeopleSoft target type.
PeopleSoft Target Type
PS Application Database
PS Application Server Domain
PS Process Scheduler Domain
PS Search Server Domain
PS PIA
PS Web Site
Data in These Files
PeopleTools tables psappsrv.cfg, psappsrv.ubx
psprcs.cfg, psprcs.ubx
pssrchsvr.cfg, pssrchsvr.ubx
piaInstallLog.xml, config_prop, setEnv.sh/cmd or opmn.xml or server.xml
web.xml, configuration.properties, integrationGateway.properties, pstools.properties, config_prop
Copyright © 2006, Oracle. All rights reserved.
97
Configuration and Metric Data Collected
Appendix A
Metric Data Collected
This refers to the collection of data that changes frequently, such as status, memory, disk utilization, and so on.
PeopleSoft delivers predefined metric types and default collection times for each target type.
The metric data collected is saved to the Management Repository and is compared to predefined thresholds for each target. If a threshold has been reached, the system generates an alert. The alerts display on each target’s homepage.
The following table shows the metric data collected for each PeopleSoft target type.
Target Type
PS Application Database
Attribute Name
Availability/Response
Collection Schedule
10 minutes
PS Application Server
Domain
PS Application Server
Domain
PS Application Server
Domain
PS Application Server
Domain
PS Application Server
Domain
PS Application Server
Domain
Availability/Response
# of Process Queued for App
Server
10 minutes
# of Process Queued for
BRK Dispatcher (if enabled)
13 minutes
# of Process Queued for
BRK Handler (if enabled)
# of Process Queued for
PUB Dispatcher (if enabled)
12 minutes
# of Process Queued for
PUB Handler (if enabled)
1 minute
14 minutes
15 minutes
Description
Checks the status of the PS
Application Database
Checks the status of PS
Application Server Domain
Monitors the number of
PSAPPSRV processes queued for a PS Application
Server Domain. Generates an alert if the defined threshold is reached.
Monitors the number of
PSBRKDSP processes queued for a PS Application
Server Domain. Generates an alert if the defined threshold is reached.
Monitors the number of
PSBRKHND processes queued for a PS Application
Server Domain. Generates an alert if the defined threshold is reached.
Monitors the number of
PSPUBDSP processes queued for a PS Application
Server Domain. Generates an alert if the defined threshold is reached.
Monitors the number of
PSPUBHND processes queued for a PS Application
Server Domain. Generates an alert if the defined threshold is reached.
98 Copyright © 2006, Oracle. All rights reserved.
Appendix A
Target Type
PS Application Server
Domain
PS Application Server
Domain
PS Application Server
Domain
PS Application Server
Domain
PS Process Scheduler
Domain
PS Process Scheduler
Domain
PS Process Scheduler
Domain
PS Process Scheduler
Domain
PS PIA
Configuration and Metric Data Collected
Attribute Name Collection Schedule
# of Process Queued for
SUB Dispatcher (if enabled)
16 minutes
# of Process Queued for
SUB Handler (if enabled)
PSAPPSRV Handler Count
Tuxedo Connections
Availability/Response
# Queued Processes for Process Scheduler
(PSPRCSRV)
# Queued Processes for Process Scheduler
(PSPRCSRV)
# Queued Processes for Distribution Server
(PSDSTSRV)
Availability/Response
17 minutes
15 minutes
9 minutes
1 minutes
15 minutes
15 minutes
15 minutes
1 minute
Description
Monitors the number of
PSSUBDSP processes queued for a PS Application
Server Domain. Generates an alert if the defined threshold is reached.
Monitors the number of
PSSUBHND processes queued for a PS Application
Server Domain. Generates an alert if the defined threshold is reached.
Monitors the number of active PSAPPSRV processes. Generates alerts if the number is below the specified minimum or above the maximum.
Counts the number of
Tuxedo connections to the PS App Server Domain.
Checks the status of PS
Process Scheduler Domain.
Monitors the number of
PSPRCSRV processes queued for a PS Process
Scheduler Domain.
Generates an alert if the defined threshold has been reached.
Monitors the number of
PSPRCSRV processes queued for a PS Process
Scheduler Domain.
Generates an alert if the defined threshold has been reached.
Monitors the number of
PSDSTSRV processes queued for a PS Process
Scheduler Domain.
Generates an alert if the defined threshold has been reached.
Checks the status of PS PIA.
Copyright © 2006, Oracle. All rights reserved.
99
Configuration and Metric Data Collected
Appendix A
Target Type
PS Web Site
PS Search Server Domain
PS Search Server Domain
Attribute Name
Availability/Response
Availability/Response
# Queued Processes for Search Server
(PSSRCHSRV)
Collection Schedule
1 minute
1 minute
5 minutes
Description
Checks the status of PS PIA where the PS Web Site is connected.
Checks the status of the PS
Search Server Domain.
Monitors the number of
PSSRCHSRV processes queued for a PS Search
Server Domain. Generates an alert if the defined threshold has been reached.
100 Copyright © 2006, Oracle. All rights reserved.
A
PPENDIX
B
Roles and Privileges
This appendix discusses target actions and privileges.
Target Actions and Privileges
The following table lists target actions for each of the target types and actions for systems and logs.
Note. Users assigned a super administrator role can perform all actions for all target types, systems, and logs.
Target Actions and Privileges Tables
This section includes tables showing target actions, credentials, and roles.
PS Application Server Domain
Target Actions
Create domain
Configure domain
Import domain configuration from file
Create like domain
Target Credentials
Required
Yes
Full Role
Yes, with target system privileges
Yes
Yes
Yes
Yes, with target system privileges
Yes
Operator Role
Yes, with target system privileges
Yes Compare domain configurations
Compare to multiple configurations (jobs)
Last collected configuration
View saved configuration
Yes
Yes
Yes
Viewer Role
Copyright © 2006, Oracle. All rights reserved.
101
Appendix B
Target Credentials
Target Actions
History
Copy configurations Yes
Create service
(Windows only)
Yes
Required
Yes
Yes
Yes
Full Role
Yes Create messaging server
Yes
Configure messaging server
Yes
Yes Delete messaging server
Create service
(Windows only)
Configure service
(Windows only)
Yes
Yes
Yes
Yes
Yes
Yes
Yes Install service
(Windows only)
Yes
Delete service
(Windows only)
Yes
Start domain (parallel and serial)
Yes
Yes Stop domain (forced and normal)
Access Tuxedo command line
(TMADMIN)
Yes
Purge/archive cache Yes
View domain processes status
View domain queue status
Yes
Yes
Yes
Yes
Yes
Yes
Yes
View domain client status
Delete domain
Preload file cache
Yes
Yes
Yes
Yes
Yes Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Operator Role
Yes
Yes
Yes
Viewer Role
102 Copyright © 2006, Oracle. All rights reserved.
Appendix B
Target Credentials
Target Actions
Clean IPC resources Yes
Required
Yes
Full Role
Yes Yes Execute host command
View domain status
(stopped or running)
Yes
PS Search Server Domain
Target Actions
Create domain
Target Credentials
Required
Yes
Full Role
Yes, with target system privileges
Yes Yes
Yes
Configure domain
Compare domain configurations
Compare to multiple configurations (Job)
Last collected configuration
Yes
Yes
Yes View saved configuration
History
Start domain Yes
Yes Stop domain (forced and normal)
Delete domain Yes
Clean IPC resources Yes
Access Tuxedo command line
(TMADMIN)
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes View domain processes status
View domain queue status
Yes
Operator Role
Yes
Yes
Yes Yes
Viewer Role
Operator Role
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Viewer Role
Copyright © 2006, Oracle. All rights reserved.
103
Appendix B
Target Credentials
Target Actions
View domain client status
View domain status
(stopped or running)
Execute host command
Yes
Required
Yes
Yes
Yes
Full Role
PS Process Scheduler Domain
Target Actions
Create domain
Configure domain
Import domain configuration from file
Create like domain
Target Credentials
Required
Yes
Full Role
Yes, with target system privileges
Yes
Yes
Yes
Yes, with target system privileges
Yes Yes, with target system privileges
Yes Compare domain configurations
Compare to multiple configurations (Job)
Last collected configuration
View saved configuration
History
Copy configurations Yes
Create service
(Windows only)
Yes
Yes Configure service
(Windows only)
Install service
(Windows only)
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Operator Role
Yes Yes
Viewer Role
Yes Yes
Yes
Operator Role Viewer Role
104 Copyright © 2006, Oracle. All rights reserved.
Appendix B
Target Actions
Delete service
(Windows only)
Start domain
Target Credentials
Yes
Yes
Stop domain (forced and normal)
Yes
Delete domain Yes
Clean IPC resources Yes
View domain processes status
Required
Yes
Yes
Yes
Yes
Yes
Yes
Full Role
Yes View domain queue status
View domain status
(stopped or running)
Execute host command
Manage Process
Scheduler in PIA
Yes
Yes, also prompted for
PIA login
Yes
Yes
Yes
PS PIA
Target Actions
Edit setEnv
Edit web.xml
Compare domain configurations
Compare to multiple configurations
Last collected configuration
View saved configuration
History
Start PIA
Target Credentials
Required
Yes Yes
Full Role
Yes Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Operator Role
Yes
Yes
Yes
Yes
Yes
Yes
Operator Role
Yes
Yes
Yes
Viewer Role
Viewer Role
Copyright © 2006, Oracle. All rights reserved.
105
Appendix B
Target Actions
Stop PIA
Web server type admin console
Customize start/stop scripts
Execute host command
View web domain status (if stopped or running)
Target Credentials
Required
Yes Yes
Full Role
Yes, also prompted for
PIA login
Yes
Yes
Yes Yes
Yes
PS Web Site
Target Actions
Configure site
Web profile
Integration Broker
Compare configurations
Compare to multiple configurations (jobs)
Last collected configuration
View saved configuration
History
PIA signon
View web site status
Target Credentials
Required
Yes Yes
Full Role
Yes, also prompted for
PIA login
Yes
Yes, also prompted for
PIA login
Yes
Yes
Yes
Yes
Yes
Yes
Yes, also prompted for
PIA login
Yes
Yes
Operator Role
Yes
Yes Yes
Viewer Role
Yes
Yes
Operator Role
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Viewer Role
106 Copyright © 2006, Oracle. All rights reserved.
Appendix B
PS Application Database
Target Actions
View status
Target Credentials
Required
Yes
Full Role Operator Role
Yes Yes
Viewer Role
Log Management (All Targets Except PS Web Site and PS App DB)
Target Actions
Search logs
View logs
Purge logs
Log management setup
Target Credentials
Required
Yes Yes
Full Role
Yes
Yes
Yes
Yes
Yes
Operator Role
Yes
Yes
Yes
Yes
Yes
Viewer Role
Management Actions
Target
Credentials
Required Full Role
Operator
Role Viewer Role Target Actions
Create PeopleSoft system (only super administrator)
Edit PeopleSoft system
Delete PeopleSoft system
View PeopleSoft system
Add PeopleSoft URL
Delete PeopleSoft URL
Edit PeopleSoft URL
Access PeopleSoft system URLs
Add PeopleSoft targets (super administrator)
Remove target
Yes, if target access granted
Yes
Yes
Yes
Yes
Yes, with target system privileges
Yes, if target access granted
Yes, if target access granted
Yes, if target access granted
Yes, if target access granted
Yes Yes
Yes, with target system privileges
Copyright © 2006, Oracle. All rights reserved.
107
Appendix B
108 Copyright © 2006, Oracle. All rights reserved.
A
PPENDIX
C
Target Log Files
This appendix lists default target log file locations and types.
Default Target Log Files
This section lists default log file locations and types for:
• PS PIA targets
• PS Application Server Domains
• PS Search Server Domains
• PS Process Scheduler Domains
PS PIA Log Files
This table lists PS PIA log file locations and log file types.
File Location
If using Weblogic: <PS_HOME>/webserv/<Domain>
/applications/peoplesoft/PSEMHUB/envmetadata/logs
If using WebSphere: <PS_HOME>/webserv/<cellname>_
<nodename>_<servername>/peoplesoft.ear/PSEMHUB
/envmetadata/logs
*.txt
<PS_HOME>/webserv/<Domain>/logs
<PS_HOME>/webserv/<Domain>/logs/replaydump
<OAS_HOME>/j2ee/<Domain>/log/<Domain>_default_ island_1/
*.log
*.bug
*.log
<WEBSPHERE_HOME>/logs/<server_name>
<WEBSPHERE_HOME>/logs
*.log
*.log
PS Application Server Domain Log Files
The PS Application Server Domain log directories and log file types are:
Log File Type
Copyright © 2006, Oracle. All rights reserved.
109
File Location
<PS_HOME>/appserv/<appserver_domain>/LOGS
<PS_HOME>/appserv/<appserver_domain>
*.LOG
TUXLOG.*
*.trc
*.tracesql
*.mps
*.lp
process_state*
*.dmp
peopletools_state*
ULOG.<date> stderr stdout core
Log File Type
<PS_HOME>/appserv
PS Search Server Domain Log Files
The PS Search Server Domain log directories and log file types are:
File Location
PS_HOME/appserv/search/DOMAIN_NAME/LOGS
PS_HOME/appserv/search/DOMAIN_NAME
PS_HOME/appserv
*.trc
*.LOG
*.log
*.lp
*.dmp
process_state* peopletools_state* stdout stderr
ULOG* core
Log File Type
PS Process Scheduler Server Log Files
The PS Process Scheduler Server Domain log directories and log file types are:
Appendix C
110 Copyright © 2006, Oracle. All rights reserved.
Appendix C
File Location
<PS_HOME>/appserv/
<PS_HOME>/appserv/prcs/<prcs_domain>/
<PS_HOME>/appserv/prcs/<prcs_domain>/LOGS/
<PS_HOME>/appserv/prcs/<prcs_domain>/log_output/
<PS_HOME>/appserv/prcs/<prcs_domain>/log_output/_
PSPRCSRVLOG/
<PS_HOME>/appserv/prcs/<prcs_domain>/log_output/_
PSDSTSRVLOG
<PS_HOME>/appserv/prcs/<prcs_domain>/log_output
/_TUXLOG/
<PS_HOME>/appserv/prcs/<prcs_domain>files/
*.*
*.*
*.* core stderr stdout
ULOG*
*.LOG
process_state* peopletools_state*
TUXLOG* delete_*.txt
*.*
Log File Type
Copyright © 2006, Oracle. All rights reserved.
111
Appendix C
112 Copyright © 2006, Oracle. All rights reserved.
A
PPENDIX
D
Target Policies
This appendix discusses:
• PS Application Server Domain policies
• The PS PIA policy
• PS Web Site policies
PS Application Server Domain Policies
This table lists the PS Application Server Domain policies:
Policy
Client Cleanup Timeout
PSAPPSRV Recycle Count
Enable Server Caching
PSQRYSRV Min Handler
Definition
The value should be <= 20 minutes. If it is greater than 20, a violation should be called out. Setting the value to 20 or less avoids having many idle client connections connected to the host. With client cleanup time out at a minimum value, it is a more effective use of the server’s memory and CPU and improves performance.
Warning
Warning
Severity
Value should be >= 5000. Setting this at zero or too low may cause memory swapping.
Recommend a setting of 2 to minimize the cost of recycling the application servers.
Set this to 1 if the PUBSUB server for the domain was activated.
Informational
Informational
PSBRKDSP Allowed Consec Service
Failures
Set to > 1 to enable the system to recycle on its own in an event of a service failure.
PSPUBDSP Allowed Consec Service
Failures
PSSUBDSP Allowed Consec Service
Failures
Set to > 1 to enable the system to recycle on its own in an event of a service failure.
Set to > 1 to enable the system to recycle on its own in an event of a service failure.
Informational
Informational
Informational
PSBRKHND Allowed Consec Service
Failures
Set to > 1 to enable the system to recycle on its own in an event of a service failure.
Informational
Copyright © 2006, Oracle. All rights reserved.
113
Appendix D
Policy Definition
PSPUBHND Allowed Consec Service
Failures
Set to > 1 to enable the system to recycle on its own in an event of a service failure.
PSSUBHND Allowed Consec Service
Failures
Set to > 1 to enable the system to recycle on its own in an event of a service failure.
Severity
Informational
Informational
PS PIA Policy
This table lists the PS PIA policy.
Policy
JVM Heap size
Definition
Minimum and maximum heap size should be set to equal and it should be >= 256MB
Warning
Severity Configuration File
SetEnv/opmn.xml
/server.xml
PS Web Site Policies
This table lists PS Web Site policies.
Policy
Ig.isc.serverURL
Ig.isc.toolsRel
Compress Responses
Compress Response
Reference
Cache Portal Objects
Definition
The application server and WSL port combination should relate to a valid application server domain whose PUBSUB feature is set to active or true.
Severity
Warning
The PeopleTools version specified should be equal to the PeopleTools version of the web server domain up to the patch level.
Warning
Informational Should be activated or set to true to enable faster transfer of transactional messages across the network.
Should be activated or set to true to activate the compression from the web server to browser.
Informational
Should be activated to improve system performance by reducing service requests from the web server to the application server.
Informational
Configuration File
IntegrationGateway.properties
IntegrationGateway.properties
Web Profile
Web Profile
Web Profile
114 Copyright © 2006, Oracle. All rights reserved.
Appendix D
Policy Definition
Cache Proxied Javascripts These should be set to true for improved performance.
Cache Target Contents
Cache homepage
Cache Generated HTML
METAXP
Severity
Informational
These should be set to true for improved performance.
These should be set to true for improved performance.
These should be set to true for improved performance.
Informational
Informational
Informational
Should be equal to Cache Stale
Interval. Cache Stale Interval value is seconds while METAXP is in minutes. So there should be a conversion that happens to detect a violation.
Warning
Configuration File
Web Profile
Web Profile
Web Profile
Web Profile
PeopleTools->
Personalization->
Personalization Options.
Option Category Level =
PPTL
Copyright © 2006, Oracle. All rights reserved.
115
Appendix D
116 Copyright © 2006, Oracle. All rights reserved.
A
PPENDIX
E
Target Relationships
This appendix discusses:
• Links that display on homepages
• Topology page relationships
Links That Display on Homepages
This table lists links that display on target homepages:
Link Displayed
Services Impacted
PS Application Database
PS Search Server
PeopleSoft System
Messaging Server
Windows Services Management
Where
Homepage of PS Application Server,
PS Process Scheduler, PS Search
Server, PS PIA, PS Web Site, PS App
DB
Homepage of PS Application Server,
PS Process Scheduler, PS Search
Server
PS Application Server homepage
Homepage of all targets
What It Means
Service test failure has been detected in a PeopleSoft system target.
Successful discovery of the PS
Application Database to which the target is connected.
Valid entry in the Remote Search
Server Credentials field (Search
Section) in an application server domain configuration (psappsrv.cfg
file that includes the domain ID, its fully qualified host name, and the search server port.
The target is an element of a
PeopleSoft system.
PS Application Server Administration page
Domain was created using a template
(small, medium, large or custom) with these default sections of PUBSUB:
PSBRKDSP_dflt, PSBRKHND_dlft,
PSSUBDSP_dlft, PSSUBHND_dlft,
PSPUBDSP_dlft, PSPUBHND_dlft
Administration page of PS Application
Server, PS Process Scheduler
Host operating system is Windows
Copyright © 2006, Oracle. All rights reserved.
117
Appendix E
Link Displayed
Manage Process Scheduler in PIA
PS Application Server
Web Sites
PS PIA
Reverse Proxy
Web Server Console
Web Profile
Integration Broker
PIA Signon
Where
PS Process Scheduler Administration page
PS Search Server homepage
PS PIA homepage
PS Web Site homepage
PS PIA homepage
PS PIA Administration page
PS Web Site Administration page .
PS Web Site Administration page
PS Web Site Administration page
What It Means
PS Process Scheduler Domain is an element in a PeopleSoft system and has a URL defined for it.
PS Search Server Domain
PSSRCHSRV section of configuration data has a valid entry for the application server credentials. The entry includes the domain ID, fully qualified host name and application server port (same value as the search server port).
Successful discovery of PS Web Site, contained in this PS PIA target.
Successful discovery of PS PIA in which the web site is contained.
Yes value means the target is connected to a reverse proxy server.
N/A value means the target is not connected to a reverse proxy server.
Reverse proxy server data comes from the web profile’s Virtual Addressing page.
PS PIA is an element in a PeopleSoft system and has a Web Server
Administration URL defined for it.
PS Web Site is an element of a
PeopleSoft system and has a Web
Profile URL defined for it.
PS Web Site is an element of a
PeopleSoft system and has a
Integration Broker URL defined for it.
PS Web Site is an element of a
PeopleSoft system and has a PIA
Signon URL defined for it.
Relationships on Topology Page
This table lists the target relationships shown on the topology page, and how they occur.
118 Copyright © 2006, Oracle. All rights reserved.
Appendix E
Topology Page Relationships
PS PIA and PS Web Site
PS Web Site and PS Application Server
PS Application Server and PS Search Server
PS Application Server and PS Application Database
PS Process Scheduler and PS Application Database
PS Search Server and PS Application Database
Established How
Defined by a discovery search on web server directories and paths.
Depends on the psserver value in the PS Web Site’s configuration.properties file. Valid entry is the application server’s fully qualified host name and its Jolt port.
Depends on the remote search server credentials value in the application server domain’s configuration
(psappsrv.cfg) file. Valid entry includes the search server’s domain ID, its fully qualified host name and the search server port.
Defined by the database GUID, which is generated when an application server connects to the database the first time.
Copyright © 2006, Oracle. All rights reserved.
119
Appendix E
120 Copyright © 2006, Oracle. All rights reserved.
Index
A
administration page common elements 28 target 28 alert history 28
automated PeopleSoft system 81
B
C
clean IPC resources 31 client status 31
compare domain configurations 29 compare to multiple configurations 29
template 55 configure domain 28, 55
creating a PS Process Scheduler target 63
creating a PS Search Server Domain target 76
creating PS Application Server targets 53
customize start/stop scripts 32
Copyright © 2006, Oracle. All rights reserved.
D
E
edit setEnv/ server.xml/ opmn.xml
(link) 32 edit web.xml (link) 32
Enterprise Manager grid control console 16
Enterprise Manager Grid Control Console accessing 23 initial use 23
Enterprise Manager homepage 24
environment set (check box) 43
environment variables set 44 table 44
F
G
get latest configuration template 55
H
121
Index
I
import domain configuration from file 55
installing the PeopleSoft Environment
L
last collected configuration 29
searching for strings 35 viewing 35
M
managing a Process Scheduler in PIA 65
modify OS group permissions of
N
O
122
Oracle Enterprise Manager, installing for
PeopleSoft Environment Management
Oracle Management Repository, installing
for PeopleSoft Environment Management
Oracle Management Service, installing for
PeopleSoft Environment Management
Oracle Technology Network (OTN) 1
P
parameters for purging log files 37
PeopleSoft Environment Management
Plug-in
installing extensions to the Oracle
installing Oracle Enterprise Manager 5
Oracle sources of additional information 1
PeopleSoft targets add 39 discovering 39
policies 28 policy settings 28 violations 28
Copyright © 2006, Oracle. All rights reserved.
administration 63 creating a target 63
PS Application Database configuration 49
PS Application Server administration 57
PS Search Server Domain administration 77
purge and archive schedule job 37
Q
Copyright © 2006, Oracle. All rights reserved.
R
removing PeopleSoft systems 84
S
schedule purge and archive jobs 37
searching for strings in log file 35
set environment variables 43, 44
super administrator accounts 23
T
Index
123
Index
V
W
WebSphere administration console 32
124 Copyright © 2006, Oracle. All rights reserved.
advertisement
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project