How To Administer PeopleSoft 9.2 Application on Virtual Box

by Prashant on May 16, 2013

in PeopleSoft Administration

When you deploy any PeopleSoft 9.2 Image on Virtual Box, it installs all the required components like Database, App server, Web server and Process Scheduler. Depending on your choice at the time of installation, SES can be configured too.

When you boot this virtual machine, it will start all the above mentioned components automatically and you just need to enter the PeopleSoft URL in the browser to access the PeopleSoft environment. This sounds good as there isn’t much administration to do. But there might be scenarios, when you want to administer PeopleSoft components to resolve some issues or for testing purposes. As this virtual machine has multiple ids which owns different components, this post will help you in administering the PeopleSoft 9.2 application installed on Virtual Box.

If you haven’t already installed PeopleSoft 9.2 Image on Virtual Box, you can follow this post to do the same and then head over to below post for further administration tasks.

Administering PeopleSoft Application Server  and Process Scheduler on Virtual Box

Using putty, connect to the VM machine ( you can get the IP by running ‘ifconfig’ command inside VM) and enter the root login details. Password for root was specified at the time of VM installation.

PS_CFG_HOME (PeopleSoft Configuration Home) is owned by psadm2 user, which means that you would need to use this id to administer PeopleSoft Application Server and Process Scheduler and edit any configuration files.

Note: To learn about all the different PeopleSoft Homes, read here.

After logged in as root, switch user to psadm2 using below command

sudo su – psadm2

image

Location of PS_CFG_HOME is /home/psadm2/psft/pt/8.53. This is where you will find the appserv directory and the default app server domain (APPDOM) configuration files.

Also Read:  PeopleTools 8.54: New Features in PeopleSoft Server Administration

Invoking psadmin to administer PeopleSoft Application Server Domain (APPDOM)

While logged in as psadm2 user, navigate to PS_HOME/appserv directory.

cd /opt/oracle/psft/pt/tools/appserv

Now invoke psadmin from here.

image

Enter 1 for ‘Application server’ (shown above) then press 1 again for ‘Administer a domain’

image

You will see a list of domain that can be administered. As PeopleSoft 9.2 Virtual application is configured with only one default app server domain, this list will have only one entry (APPDOM).

Enter ‘1’

Shutting down Application Server domain APPDOM

Choose ‘2’ to go to Domain shutdown menu.

image

Given the choose to do either a normal or forced shutdown. Choose as desired. In below screenshot I have chosen option 2 i.e Forced shutdown. As soon as you enter the option, shutdown of application server will process.

image

Once shutdown is finished, you will return to domain administration menu.

Starting Application Server domain APPDOM

In Domain Administration menu, choose ‘1’ i.e Boot this domain option and then enter 2 for doing a parallel boot of your application server domain APPDOM.

image

Once all the services will be up, you application server is ready to respond to request from PeopleSoft Webserver.

Editing Application Server Configuration file (psappsrv.cfg)

psappsrv.cfg for app server domain APPDOM can be found at /home/psadm2/psft/pt/8.53/appserv/APPDOM. If you need to edit application server configuration files, make sure you’re logged in as psadm2.

Managing PeopleSoft Process Scheduler

Similar to Application Server you can administer PeopleSoft Process Scheduler using option 2 for Process Scheduler.

image

Administering PeopleSoft 9.2 Webserver on Virtual Box

Invoke psadmin from PS_HOME/appserv directory using psadm2  user. Choose option 4 for ‘Web (PIA) server’.

Also Read:  Commands To Manage PIA on OAS WebServer

image

You will enter PeopleSoft PIA Administration menu now.  Enter 1 to choose ‘Administer a domain’.

image

It will show available domain that can be administered. Enter 1 for ‘peoplesoft’.

image

To check the status of this PIA domain enter ‘3’. It will take few seconds and then will display the status.

image

Shutdown PIA

In PeopleSoft PIA domain Administration menu, enter ‘2’

image

It will show the shutdown status and then return to admin menu again.

Starting PIA

In PeopleSoft PIA Administration Menu, enter 1 to boot the domain.

image

PeopleSoft Webserver domain will be started.

If you face any issue that you would like to share with the community, please add those to comment section below.

Read more: How To Install Application Designer from PeopleSoft Virtual Machine

{ 8 comments… read them below or add one }

qamarcpb May 9, 2014 at 3:29 pm

Hello Prasant,
I can login pia by ip address but not by host name or fqdn.

Any help will be appreciated.

Reply

Prashant May 12, 2014 at 10:16 pm

If VM network setting is host only (default) and you chose to enter a host name during Virtual Machine configuration then you need to make the entries in your local machine host file. e.g. While configuring VM, if you entered hostname as abc.pstut.com, then you need to make an entry in the C:\Windows\System32\drivers\etc\hosts file such as “192.168.56.101 abc.pstut.com” and save the file. Now if you try to access the VM PIA URL http://abc.pstut.com:8000/ps/signon.html, you should be able to access it.
Let me know.

Reply

Qamarcpb May 14, 2014 at 9:26 am

Prashant
You are awesome my brother I was beating my head since last do days to fix this. And this is so simple not sure it did click on my top. I really appreciate maintaining this site for all newbie to Oracle new Virtual Box world.

Thanks you so much.
Qamarcpb

Reply

Prashant May 15, 2014 at 3:23 pm

Thanks Qamarcpb. I’m glad this article helped. My goal achieved 🙂

Reply

Ricky November 10, 2016 at 4:28 pm

This really helped!!!

Reply

avi August 3, 2017 at 9:06 am

Is host file entry required for all people local system who are going to access the site?

Reply

Raj December 17, 2014 at 3:48 pm

Prashant,

Very informative and nice post. I think you might help me in resolving this typical issue.

I’m setting up Supplier Contract Management module, where in for rendering WORD file, we need to do few setups.

If you navigate to Supplier Contracts -> Supplier Contracts Setup -> Installation Options and then choose Supplier Contract Management, the first box asks to enter the Application Server Path.
Then following fields:
Compare/Render Server/Path:
Compare/Render Server URL:

Can you please guide me what I need to fill in here?

I’ve installed PeopleSoft FSCM images in Virtual Box. I’ve download the dump from PUM page on Oracle support site.

Thanks a million man !

Regards,
Raj

Reply

Simon Chiu June 10, 2015 at 8:42 am

this is great thanks Prashant!!

Reply

Cancel reply

Leave a Comment

Previous post:

Next post: