COGNOS Business Intelligence Series 7

Appendix B: Batch Administration
This section describes the command-line options you can use to perform batch administration on
PowerPlay servers.
The ppadmtool Program
Name
Synopsis
With the ppadmtool program, you can execute PowerPlay Enterprise Server commands directly
from the Windows command prompt or UNIX command shell. The ppadmtool program saves
you time. You can
• enter your instruction from the command line rather than launching PowerPlay Enterprise
Server Administrator
• redirect stdin to use batch commands
• redirect stdout to a log file
In UNIX, the command-line administration tool can be accessed by using the ppadmtool.sh script.
This script sets the appropriate environmental variables and starts the command line
administration tool. Parameters appended to the script are passed to the administration tool for
processing.
After installation, the location of this script in UNIX is in the bin folder.
Run this script using one of the following formats:
• ./ppadmtool.sh
• ./ppadmtool.sh CONNECT servername USER username
• ./ppadmtool.sh CONNECT servername USER username PASSWORD password
• ./ppadmtool.sh CONNECT servername:port/password (non Access Manager mode)
ppadmtool - PowerPlay Enterprise - Server Administration
You can issue single commands that connect and perform the desired action, for example
PPADMTOOL CONNECT server[:port][/password] [option ...]
or you can start a session by typing ppadmtool on the command line. You can then issue the
following commands against PowerPlay servers, cubes, and reports until you type exit.
ADD type name [PATH path] [DS mirror]
ADD DS type name DS mirror
CONNECT server[:port][/password]
CONNECT server[:port] USER username PASSWORD password
CD folder
COPY name name
CRN REPLACE {(GATEWAY | CUBENAME)} old_value new_value
DISABLE name
ENABLE name
EXIT
Enterprise Server Guide 101