PeopleSoft Application Management Plug

PeopleSoft Application Management Plug

PeopleSoft Application Management

Plug-in 12.1.0.2.0 for Oracle

Enterprise Manager 12c Installation

September 2014

Installation Guide for Oracle’s Enterprise Manager for PeopleSoft 12.1.0.2.0

SKU PeopleSoft

_Application_Management_Plugin

_12.1.0.2.0_for_Oracle_Enterprise_Manager_12c_Installation_092014

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

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in 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 any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be errorfree. If you find any errors, please report them to us in writing.

Restricted Rights Notice

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

U.S. GOVERNMENT RIGHTS

Programs, software, databases, and related documentation and technical data delivered to U.S.

Government customers are “commercial computer software” or “commercial technical data” pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR

52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500

Oracle Parkway, Redwood City, CA 94065.

Hazardous Applications Notice

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

Third Party Content, Products, and Services Disclaimer

This software and documentation may provide access to or information on content, products and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third party content, products and services. Oracle

Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third party content, products or services.

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

Contents

Installing the Enterprise Manager for PeopleSoft 12.1.0.2 ........................................................................ 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 ........................................... 21

Installing Patches ................................................................................................................................. 22

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

Working with Enterprise Manager User Accounts ............................................................................... 23

Using the SYSMAN Super Administrator Account ........................................................................... 23

Creating Additional Super Administrator Accounts .......................................................................... 24

Creating Administrator Accounts for PeopleSoft Targets ................................................................. 24

Managing User Accounts on UNIX ................................................................................................... 24

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

Upgrading PeopleSoft Environment Management 11g to PeopleSoft Environment

Management 12c ................................................................................................................................. 29

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

Checking the Status of PeopleSoft Plug-in Installation ........................................................................ 30

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

Installing the Enterprise Manager for

PeopleSoft 12.1.0.2

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.

Upgrading PeopleSoft Environment Management 11g to PeopleSoft Environment

Management 12c

.

Checking the Status of PeopleSoft Plug-in Installation

.

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

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.52. The most current version of the Enterprise Manager for PeopleSoft can monitor and administer systems running previous PeopleTools releases, down to PeopleTools 8.52. 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.54 cannot be used to monitor and manage

PeopleTools servers running PeopleTools 8.55, 8.56, 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.

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

Enterprise Manager for PeopleSoft 12.1.0.1.0 Installation Guide

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

Pre-8.50 1. Single User User1: GID=dba

Installs Oracle EMAgent.

Installs PeopleTools.

Creates and manages server domains.

Installs Oracle EMAgent. 2. Two Users with Same

Primary Group

User1: GID=dba Pre-8.50

User2: GID=dba Installs PeopleTools.

Creates and manages server domains.

Installs Oracle EMAgent. 3. Two Users with Different

Primary Groups

User1: GID=dba,

OTHER=psft

User2: GID=psft,

OTHER=dba

Installs PeopleTools.

Creates and manages server domains.

Installs Oracle EMAgent.

8.50 and later

4. Multiple Users with Multiple

Primary Groups

User1: GID=dba,

OTHER=psft

Use2: GID=psft1,

OTHER=dba

User3: GID=psft2,

OTHER=dba

Installs PeopleTools.

Creates and manages server domains.

8.50 and later

See Also

Installing the Enterprise Manager for PeopleSoft 12.1.0.2.0, “Working with Enterprise Manager User

Accounts,” Managing User Accounts on UNIX]

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

Configurations"

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

PeopleTools PeopleBook 8.54: System and Server Administration, "Securing PS_HOME and

PS_CFG_HOME"

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.54 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.

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

Enterprise Manager for PeopleSoft 12.1.0.1.0 Installation Guide

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.54 version of Enterprise Manager for PeopleSoft for Oracle Enterprise

Manager, the certified version of Oracle Enterprise Manager is 12.1.0.3.

See Also

