Peopletools 8.52 : managing PIA with psadmin

Peopletools 8.52 introduces new options in the psadmin menu, that’s rather interesting to see. Let’s see the PIA part, totally new here.
It can be managed within the command line
[ptools852@orion5 appserv]$ ./psadmin -help
Usage:

Miscellaneous options:
----------------------
  psadmin                              (Interactive utility)
  psadmin -h                           (Display this message)
  psadmin -v                           (Display version number)
  psadmin -env                         (Display environment as set by psadmin)
  psadmin -replicate -ch <PS_CFG_HOME>

Pure Internet Architecture (PIA) Options:
-----------------------------------
  psadmin -w command -d domain       (Perform command on PIA domain)
    where 'command' must be one of the following:
             start     (Start the domain)
             shutdown  (Shutdown this domain)
             shutdown! (Forced shutdown of this domain)
             status    (Show status for this domain)
             remove    (Delete the domain)

  psadmin -w configure -d domain -c c_set -p p_set
    where 'c_set' specifies domain settings, having the following format:
          minHeapSize/maxHeapSize/maxThreads/authTokenDomain
      and 'p_set' specifies port settings, having the following format:
          httpPort/httpsPort

  psadmin -w configure -d domain -s site -c c_set
    where 'c_set' specifies site settings, having the following format:
          appSrvConnString/webProfile/pooling/reportPath/webProfUser/webProfPword/appSrvConnPword
<…snipped…>

Or within the menu
[ptools852@orion5 appserv]$ env|grep PIA_HOME
PIA_HOME=/appl/psoft/hcm91fp1_web
[ptools852@orion5 appserv]$ env|grep CFG_HOME
PS_CFG_HOME=/appl/psoft/hcm91fp1_dom
[ptools852@orion5 appserv]$ ./psadmin

PSADMIN -- Tools Release: 8.52.02
Copyright (c) 1996, 2011, Oracle. All rights reserved.

--------------------------------
PeopleSoft Server Administration
--------------------------------

  Config Home:  /appl/psoft/hcm91fp1_dom

  1) Application Server
  2) Process Scheduler
  3) Search Server
  4) Web (PIA) Server
  5) Switch Config Home
  6) Replicate Config Home
  q) Quit

Command to execute (1-6, q): 4

-----------------------------
PeopleSoft PIA Administration
-----------------------------

  PIA Home:   /appl/psoft/hcm91fp1_web

  1) Administer a domain
  2) Create a domain
  3) Delete a domain

  q) Quit

Command to execute:

=> Let’s create a new web domain for my new Peopletools 8.52 installation.
[ptools852@orion5 appserv]$ ./psadmin

PSADMIN -- Tools Release: 8.52.02
Copyright (c) 1996, 2011, Oracle. All rights reserved.

--------------------------------
PeopleSoft Server Administration
--------------------------------

  Config Home:  /appl/psoft/hcm91fp1_dom

  1) Application Server
  2) Process Scheduler
  3) Search Server
  4) Web (PIA) Server
  5) Switch Config Home
  6) Replicate Config Home
  q) Quit

Command to execute (1-6, q): 4

-----------------------------
PeopleSoft PIA Administration
-----------------------------

  PIA Home:   /appl/psoft/hcm91fp1_web

  1) Administer a domain
  2) Create a domain
  3) Delete a domain

  q) Quit

Command to execute: 2

---------------------------------------------
PeopleSoft PIA Administration - Create Domain
---------------------------------------------

  PIA Home: /appl/psoft/hcm91fp1_web

  1) Create a domain
  2) Replicate a domain

  q) Quit

Command to execute: 1

---------------------------------------------
PeopleSoft PIA Administration - Create Domain
---------------------------------------------

  PIA Home:   /appl/psoft/hcm91fp1_web

  1)  Domain name                  :[peoplesoft]
  2)  Web server                   :[weblogic]
  3)  Web server root directory    :[/opt/oracle]
  4)  Web server login id          :[system]
  5)  Web server password          :[Passw0rd]
  6)  Website name                 :[ps]
  7)  Application server           :[orion5.phoenix.nga]
  8)  JSL Port                     :[9000]
  9)  HTTP Port                    :[80]
  10) HTTPS Port                   :[443]
  11) Authentication Token Domain  :[]
  12) Web profile                  :[PROD]
  13) Web profile user id          :[PTWEBSERVER]
  14) Web profile password         :[PTWEBSERVER]
  15) PeopleSoft reports directory :[/appl/psoft/hcm91fp1_web]

  c) Create the domain as shown
  q) Quit

Command to execute:

Note that some strange behavior, especially when changing the Web Profile, when enter 12 as command to execute, it switches to the next one instead of prompting, it means you have to enter “12” until reaching the expected web profile.
---------------------------------------
PeopleSoft PIA Administration - Create Domain
---------------------------------------------

  PIA Home:   /appl/psoft/hcm91fp1_web

  1)  Domain name                  :[peoplesoft]
  2)  Web server                   :[weblogic]
  3)  Web server root directory    :[/appl/mdlware/weblogic]
  4)  Web server login id          :[system]
  5)  Web server password          :[Passw0rd]
  6)  Website name                 :[hcm91fp1]
  7)  Application server           :[orion5.phoenix.nga]
  8)  JSL Port                     :[9000]
  9)  HTTP Port                    :[8000]
  10) HTTPS Port                   :[8443]
  11) Authentication Token Domain  :[]
  12) Web profile                  :[DEV]
  13) Web profile user id          :[PTWEBSERVER]
  14) Web profile password         :[PTWEBSERVER]
  15) PeopleSoft reports directory :[/appl/psoft/hcm91fp1_web/reports/hcm91fp1]

  c) Create the domain as shown
  q) Quit

Command to execute: c

Creating the domain. This may take several minutes, please be patient.
..............................................................
The domain has been created

-----------------------------
PeopleSoft PIA Administration
-----------------------------

  PIA Home:   /appl/psoft/hcm91fp1_web

  1) Administer a domain
  2) Create a domain
  3) Delete a domain

  q) Quit

Command to execute: 1

------------------------------------------------------
PeopleSoft PIA Domain Administration - Choose a Domain
------------------------------------------------------

  1) peoplesoft

  q) Quit

Command to execute: 1

------------------------------------
PeopleSoft PIA Domain Administration
------------------------------------

  PIA Home:      /appl/psoft/hcm91fp1_web
  PIA Domain:    peoplesoft

  1) Boot this domain
  2) Shutdown this domain
  3) Get the status of this domain
  4) Configure this domain
  5) Edit configuration files
  6) View log files
  7) Administer a site
  8) Delete a site

  q) Quit

Command to execute: 1

Starting the domain.....
Server state changed to STARTING..............
Server state changed to STANDBY.
Server state changed to STARTING.............
Server state changed to ADMIN.
Server state changed to RESUMING.
Server state changed to RUNNING.
Verifying domain status......
The domain has started.

Now, I’m a bit struggled with the variable PIA_HOME, it appears not working afterwards until and unless I set PS_CFG_HOME=$PIA_HOME. Or maybe I did not understood very well that variable usage.
Anyway, with command line everything become much simpler than ever to start the entire street :
[ptools852@orion5 ~]$ cd $PS_HOME/appserv
[ptools852@orion5 appserv]$ env|grep PIA_HOME
PIA_HOME=/appl/psoft/hcm91fp1_web
[ptools852@orion5 appserv]$ env|grep PS_CFG_HOME
PS_CFG_HOME=/appl/psoft/hcm91fp1_dom
[ptools852@orion5 appserv]$ ./psadmin -c boot -d hcm91fp1
Attempting to boot bulletin board...
tmadmin - Copyright (c) 2007-2008 Oracle.
Portions * Copyright 1986-1997 RSA Data Security, Inc.
All Rights Reserved.
Distributed under license by Oracle.
Tuxedo is a registered trademark.
No bulletin board exists. Entering boot mode.

> INFO: Oracle Tuxedo, Version 10.3.0.0, 64-bit, Patch Level 071

Booting admin processes ...

exec BBL -A :
        process id=24244 ... Started.
1 process started.
Attaching to active bulletin board.

> Attempting to boot ...
INFO: Oracle Tuxedo, Version 10.3.0.0, 64-bit, Patch Level 071

Booting server processes ...

exec PSWATCHSRV -o ./LOGS/stdout -e ./LOGS/stderr -A -- -ID 200223 -D hcm91fp1 -S PSWATCHSRV :
        process id=24248 ... Started.
exec PSAPPSRV -o ./LOGS/stdout -e ./LOGS/stderr -s@psappsrv.lst -- -D hcm91fp1 -S PSAPPSRV :
        process id=24249 ... Started.
