PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle...

29
PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c I Guide February 2013

Transcript of PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle...

Page 1: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application ManagementPlug-in 12.1.0.1 for Oracle EnterpriseManager 12c Install Guide

February 2013

Page 2: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c InstallGuideSKU PT853PLUGININSTGR0Copyright © 2006, 2013, Oracle and/or its affiliates. All rights reserved.

Trademark NoticeOracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarksof their respective owners.

License Restrictions Warranty/Consequential Damages DisclaimerThis software and related documentation are provided under a license agreement containing restrictionson use and disclosure and are protected by intellectual property laws. Except as expressly permittedin your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast,modify, license, transmit, distribute, exhibit, perform, publish or display any part, in any form, or by anymeans. Reverse engineering, disassembly, or decompilation of this software, unless required by law forinteroperability, is prohibited.

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

Restricted Rights NoticeIf this is software or related documentation that is delivered to the U.S. Government or anyone licensing iton behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integratedsoftware, any programs installed on the hardware, and/or documentation, delivered to U.S. Governmentend users are “commercial computer software” pursuant to the applicable Federal Acquisition Regulationand agency-specific supplemental regulations. As such, use, duplication, disclosure, modification,and adaptation of the programs, including any operating system, integrated software, any programsinstalled on the hardware, and/or documentation, shall be subject to license terms and license restrictionsapplicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications NoticeThis software or hardware is developed for general use in a variety of information managementapplications. It is not developed or intended for use in any inherently dangerous applications, includingapplications that may create a risk of personal injury. If you use this software or hardware in dangerousapplications, then you shall be responsible to take all appropriate failsafe, backup, redundancy, andother measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for anydamages caused by use of this software or hardware in dangerous applications.

Third Party Content, Products, and Services DisclaimerThis software or hardware and documentation may provide access to or information on content, productsand services from third parties. Oracle Corporation and its affiliates are not responsible for and expresslydisclaim all warranties of any kind with respect to third-party content, products, and services. OracleCorporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to youraccess to or use of third-party content, products, or services.

Page 3: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 3

Contents

Installing the Enterprise Manager for PeopleSoft 12.1.0.1.0 ..................................................................... 5

Defining Support for the PeopleSoft Environment Management Plug-in ............................................... 7

Considering User IDs for Installation ..................................................................................................... 7

Downloading the PeopleSoft Environment Management Plug-in Installation Software ........................ 9

Installing PeopleSoft Products ............................................................................................................... 9

Installing Oracle Enterprise Manager ..................................................................................................... 9

Installing Enterprise Manager for PeopleSoft on the Oracle Management Service and Oracle Management Agent .............................................................................................................................. 10

Installations Performed by the Same User on Management Agent ................................................. 10

Installations Performed by Different Users ....................................................................................... 11

Understanding the PeopleSoft Environment Management Plug-in Installation ............................... 11

Installing the Enterprise Manager for PeopleSoft on the Oracle Management Server and Management Agent .......................................................................................................................... 12

Uninstalling Enterprise Manager for PeopleSoft from OMS and Agent ........................................... 20

Installing Patches ................................................................................................................................. 20

Installing Enterprise Manager for PeopleSoft Patches for OMS and Agent ..................................... 21

Working with Enterprise Manager User Accounts ............................................................................... 22

Using the SYSMAN Super Administrator Account ........................................................................... 22

Creating Additional Super Administrator Accounts .......................................................................... 23

Creating Administrator Accounts for PeopleSoft Targets ................................................................. 23

Managing User Accounts on UNIX ................................................................................................... 23

Ensuring Oracle EMAgent Privileges on Windows Hosts ................................................................ 27

Upgrading PeopleSoft Environment Management 11g to PeopleSoft Environment Management 12c ............................................................................................................................................................. 28

Post- Upgrade Operations for PeopleSoft Plug-in ........................................................................... 28

Page 4: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter
Page 5: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 5

Installing the Enterprise Manager for PeopleSoft 12.1.0.1.0 This document discusses:

• Defining Support for the Enterprise Manager

• Considering User IDs for Installation.

• Downloading the Enterprise Manager for PeopleSoft Installation Software.

• Installing PeopleSoft Products.

• Installing Oracle Enterprise Manager (OMS) and Management Agent.

• Installing Enterprise Manager for PeopleSoft on the Oracle Management Service and Management Agent.

• Installing Patches.

• Working with Enterprise Manager User Accounts.

Page 6: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter
Page 7: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 7

Defining Support for the PeopleSoft Environment Management Plug-in Oracle’s Enterprise Manager for PeopleSoft allows you to use the Oracle Enterprise Manager to monitor and manage your PeopleSoft servers from a centralized administrative interface.

The Enterprise Manager for PeopleSoft enables you to discover, monitor, and manage PeopleSoft system components, including application server domains, Process Scheduler domains, search server domains, PIA installations, and use Process Monitor on all of the platforms supported by PeopleSoft applications.

The Enterprise Manager for PeopleSoft is compatible with at least Oracle PeopleTools 8.51. The most current version of the Enterprise Manager for PeopleSoft can monitor and administer systems running previous PeopleTools releases, down to PeopleTools 8.51. Earlier versions of the Enterprise Manager for PeopleSoft cannot be used to monitor and administer later releases. For example, the Enterprise Manager for PeopleSoft provided for PeopleTools 8.53 cannot be used to monitor and manage PeopleTools servers running PeopleTools 8.54, 8.55, and so on.

Considering User IDs for Installation When setting up Oracle’s Enterprise Manager for PeopleSoft, you install various elements of the system on different machines, with some of the elements belonging to the Oracle Environment Management product and some belonging to the Enterprise PeopleTools product.

Before performing these installation tasks, take a moment to consider the user IDs that you will use. Beginning with Oracle PeopleTools 8.50, PS_HOME can be configured to be read-only for additional security. In this configuration, the configuration files and other ’writable’ files, like log files, are stored in a separate location, referred to as the PS_CFG_HOME. Keeping track of which users has write access or not and where output files need to be sent is essential.

Page 8: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

8 Copyright ©2011, Oracle and/or its affiliates. All rights reserved.

The following table provides some sample scenarios of how user IDs can be managed based on Enterprise Manager for PeopleSoft releases.

The following table provides some sample scenarios of how user IDs can be managed based on PeopleSoft Environment Management Plug-in releases.

Note. In pre-PeopleTools 8.50 releases, user IDs needed to belong to the same primary group. In the current release of PeopleSoft Environment Management Plug-in, this is not a restriction.

Scenario User(s) Action Performed Applicable Releases

1. Single User User1: GID=dba Installs Oracle EMAgent. Installs PeopleTools. Creates and manages server domains.

Pre-8.50

2. Two Users with Same Primary Group

User1: GID=dba Installs Oracle EMAgent. Pre-8.50

User2: GID=dba Installs PeopleTools.

Creates and manages server domains.

3. Two Users with Different Primary Groups

User1: GID=dba, OTHER=psft

Installs Oracle EMAgent. 8.50 and later

User2: GID=psft, OTHER=dba

Installs PeopleTools.

Creates and manages server domains.

4. Multiple Users with Multiple Primary Groups

User1: GID=dba, OTHER=psft

Installs Oracle EMAgent. 8.50 and later

Use2: GID=psft1, OTHER=dba

Installs PeopleTools.

User3: GID=psft2, OTHER=dba

Creates and manages server domains.

See Also

Installing the Enterprise Manager for PeopleSoft 12.1.0.1.0, “Working with Enterprise Manager User Accounts,” Managing User Accounts on UNIX]

PeopleTools PeopleBook 8.53: System and Server Administration, "Working with Server Domain Configurations"

PeopleTools PeopleBook 8.53: System and Server Administration, "Securing PS_HOME and PS_CFG_HOME"

Page 9: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 9

Downloading the PeopleSoft Environment Management Plug-in Installation Software Download the software discussed in this chapter from the Oracle Software Delivery Cloud site.

To download the Enterprise Manager for PeopleSoft software:

Download the binary from the OracleStore. Open http://docs.oracle.com/cd/E24628_01/doc.121/e24473/plugin_mngr.htm#CHDBGHFE and follow the instructions provided there.

Or

Download the binary from edelivery.

Installing PeopleSoft Products If you are setting up the Enterprise Manager for PeopleSoft, it is assumed that you already have an installed PeopleSoft system. If not, you need to first install Oracle PeopleTools and applicable PeopleSoft applications. Refer to the PeopleTools and PeopleSoft application installation guides for detailed steps, if needed.

The installed PeopleSoft databases and servers will become the targets you manage using Oracle Enterprise Manager and the PeopleSoft Enterprise Manager Plug-in.

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 platforms are supported as targets. All databases supported by PeopleTools are supported by the Enterprise Manager for PeopleSoft.

See Also

PeopleTools 8.53 Installation Guide <for your database platform>

Installing Oracle Enterprise Manager Oracle Enterprise Manager includes the Oracle Management Agent and the Oracle Management Service (OMS). The installation documentation for Oracle Enterprise Manager 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.

Page 10: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

10 Copyright ©2011, Oracle and/or its affiliates. All rights reserved.

These installation instructions describing the steps for setting up the Enterprise Manager for PeopleSoft assume you already have Oracle Enterprise Manager installed and functioning at your site and that you are installing the Enterprise Manager for PeopleSoft, additionally, to monitor and manage your installed PeopleSoft servers.

For information about upgrading from EM 11g to EM 12c, refer to Upgrading EM11g to EM 12c.

Note. For the PeopleTools 8.53 version of Enterprise Manager for PeopleSoft for Oracle Enterprise Manager, the certified version of Oracle Enterprise Manager is 12.1.0.2.0.

See Also

See Oracle Enterprise Manager Documentation Library for 12g Release 2 (12.1.0.2.0): http://docs.oracle.com/cd/E24628_01/index.htm

Oracle Enterprise Manager Downloads: http://www.oracle.com/technetwork/oem/grid-control/downloads/index.html

Oracle Software Delivery Cloud: https://edelivery.oracle.com

Oracle PeopleTools Certifications: My Oracle Support, Certifications, PeopleSoft Enterprise, Tools and Technology

Note. When installing on UNIX, if the env variable is not being set correctly, the Oracle Enterprise Manager installation can fail.

Installing Enterprise Manager for PeopleSoft on the Oracle Management Service and Oracle Management Agent You can install Enterprise Manager for PeopleSoft on OMS and Agent from the same installer. You can install the agent to a remote host using the Agent software download from the EM Console and using to the appropriate host.

This section provides an overview and covers:

• Installing the Enterprise Manager for PeopleSoft on the OMS and Agent.

• Uninstalling the Enterprise Manager for PeopleSoft from the OMS and Agent.

Installations Performed by the Same User on Management Agent The recommended way to install the Management Agent for Windows environments is to have the same operating system user install both the Management Agent and the PeopleSoft PS_HOME directories.

This eliminates any potential issues involving:

Page 11: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 11

• 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 Performed by Different Users Performing installations using different users for the Oracle Enterprise Manager and PeopleSoft systems is the recommended approach for UNIX/Linux environments, but can also apply to Windows environments.

For UNIX and Linux, managing multiple user accounts on UNIX is discussed in detail in another section in the PeopleSoft Enterprise Environment Management Plug-in for Oracle Enterprise Manager Implementation Guide.

See PeopleSoft Enterprise Environment Management Plug-in for Oracle Enterprise Manager Implementation Guide, "Working with Enterprise Manager User Accounts," Managing User Accounts on UNIX

For Windows, 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.

Understanding the PeopleSoft Environment Management Plug-in Installation 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.

Note. The PeopleSoft Environment Management Plug-in extensions that you install can be downloaded from Oracle Software Delivery Cloud at the URL: https://edelivery.oracle.com.

Page 12: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

12 Copyright ©2011, Oracle and/or its affiliates. All rights reserved.

Installing the Enterprise Manager for PeopleSoft on the Oracle Management Server and Management Agent Installing Enterprise Manager for PeopleSoft involves the following steps:

1. Download the PeopleSoft Plug-in OPAR from Self Update Home page or Oracle e-delivery.

Note. Open http://docs.oracle.com/cd/E24628_01/doc.121/e24473/plugin_mngr.htm#CHDBGHFE and follow the instructions provided in the section 22.4.3.2 Downloading Plug-Ins in Offline Mode if you are downloading from edelivery.

2. Deploy PeopleSoft Plug-ins

Deploying PeopleSoft Plug-ins

Before you deploy PeopleSoft Plug-in on Environment Management 12 c, ensure that the Oracle Management Server and the Oracle Management Agent are running. You must first deploy the Enterprise Manager for PeopleSoft on the Management Server and then deploy on the Management Agent. You can deploy the PeopleSoft Plug-in from the Enterprise Manager Console.

To deploy the Enterprise Manager for PeopleSoft on OMS from the Environment Management Console:

1. In the Oracle Enterprise Manager Cloud Control 12 console, select Setup, Extensibility, Plug-ins.

The Plug-ins page displays the list of all plug-ins that are imported.

2. From the Application folder select Enterprise Manager for PeopleSoft and then select Actions, Deploy On, Management Servers.

The Deploy Plug-ins on Management Server window is displayed.

Page 13: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 13

3. In the Deploy Plug-ins on Management Server – General screen,

a. Choose the EM Plug-in version from the Version list.

b. Enter the Enterprise Manager repository password in the Repository SYS Password field.

c. Click Continue.

This triggers a pre-requisite validation. The Enterprise Manager for PeopleSoft validates the privileges of the user, the Plug-in deployment requirements, and the connection to the Management Server.

Page 14: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

14 Copyright ©2011, Oracle and/or its affiliates. All rights reserved.

4. Review the Pre-requisite Checks screen and click Next.

The Deploy Plug-ins on Management Server – Review screen is displayed.

Note. You will get an error message if the pre-requisite check fails, You can also see the error log in the GC_INSTANCE_HOME/sysman/log/*.log and *.trc files on the management Server.

Page 15: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 15

5. On the Review screen, check the Have you backed up the repository and configuration of the first management server? check box. Click Deploy to initiate deployment.

On successful deployment, The Confirmation screen is displayed.

Page 16: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

16 Copyright ©2011, Oracle and/or its affiliates. All rights reserved.

6. Note the command that is displayed on the screen and click Close.

Note. If deployment is successful, you will notice the PeopleSoft plug-in oracle.apps.psft.oms.plugin_12.1.0.1.0, deployed under Middleware Home - MW_HOME/plugins folder. For example, /ds1/home/emagent/Oracle/Middleware/plugins.

7. Run this command to check the deployment status,

• ( When the OMS is up after deployment) emcli get_plugin_deployment_status -plugin_id=oracle.apps.psft

• ( When the OMS is down during deployment) emctl status oms –details

1. To deploy Enterprise Manager for PeopleSoft on Management Agent from the Enterprise Manager Console:In the Oracle Enterprise Manager Cloud Control 12 c console, select Setup, Extensibility, Plug-ins.

The Plug-ins page displays the list of all plug-ins that are imported.

2. From the Application folder select Enterprise Manager for PeopleSoft and the select Actions, Deploy On, Management Agents.

Page 17: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 17

The Deploy Plug-ins on Management Agents window is displayed.

3. In the Deploy Plug-ins on Management Agent – General screen,

a. Choose the EM Plug-in version from the Version list.

b. Select the management agent where you want to deploy the plug-in from the Management Agent list. You can also add a Management Agent if the Agent is not displayed in the Management Agent list.

Optional) To add a Management Agent:

i. Click the button. The Search and Select: Targets – Oracle Enterprise Manager dialog box appears.

ii. You can initiate search either by Target Type, Target Name, or On Host.

iii. Click Search.

Select the target and then click Select.

c. Select the Agent and then click Continue.

Page 18: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

18 Copyright ©2011, Oracle and/or its affiliates. All rights reserved.

This triggers a pre-requisite validation. The Enterprise Manager for PeopleSoft validates the privileges of the user, the conditions of the plug-in deployment, and the connection to the Management Server.

4. Review the Pre-requisite Checks screen and click Next.

The Deploy Plug-ins on Management Agent – Review screen is displayed.

Page 19: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 19

5. Click Deploy to initiate deployment.

On successful deployment, The Confirmation screen is displayed.

Page 20: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

20 Copyright ©2011, Oracle and/or its affiliates. All rights reserved.

6. Note the command that is displayed on the screen and click Close.

7. Run this command from OMS_HOME to check the deployment status,

emcli get_plugin_deployment_status -plugin_id=oracle.apps.psft

Uninstalling Enterprise Manager for PeopleSoft from OMS and Agent There is no process to uninstall the repository components of the Enterprise Manager for PeopleSoft on the OMS side. If the installation process fails for any reason, you need to uninstall the plug-in using the following steps before reattempting the installation.

1. Uninstalling the Enterprise Manager for PeopleSoft From EM Console, select Setup, Extensibility, Plug-ins.

2. On the Plug-ins page, select Actions, Undeploy From, Management Agents to undeploy from OMS.

3. On the Plug-ins page, select Actions, Undeploy From, Management Servers to undeploy from OMS.

.

Installing Patches This section discusses:

Page 21: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 21

• Installing Enterprise Manager for PeopleSoft Patches for OMS.

• Installing Patches for Management Agent.

Installing Enterprise Manager for PeopleSoft Patches for OMS and Agent

• Download patches. • Install patches. You must download the Readme document from the same location from where

you have downloaded the patch. Follow the instruction given in the Readme document to install the patch.

Use the instructions in this section to download patch sets from the FTP site.

To download patches

1. Log on to http://aru.us.oracle.com/

2. Select the Patches , 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.

9. Double-click and download the patch in the next screen.

Page 22: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

22 Copyright ©2011, Oracle and/or its affiliates. All rights reserved.

Working with Enterprise Manager User Accounts This section discusses:

• Using the SYSMAN Super Administrator Account.

• Creating Additional Super Administrator Accounts.

• Creating Administrator Accounts for PeopleSoft Targets.

• Managing User Accounts on UNIX.

• Ensuring Oracle EMAgent Privileges on Windows Hosts.

Using the SYSMAN Super Administrator Account The Enterprise Manager Cloud 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 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.

Note. 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 user name 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.

To access Enterprise Manager Grid Control, use one of the following URLs to log in to the Grid Control Console:

https://<Oracle Management Service_hostname>.<domain>:<port>/em

For example:

https://machine_host.bigcompany.com:1159/em

Page 23: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 23

Creating Additional Super Administrator Accounts

Note. Enterprise Manager’s online help has detailed instructions for creating administrator accounts. Access the Setting Up Enterprise Manager directory of the online help.

To create a new Super Administrator account:

1. Click Setup the menu item on the Enterprise Manager Cloud Control page.

2. Select Security, Administrators.

The Enterprise Manager Configuration, Administrators page appears.

3. Click Create.

The Create Administrator: Properties page appears.

4. Enter information in the required fields, select the Super Administrator check box, and click Next.

5. On the Create Administrator <name>: Review page, review your choices, and click Finish.

Creating Administrator Accounts for PeopleSoft Targets An administrator account can perform all administrative actions for PeopleSoft targets except discovery, create domain, setting environment variables, and setting up the PeopleSoft system.

To create an administrator account:

1. Login as Super Administrator, such as SYSMAN.

2. Select Setup, Security, Administrators.

3. Click Create.

4. On the Create Administrator: Properties page, enter the name, password, and email address, and deselect Super Administrator.

5. On the Create Administrator: System Privileges page, select the appropriate privileges.

6. On the Create Administrator: Targets page, select the targets you want this account to administer.

7. On the Create Administrator: Target Privileges page, set the privilege to Full enabling the user account to manage the target.

8. On the Create Administrator: Review page, double-check your selections, and click Finish.

Managing User Accounts on UNIX This section describes user account topics applicable to UNIX implementations, including:

Page 24: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

24 Copyright ©2011, Oracle and/or its affiliates. All rights reserved.

• Setting Up EMAgent and PeopleSoft for Multi-user Installations

• Setting Up EMAgent and PeopleSoft for Secure PS_HOME

• Setting Up sudo Access

• Setting Up Power Broker Access

• Selecting Preferred Delegation Settings

Setting Up EMAgent and PeopleSoft for Multi-user Installations

The user installing EMAgent must be a member of the dba group. The implementation of the PeopleSoft Plug-in for Enterprise Manager requires you to create and maintain separate EMAgent and PeopleSoft users for UNIX. The users do not need to belong to the same primary group (gid).

The following table provides a sample framework illustrating how you can manage user accounts for UNIX.

User Primary Group Secondary Group Description

emagent dba psft Installs the EMAgent.

psoft psft dba Installs PeopleSoft.

psoftn psft dba Installs n additional PeopleSoft installations.

Setting Up EMAgent and PeopleSoft for Secure PS_HOME

In a secure PS_HOME environment, where PS_HOME and PS_CFG_HOME are decoupled, the PeopleSoft application can be installed by one user and the server domains can be created by another user.

This involves three or more UNIX users and two groups. The following table provides a sample framework.

User Primary Group Secondary Group Description

emagent dba psft Installs the EMAgent.

psoft psft dba Installs PeopleSoft.

psoftsrvr psft dba Installs PeopleSoft server domains, such as application server, Process Scheduler server, and search server.

Page 25: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 25

Setting Up sudo Access

Sudo access can be useful for performing administrative tasks like Start, Stop, and Configure for PeopleSoft targets with a single host user. This host user can be set up to have all privileges for PeopleSoft users.

To set up sudo access:

1. Create a new user (or set up the emagent user) to have sudo access for the psoft user.

2. For example, create user psoftsudo assigned to psft primary group and dba secondary group.

3. Verify if sudo is installed on the UNIX server.

Execute following command:

$> which sudo

Install sudo if necessary.

4. Add user entries to the sudoers file.

Use this syntax:

<User1> ALL = (<User2>/<User3>) ALL

For example:

emagent ALL = (psoft) ALL

or

psoftsudo ALL = (psoft) ALL

5. Verify if sudo access has been granted for the user.

a. Start telnet with the emagent user.

b. Submit the following command:

$> sudo -u psoft id

c. Provide the user password when prompted.

d. Verify the <id> output of the psoft user.

Note. Add this variable in addition to the default env_keep variable, Defaults env_keep = " EMHOME JAVA_HOME PLUGIN_ROOT EMDROOT DISC_ROOT IS_PS_PLT LIBPATH LD_LIBRARY_PATH SHLIB_PATH"

Setting Up Power Broker Access

A Power Broker account can be set up and accessed using the same procedure as setting up sudo access.

Page 26: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

26 Copyright ©2011, Oracle and/or its affiliates. All rights reserved.

Selecting Preferred Delegation Settings

To configure Preferred Delegation settings:

1. Login to Enterprise Manager console as a Super Administrator.

2. Select Setup, Security, Privilege Delegation.

3. Verify that the desired host is displayed in the list and status Shows indicated ’Up’.

4. Click the "Pencil" icon in the Edit column for your host.

5. On Host Privilege Delegation Setting page, select the Sudo or PowerBroker radio button.

6. Enter the appropriate information for Sudo or PowerBroker:

For Sudo enter Sudo command as:

/bin/sudo -u %RUNAS% %COMMAND%

Provide the absolute path for sudo.

For PowerBroker enter the PowerBroker Password Prompt and enter the PowerBroker command as:

/bin/pbrun -l -u %RUNAS% %COMMAND%

7. Click Update.

8. Select Setup, Security, Preferred Credentials from the right-hand corner of the screen.

9. From the Target Preferred Credentials section, choose a Target Name. The Credential Set must be Normal Host credentials.

10. Click the set button.

11. In the Select Named Credentials dialog box, enter these details,

Fields Description

Credential Select New.

UserName Specifiy the user name.

Password Specify a password.

Confirm Password Confirm the password.

Run as Specify the user name.

Save As Need info.

Page 27: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 27

Ensuring Oracle EMAgent Privileges on Windows Hosts Confirm that the Oracle EMAgent user has the appropriate access rights on Windows.

To configure the Oracle EMAgent user on Windows hosts:

1. Ensure that EMAgent is added to the Administrators Group.

2. Ensure that EMAgent has these options as part of the local policy (Control Panel, Administrative Tools, Local Security Policy, Local Policies, User Rights Assignment):

• Act as part of the operating system.

• Adjust memory quotas for a process.

• Log on as batch job.

• Replace a process level token.

Page 28: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

28 Copyright ©2011, Oracle and/or its affiliates. All rights reserved.

Upgrading PeopleSoft Environment Management 11g to PeopleSoft Environment Management 12c You can upgrade Oracle’s Enterprise Manager for PeopleSoft 11g (certified with PSFT Plug-in 8.51.0.1.0 & 8.52.0.1.0) to EM 12c without losing any metric and configuration information. The targets that are discovered and monitored through 11g will be retained after upgrading to 12c.You can upgrade to EM12c using any one of these 3 approaches,

• 1-System Upgrade • 2-System Upgrade • 1-System Upgrade with different host

For more information about upgrading to EM 12c refer to the Upgrade Guide here, http://download.oracle.com/docs/cd/E24628_01/nav/portal_booklist.htm.

Post- Upgrade Operations for PeopleSoft Plug-in

1. Set up the preferred credential for each host target on which the targets are monitored. 2. From the EM console, setup the preferred credentials and monitoring credentials for each pre-

existing PeopleSoft target monitored. Note: You can also setup the preferred credentials using using emcli utility. For example, emcli set_preferred_credential -set_name=HostCreds -target_name=peoplesoft.pia.<machinename>.ds1_home_psoft_ptbuilds_pt852 -target_type=ps_pia -credential_name=peoplesoft.pia. <machinename>..ds1_home_psoft_ptbuilds_pt852 emcli set_monitoring_credential -target_name=peoplesoft.pia. <machinename>.q.ds1_home_psoft_ptbuilds_pt852 -target_type=ps_pia -set_name=PsoftHostCreds -cred_type=PsoftHostCreds -attributes="HOST_USERNAME:psoft;HOST_PASSWORD:psoft" For more information, refer to Oracle Enterprise Manager Command Line Interface 12c.

3. Post configuration actions of EM 12c are initiated after the first discovery. If discovery is not triggered, you must manually create this folder structure to retain and monitor the Agent logs:

• USER_HOME/psft/pt/emplugin • USER_HOME/psft/pt/emplugin/log • Create two files psemagent.log and psemagent.trc

Note. The Agent logs on the host will not be created if you do not set this folder structure.

Page 29: PeopleSoft Application Management Plug-in 12.1.0.1 for ... · Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c IQVWDOO Guide ... Download the software discussed in this chapter

PeopleSoft Application Management Plug-in 12.1.0.1 for Oracle Enterprise Manager 12c Install Guide

Copyright © 2013, Oracle and/or its affiliates. All rights reserved 29

4. For PeopleSoft System instances migrated through upgrade to appear in EM 12c console,connect to EM Repository as sysman user and run this sync up command for each PeopleSoft System and then restart the OMS. The PeopleSoft Systems should then appear under System menu.

exec mgmt_system.sync_up_system('<PeopleSoft System Instance Name>','PS_SYSTEM');

For example, SQL> exec mgmt_system.sync_up_system(''QE852GA.pssystem.10488492-e9b3-11e0-a6ed-b5795cdb78eb'','PS_SYSTEM');

PL/SQL procedure successfully completed.

SQL> commit;