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


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:  Evolution of PS_HOME

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.


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


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.


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.


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.


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.


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:  PeopleTools 8.53: Installing PeopleTools 8.53.03 Patch


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


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


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


Shutdown PIA

In PeopleSoft PIA domain Administration menu, enter ‘2’


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.


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.


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, then you need to make an entry in the C:\Windows\System32\drivers\etc\hosts file such as “” and save the file. Now if you try to access the VM PIA URL, you should be able to access it.
Let me know.


Qamarcpb May 14, 2014 at 9:26 am

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.


Prashant May 15, 2014 at 3:23 pm

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


Ricky November 10, 2016 at 4:28 pm

This really helped!!!


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?


Raj December 17, 2014 at 3:48 pm


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 !



Simon Chiu June 10, 2015 at 8:42 am

this is great thanks Prashant!!


Cancel reply

Leave a Comment

Previous post:

Next post: