Running the PSRUNACM Script
In addition to the Automated Configuration Manager that is executed from PIA, the automated configuration management framework allows you to configure the products for your environment from the command line using the PSRUNACM script.
The PSRUNACM.bat and the PSRUNACM.sh files are available in the Utility folder of PS_HOME.
This section discusses:
Running PSRUNACM in Windows.
Running PSRUNACM in UNIX.
To run PSRUNACM in Windows:
Set the PS_HOME and PS_CFG_HOME environment variables.
Set the PS_FILEDIR environment variable, if required.
The template file that is used as input to configure the environment can be present either in database or as a text file.
If the template file is present in database, do not set the PS_FILEDIR environment variable.
A template file (text file) can exist in a remote path or you can copy the template file (text file) into the same directory as the psrunACM script.
Note: If the template file (text file) exists in a remote path, you must set the PS_FILEDIR environment variable to specify the remote path of the template file. If the template file exists in a remote path and if the PS_FILEDIR variable is not set, the directory from where the psrunACM script is run is considered as the location of the template file. Hence, you need to copy the template file to the same directory as the psrunACM script.
If you copy the template file into the same directory as the psrunACM script, do not set the PS_FILEDIR environment variable.
Run the PSRUNACM.bat file.
If the template file is present in database, run the following command by replacing the values within <> with appropriate values.
psrunACM.bat <SERVER> <DBTYPE> <DBNAME> <USERID> <PASSWORD> <TEMPLATE_NAME> <OPTION>where
Field or Control
Definition
SERVER The host machine name in which the script is executed.
DBTYPE The type of database on which the configuration is run, for example, ORACLE.
DBNAME The name of the hosted database.
USERID Operator ID.
PASSWORD Operator password.
TEMPLATE_NAME The name of the template file, which is used as input for the configuration run.
OPTION The option parameter is used to decide whether the template should be executed from database, imported to database, or exported from database.
Valid values:
EXP - The template mentioned in TEMPLATE_NAME is exported from the database mentioned in DBNAME to the local machine.
IMP - The template mentioned in TEMPLATE_NAME is imported to the database mentioned in DBNAME from the current path from where the psrunACM.bat script is invoked.
EXEC - The template mentioned in TEMPLATE_NAME is used as input to configure the environment.
If the template file is available as a text file, run the following command by replacing the values within <> with appropriate values.
Before you run the command, ensure that the PS_FILEDIR environment variable is set if the template file exists in a remote path.
psrunACM.bat <SERVER> <DBTYPE> <DBNAME> <USERID> <PASSWORD> <TEMPLATE_NAME>Note: If the input is a text file, the OPTION parameter is not required.
To run PSRUNACM in UNIX:
Set the PS_HOME and PS_CFG_HOME environment variables.
Set the PS_FILEDIR environment variable, if required.
The template file that is used as input to configure the environment can be present either in database or as a text file.
If the template file is present in database, do not set the PS_FILEDIR environment variable.
A template file (text file) can exist in a remote path or you can copy the template file (text file) into the same directory as the psrunACM script.
Note: If the template file (text file) exists in a remote path, you must set the PS_FILEDIR environment variable to specify the remote path of the template file. If the template file exists in a remote path and if the PS_FILEDIR variable is not set, the directory from where the psrunACM script is run is considered as the location of the template file. Hence, you need to copy the template file to the same directory as the psrunACM script.
If you copy the template file into the same directory as the psrunACM script, do not set the PS_FILEDIR environment variable.
Run the PSRUNACM.sh script.
If the template file is present in database, run the following command by replacing the values within <> with appropriate values.
psrunACM.sh <SERVER> <DBTYPE> <DBNAME> <USERID> <PASSWORD> <TEMPLATE_NAME> <DOMAIN> <OPTION>where
Field or Control
Definition
SERVER The host machine name in which the script is executed.
DBTYPE The type of database on which the configuration is run, for example, ORACLE.
DBNAME The name of the hosted database.
USERID Operator ID.
PASSWORD Operator password.
TEMPLATE_NAME The name of the template file, which is used as input for the configuration run.
DOMAIN The application server domain name.
OPTION The option parameter is used to decide whether the template should be executed from database, imported to database, or exported from database.
Valid values:
EXP - The template mentioned in TEMPLATE_NAME is exported from the database mentioned in DBNAME to the local machine.
IMP - The template mentioned in TEMPLATE_NAME is imported to the database mentioned in DBNAME from the current path from where the psrunACM.sh script is invoked.
EXEC - The template mentioned in TEMPLATE_NAME is used as input to configure the environment.
If the template file is available as a text file, run the following command by replacing the values within <> with appropriate values.
Before you run the command, ensure that the PS_FILEDIR environment variable is set if the template file exists in a remote path.
psrunACM.sh <SERVER> <DBTYPE> <DBNAME> <USERID> <PASSWORD> <TEMPLATE_NAME> <DOMAIN>Note: When the input is a text file, the OPTION parameter is not required.