WebLogic Domain Directory Structure and Files
This section provides an overview of the WebLogic domain directory structure and files.
In a PeopleSoft implementation, the WebLogic domains are installed into your PS_HOME directory. The major components of the directory structure layout of a PIA install on WebLogic Server are:
|
Directory |
Description |
|---|---|
|
PIA_HOME\webserv |
Parent, high-level WebLogic domain directory. |
|
PIA_HOME\webserv\peoplesoft |
Default WebLogic domain directory. |
|
PIA_HOME\webserv\peoplesoft\applications\peoplesoft |
PeopleSoft application directory. |
|
PIA_HOME\webserv\peoplesoft\bin |
WebLogic domain's bin directory, containing numerous administration scripts. |
|
PIA_HOME\webserv\peoplesoft\config |
WebLogic domain's configuration directory. |
|
PIA_HOME\webserv\peoplesoft\servers\PIA\logs |
WebLogic domain's log directory. |
|
PIA_HOME\webserv\peoplesoft\keystore |
WebLogic key store location for storing keys for configuring SSL. |
This section lists the WebLogic domain files installed by the PeopleSoft installation, organized by file type. Where necessary, each table includes columns that indicate whether a given file is used in a single-server, multi-server, or distributed server configuration.
This listing does not include Java classes or PIA configuration files. On UNIX an equivalent Bourne shell script is provided where a Windows script is listed.
The following table lists WebLogic server administration scripts. All the life cycle scripts are stored in PIA_HOME\webserv\domain\bin.
|
Script |
Single-Server |
Multi-Server |
Distributed Server |
Description |
|---|---|---|---|---|
|
setEnv.cmd |
Yes |
Yes |
Yes |
Use this script to set required environment variables for the WebLogic server, for example: CLASSPATH, PATH, UNIX Library Path, and JVM options. |
|
startPIA.cmd |
Yes |
No |
No |
Use this script to start the WebLogic domain’s administration server (the PIA server) in a single-server configuration. On Windows this starts WebLogic as a foreground process. On UNIX this starts WebLogic as a background process. Run the script with –help for usage. |
|
startWebLogicAdmin.cmd |
No |
Yes |
No |
Use this script to start the WebLogic domain’s administration server (the WebLogicAdmin server) in a multi-server configuration. On Windows this starts WebLogic as a foreground process. On UNIX this starts WebLogic as a background process. Run the script with –help for usage. |
|
startManagedWebLogic.cmd |
No |
Yes |
Yes |
Use this script to start a WebLogic managed server. All WebLogic servers in a WebLogic domain other than the administration server are WebLogic managed servers. Run the script with –help for usage. |
|
stopPIA.cmd |
Yes |
No |
No |
Use this script to stop the WebLogic PIA server. Run the script with –help for usage. |
|
stopWebLogic.cmd |
No |
Yes |
Yes |
Use this script to stop WebLogic servers. Run the script with –help for usage. |
|
InstallNTservicePIA.cmd |
Yes |
No |
No |
(Windows only) Use this script to install the WebLogic PIA server as a Windows service. The service name is WebLogic_domain-PIA. Run the script with –help for usage. |
|
InstallNTservice.cmd |
No |
Yes |
Yes |
(Windows only) Use this script to install a WebLogic server as a Windows service. The service name is WebLogic_domain-server_name. Run the script with –help for usage. |
|
uninstallNTServicePIA.cmd |
Yes |
No |
No |
(Windows only) Use this script to uninstall the WebLogic PIA server Windows service. Run the script with –help for usage. |
|
uninstallNTService.cmd |
No |
Yes |
Yes |
(Windows only) Use this script to uninstall a WebLogic server Windows service. Run the script with –help for usage. |
|
pskeymanager.cmd |
Yes |
Yes |
Yes |
Use this script to manage the JKS keystore used by WebLogic Server, which is in WebLogic_domain\keystore\pskey. SSL certificates for WebLogic Server are stored in this keystore. PeopleSoft Integration Gateway can also share this keystore. Run the script with –help for usage. |
|
startWebLogicBuilder.cmd |
Yes |
Yes |
Yes |
Use this script to start WebLogic Builder, which is used to change local application deployment descriptors. |
|
createThreadDump.cmd |
Yes |
Yes |
Yes |
Use this script to create a JVM Thread dump. Run the script with –help for usage. |
The following table lists WebLogic server configuration files stored in PS_HOME/webserv/domain/config.
|
File |
Single-Server |
Multi-Server |
Distributed Server |
Description |
|---|---|---|---|---|
|
config.xml |
Yes |
Yes |
No |
This file stores the WebLogic domain configuration, including information about server names, ports, IP addresses, webapps, and SSL. Edit these settings using the WebLogic administration console: http://webserver:port/console. |
|
msi-config.xml |
No |
Yes |
Yes |
This is a version of config.xml that's copied for use with a distributed managed server configuration. It's automatically replicated from the original config.xml after a managed server successfully starts. |
|
boot.properties |
Yes |
Yes |
Yes |
THis file contains the WebLogic system ID and password used for administering the WebLogic domain. |
|
fileRealm.properties |
Yes |
Yes |
Yes |
This file is used by WebLogic's internal LDAP server for system administration. |
|
DefaultAuthenticatorInit.ldift |
Yes |
Yes |
Yes |
This file is used by WebLogic's internal LDAP server for system administration. |
|
DefaultRoleMapperInit.ldift |
Yes |
Yes |
Yes |
This file is used by WebLogic's internal LDAP server for system administration. |
|
SerializedSystemIni.dat |
Yes |
Yes |
Yes |
This file is used by WebLogic's internal LDAP server for system administration. |
The following table lists PeopleSoft J2EE application scripts, which are all used with Integration Broker, and can be used with every WebLogic server configuration.
|
Script |
Description |
|---|---|
|
BatchProjectExecutor.bat |
Use this script for Integration Broker batch EIP testing. |
|
HashKeyGenerator.bat |
Use this script to generate a hash key used for Integration Gateway playback. |
|
MessageExport.bat |
Use this Integration Broker script for extracting transaction data from request and response data. |
|
StartSendMaster.bat |
This is a Integration Broker test utility. |
The following table lists miscellaneous files, which can be used with every WebLogic server configuration.
|
File |
Description |
|---|---|
|
Businterlink.txt |
This file is used by PeopleSoft’s Business Interlinks servlet for loading PeopleSoft libraries when needed. |
|
piaInstallLog.xml |
This is the PIA install log. |
|
PSCipher.bat |
Use this script for encrypting Integration Broker passwords. |
In addition to WebLogic domain configuration files, application descriptors are installed with the PeopleSoft J2EE enterprise application. The following table lists these descriptor files. The path shown for each file is relative to PIA_HOME\webserv\WebLogic_domain\applications\.
|
File |
Description |
|---|---|
|
peoplesoft\META-INF\MANIFEST.MF |
Use this script to set required environment variables for the WebLogic server, for example: CLASSPATH, PATH, UNIX Library Path, and JVM options. |
|
peoplesoft\META-INF\application.xml |
This file contains a list of the webapps that comprise the PeopleSoft J2EE enterprise application. |
|
peoplesoft\PORTAL\WEB-INF\web.xml |
This file is the web application descriptor for the PORTAL webapp. It lists all of the servlets deployed as part of that application. |
|
peoplesoft\PORTAL\WEB-INF\weblogic.xml |
This file is the PORTAL web application extension descriptor. It specifies, among other things, the HTTP session cookie name, optional cookie domain, and context path of this application. |
|
peoplesoft\PSIGW\WEB-INF\web.xml |
This file is the web application descriptor for the PeopleSoft Integration Gateway (PSIGW) webapp. It lists all of the servlets deployed as part of that application. |
|
peoplesoft\PSIGW\WEB-INF\weblogic.xml |
This file is the PSIGW web application extension descriptor. It specifies the context path of this application. |
|
peoplesoft\PSEMHUB\WEB-INF\web.xml |
This file is the web application descriptor for the PeopleSoft Environment Framework (PSEMHUB) webapp. It lists all of the servlets deployed as part of that application. |
|
peoplesoft\PSEMHUB\WEB-INF\weblogic.xml |
This file is the PSEMHUB web application extension descriptor. It specifies the context path of this application. |
|
peoplesoft\PSINTERLINKS\WEB-INF\web.xml |
This file is the web application descriptor for the PeopleSoft Business Interlinks (PSINTERLINKS) webapp. It lists all of the servlets deployed as part of that application. |
|
peoplesoft\PSINTERLINKS\WEB-INF\weblogic.xml |
This file is the PSINTERLINKS web application extension descriptor. It specifies the context path of this application. |
|
HttpProxtServlet\WEB-INF\web.xml |
This file is the web application descriptor for the WebLogic Server Reverse Proxy Server (RPS) webapp that's used to proxy content from a single WebLogic server. It lists all of the servlets deployed as part of that application. |
|
HttpProxyServlet\WEB-INF\weblogic.xml |
This file is the single-server RPS web application extension descriptor. It specifies the context path of this application. |
|
HttpClusterServlet\WEB-INF\web.xml |
This file is the web application descriptor for the WebLogic Server Reverse Proxy Server (RPS) webapp that's used to proxy content from a cluster of WebLogic servers. It lists all of the servlets deployed as part of that application. |
|
HttpClusterServlet\WEB-INF\weblogic.xml |
This file is the multi-server RPS web application extension descriptor. It specifies the context path of this application. |