<…snipped…>
exec JSL -o ./LOGS/stdout -e ./LOGS/stderr -A -- -n //orion5.phoenix.nga:9000 -m 9 -M 12 -I 5 -j ANY -x 40 -S 10 -c 1000000 -w JSH :
        process id=24374 ... Started.
exec JREPSVR -o ./LOGS/stdout -e ./LOGS/stderr -A -- -W -P /appl/psoft/hcm91fp1_dom/appserv/hcm91fp1/jrepository :
        process id=24384 ... Started.
15 processes started.
[ptools852@orion5 appserv]$ ./psadmin -p start -d hcm91fp1
Attempting to boot bulletin board...
tmadmin - Copyright (c) 2007-2008 Oracle.
Portions * Copyright 1986-1997 RSA Data Security, Inc.
All Rights Reserved.
Distributed under license by Oracle.
Tuxedo is a registered trademark.
No bulletin board exists. Entering boot mode.

> INFO: Oracle Tuxedo, Version 10.3.0.0, 64-bit, Patch Level 071

Booting admin processes ...

exec BBL -A :
        process id=24391 ... Started.
1 process started.
Attaching to active bulletin board.

> Attempting to boot ...
INFO: Oracle Tuxedo, Version 10.3.0.0, 64-bit, Patch Level 071

Booting server processes ...

exec PSMSTPRC -o ./LOGS/stdout -e ./LOGS/stderr -A -- -CD hcm91fp1 -PS PSUNX -A start -S PSMSTPRC :
        process id=24410 ... Started.
exec PSAESRV -o ./LOGS/stdout -e ./LOGS/stderr -- -CD hcm91fp1 -S PSAESRV :
        process id=24419 ... Started.
<…snipped…>
exec PSMONITORSRV -o ./LOGS/stdout -e ./LOGS/stderr -A -- -ID 88726 -PS PSUNX -S PSMONITORSRV :
        process id=24473 ... Started.
8 processes started.
[ptools852@orion5 appserv]$ ./psadmin -w start -d peoplesoft
Domain Not Found: peoplesoft
[ptools852@orion5 appserv]$ export PS_CFG_HOME=$PIA_HOME
[ptools852@orion5 appserv]$ ./psadmin -w start -d peoplesoft

Starting the domain........
Server state changed to STARTING...........
Server state changed to STANDBY.
Server state changed to STARTING........
Server state changed to ADMIN.
Server state changed to RESUMING.
Server state changed to RUNNING.
Verifying domain status......
The domain has started.

[ptools852@orion5 appserv]$

Same behavior when using the interactive menu of psadmin, once the webserver is created as I showed above, it does not take it in account anymore :
[root@orion5 ~]# su - ptools852
[ptools852@orion5 ~]$ cd $PS_HOME/appserv
[ptools852@orion5 appserv]$ env|grep PIA_HOME
PIA_HOME=/appl/psoft/hcm91fp1_web
[ptools852@orion5 appserv]$ env|grep PS_CFG_HOME
PS_CFG_HOME=/appl/psoft/hcm91fp1_dom
[ptools852@orion5 appserv]$ ./psadmin

PSADMIN -- Tools Release: 8.52.02
Copyright (c) 1996, 2011, Oracle. All rights reserved.

--------------------------------
PeopleSoft Server Administration
--------------------------------

  Config Home:  /appl/psoft/hcm91fp1_dom

  1) Application Server
  2) Process Scheduler
  3) Search Server
  4) Web (PIA) Server
  5) Switch Config Home
  6) Replicate Config Home
  q) Quit

Command to execute (1-6, q): 4

-----------------------------
PeopleSoft PIA Administration
-----------------------------

  PIA Home:   /appl/psoft/hcm91fp1_dom <—here it is not my predefined $PIA_HOME

  1) Administer a domain
  2) Create a domain
  3) Delete a domain

  q) Quit

Command to execute:

Well, from the Peoplebooks, we can read “If you have the PIA_HOME environment variable set, this overrides the use of PS_CFG_HOME for PIA installations.”, that’s fine, it worked as I showed above for install, but does it mean it won’t override PS_CFG_HOME afterwards ? Or preferably, you change PS_CFG_HOME on-line, or before running psadmin to the desired PIA_HOME.

Nicolas.