See Oracle Enterprise Manager Documentation Library for 12g Release 3 (12.1.0.3): 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:

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

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

.

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

Enterprise Manager for PeopleSoft 12.1.0.1.0 Installation Guide

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 15.4.4.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.

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

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.

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

Enterprise Manager for PeopleSoft 12.1.0.1.0 Installation Guide

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.

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

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.

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

Enterprise Manager for PeopleSoft 12.1.0.1.0 Installation Guide

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.3, 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.

16

2. From the Application folder select

Enterprise Manager for PeopleSoft and the select Actions, Deploy

On, Management Agents.

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

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.

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

Enterprise Manager for PeopleSoft 12.1.0.1.0 Installation Guide

18 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.

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.

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

4. Review the

Pre-requisite Checks screen and click Next.

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

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

Enterprise Manager for PeopleSoft 12.1.0.1.0

20

Installation Guide

5. Click

Deploy to initiate deployment.

On successful deployment, The Confirmation screen is displayed.

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

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.

Note. If you are in a version lower than 12.1.0.4, it is recommended to apply the EM 12.1.0.3.2

Patch Set (PSU) to the EM 12.1.0.3.0 base, so that they don’t hit the Plug-in removal issues.

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

Enterprise Manager for PeopleSoft 12.1.0.1.0 Installation Guide

Note. In the EM console, Systems page becomes blank after removing the PeopleSoft Plug-in.

The page will reappear after reinstalling PSFT Plug-in.

.

Installing Patches

This section discusses:

Installing Enterprise Manager for PeopleSoft Patches for OMS and 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.

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

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

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

Enterprise Manager for PeopleSoft 12.1.0.1.0

Creating Additional Super Administrator Accounts

Installation Guide

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:

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

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 psoft psoftn dba psft psft psft dba dba

Installs the EMAgent.

Installs PeopleSoft.

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

emagent psoft psoftsrvr

Primary Group

dba psft psft

Secondary Group

psft dba dba

Description

Installs the EMAgent.

Installs PeopleSoft.

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

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

Enterprise Manager for PeopleSoft 12.1.0.1.0

Setting Up sudo Access

Installation Guide

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.

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

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

Password

Confirm Password

Run as

Save As

Specifiy the user name.

Specify a password.

Confirm the password.

Specify the user name.

Need info.

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

Enterprise Manager for PeopleSoft 12.1.0.1.0 Installation Guide

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.

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

Enterprise Manager for PeopleSoft 12.1.0.2.0 Installation Guide

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 preexisting 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.

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

Enterprise Manager for PeopleSoft 12.1.0.1.0 Installation Guide

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;

Checking the Status of PeopleSoft Plug-in

Installation

After initiating the Plug-in deployment on OMS & Agent from EM console, you can run emctl or emcli command to determine the status of the deployment.

To check the status of the deployment after initiating the Plug-in on OMS:

The emctl command is used when OMS goes down at the time of deploying the Plug-in on

OMS.

OMS_HOME/bin/emctl status oms –details

When the OMS is up again you can use the below emcli command.

OMS_HOME/bin/emcli get_plugin_deployment_status -plugin_id=oracle.apps.psft

Note. If OMS has rebooted, then you need to login to emcli utility before running any other emcli command option.

OMS_HOME/bin/emcli login -username=sysman

• emcli utility need to be setup before using it for the first time. After installation of the EM 12c

OMS, you can verify if emcli is setup with your OMS by using the below command,

OMS_HOME/bin/emcli sync if emcli is not setup then you can setup by running the below command,

For example,

OMS_HOME/bin/emcli setup -url=https://slc00tev.us.oracle.com:7801/em -username=sysman

To check the status of the deployment after initiating the Plug-in on Agent:

You can check the Plug-in deployment on the Agent from the EM console itself. Alternately you can use emcli to check deployment status on Agent.

OMS_HOME/bin/emcli get_plugin_deployment_status -plugin_id=oracle.apps.psft

30 Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project