Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and
specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose.
Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time,
without obligation to notify any person or entity of such revisions or changes.
Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims
any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc.
reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to
notify any person or entity of such changes.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the
trade laws of other countries. You agree to comply with all export control regulations and to obtain any required
licenses or classification to export, re-export or import deliverables. You agree not to export or re-export to entities on
the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export laws.
You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. See the
Novell International Trade Services Web page (http://www.novell.com/info/exports/) for more information on
exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export
approvals.
Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this
document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S.
patents listed on the Novell Legal Patents Web page (http://www.novell.com/company/legal/patents/) and one or
more additional patents or pending patent applications in the U.S. and in other countries.
Novell, Inc.
404 Wyman Street, Suite 500
Waltham, MA 02451
U.S.A.
www.novell.com
Online Documentation: To access the latest online documentation for this and other Novell products, see
the Novell Documentation Web page (http://www.novell.com/documentation).
Novell Trademarks
For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/company/legal/
trademarks/tmlist.html).
Third-Party Materials
All third-party trademarks are the property of their respective owners.
This PlateSpin Orchestrate Command Line Reference introduces the two command line interface
client tools of PlateSpin
basic administration tools. The reference is organized as follows:
Chapter 1, “The zos Command Line Tool,” on page 9
Chapter 2, “The zosadmin Command Line Tool,” on page 61
Audience
This book is intended for data center managers and IT or Operations administrators. The zos
command line interface is intended for the use of Job Managers. The book assumes that users of the
product have the following background:
General understanding of network operating environments and systems architecture.
Knowledge of basic UNIX* shell commands and text editors.
Feedback
We want to hear your comments and suggestions about this manual and the other documentation
included with this product. Please use the User Comments feature at the bottom of each page of the
online documentation, or go to www.novell.com/documentation/feedback.html (http://
www.novell.com/documentation/feedback.html) and enter your comments there.
Documentation Updates
®
Orchestrate from Novell®, zos and zosadmin. These are the product’s
For the most recent version of this Command Line Reference, visit the PlateSpin Orchestrate 2.0
Web site (http://www.novell.com/documentation/pso_orchestrate20/).
Documentation Conventions
In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and
items in a cross-reference path.
®
A trademark symbol (
trademark.
When a single pathname can be written with a backslash for some platforms or a forward slash for
other platforms, the pathname is presented with a backslash. Users of platforms that require a
forward slash, such as Linux* or UNIX, should use forward slashes as required by your software.
, TM, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party
About This Reference7
novdocx (en) 13 May 2009
8PlateSpin Orchestrate 2.0 Command Line Reference
1
The zos Command Line Tool
novdocx (en) 13 May 2009
1
The zos command line tool can be used by logged-in users. To use the command line tool, each user
requires a login name and password that are created by the administrator for PlateSpin
from Novell
jobs, monitor jobs, and perform other user functions.
This section includes information about the following:
Section 1.1, “List of zos Commands,” on page 9
Section 1.2, “Getting Started with the zos Command,” on page 10
Section 1.3, “Details, Usage, and Syntax Examples of zos Commands,” on page 13
®
. The
zos
command line tool can be used to log in to the Orchestrate Server, to submit
®
Orchestrate
1.1 List of zos Commands
The following table includes a list of
Table 1-1 Available zos Commands and Their Descriptions
CommandDescription
cancelCancel a running job
catDisplays the contents of a datagrid file
copyCopy files and directories to and from the datagrid
zos
commands and a description for each command.
deleteDelete files and directories in the datagrid
dirList files and directories in the datagrid
eventSend an event to a running job
failDirects the job to end in failure
headDisplays the first part of a datagrid file
helpDisplays help for any of the commands in this list
infoDisplay information about a grid object
jobinfoDisplay important information for a job
joblistList all of the available jobs and arguments
jobsList the running queued or historical job
listenListen to events generated by a running job
logDisplays the log for the specified job
loginLog in to the grid
logoutLog out of the grid
mkdirMake a new directory in the datagrid
The zos Command Line Tool
9
CommandDescription
moveMove files and directories in the datagrid
passwordChange user password on current grid
pausePause a running job
priorityChange the priority of a running job
resumeResume a running job
runRun a job
searchPerform grid object search
statusDisplay the status of a running or previously run job
tailDisplays the end of a datagrid file
1.2 Getting Started with the zos Command
novdocx (en) 13 May 2009
Although many users prefer to use the PlateSpin Orchestrate User Portal as they manage jobs, some
might prefer a command line interface (CLI). This section is for advanced users or those who prefer
CLI.
zos
All zos commands begin with
zos
followed by the command name, followed by command line parameters, if needed:
zos command [command_parameters]
on the command line. The general format for a zos command is
Before you use the zos CLI, make sure that your path is correctly pointing to the PlateSpin
Orchestrate tools directory. On Windows platforms, the path is automatically set when you launch
the PlateSpin Orchestrate command prompt window. If the path is set, you then need to log in to the
PlateSpin Orchestrate Server before the commands work.
This section includes the following information:
Section 1.2.1, “Logging In to the Orchestrate Server,” on page 10
Section 1.2.2, “Running a Job,” on page 11
Section 1.2.3, “Monitoring a Job,” on page 11
1.2.1 Logging In to the Orchestrate Server
The administrator for PlateSpin Orchestrate provides a username, a password, and the name for the
Orchestrate Server. The following shows a sample login sequence. Italics are used to indicate
variable names.
>zos login -user=usernameOrchestrate_sserver_name
Please enter current password for 'Orchestrator_server_name': *******
Logged into Orchestrator_server_name_zos> as username
The login should now be complete.
Login information is stored in the home directory, so further
saved login information. To operate on a different Orchestrate Server, run
new server information.
10PlateSpin Orchestrate 2.0 Command Line Reference
zos
commands on this server use the
zos login
again with the
1.2.2 Running a Job
novdocx (en) 13 May 2009
Use the
run
command to start a job. For example, if you want to run the “quickie” job, you would
enter the following command:
>zos run quickie
If the job submission was successful, a JobID is displayed:
JobID: tester.1.quickie
To specify parameters when you start a job, add the parameters to the command line. For example, if
you wanted to run the quickie job, specifying the
numJoblets
parameter with a value of 100, you
would enter the following command:
>zos run quickie numJoblets=100
JobID: tester.2.quickie
The PlateSpin Orchestrate Server keeps track of your last started job so that further zos commands
can default to the last started job. To operate on a different job, specify the Job ID as a command line
parameter.
1.2.3 Monitoring a Job
A job can be monitored or managed when it is started or after it is started. To view the status of the
last started job, use the
>zos status
Running
status
command:
The server returns the status immediately. In the preceding example, the job is
Running
, which
means the job is still being processed. Possible status messages include the following:
Submitted
Queued
Started
Running
Paused
Completing
Cancelling
Failing
Completed
Cancelled
Failed
You can retrieve detailed status information about a job by using the -e option in the command line,
as shown in the following example for the last started job:
>zos status -e
Job Status for tester.quickie.2
---------------------------- State: Running (waiting for resources)
Resource Count: 0 (0 this job)
Percent Complete: 1%
Queue Pos: n/a
Total CPU Time: 0:00:00 (0:00:00 this job)
Total GCycles: 0:00:00 (0:00:00 this job)
Total Cost: $0.0000 ($0.0000 this job)
Burn Rate: $0.0000/hr ($0.0000/hr this job)
Cancel Type: <none>
Job Error: <none>
Job Error Count: 0 (0 this job)
Joblet Retry Count: 0 (0 this job)
Node Error Count: 0 (0 this job)
novdocx (en) 13 May 2009
12PlateSpin Orchestrate 2.0 Command Line Reference
1.3 Details, Usage, and Syntax Examples of zos
Commands
novdocx (en) 13 May 2009
This section includes a detailed list of the
zos
commands you can use. It also includes examples for
using these commands and shows the syntax of typical commands.
NOTE: Items shown in brackets [ ] are optional. Items shown in italics are contextual examples.
The section is organized according to the command names, which include the following:
“cancel” on page 14
“cat” on page 16
“copy” on page 18
“delete” on page 20
“dir” on page 21
“event” on page 23
“fail” on page 25
“head” on page 26
“info” on page 28
“jobinfo” on page 30
“joblist” on page 32
“jobs” on page 33
“listen” on page 35
“log” on page 36
“login” on page 38
“logout” on page 40
“mkdir” on page 41
“move” on page 43
“password” on page 44
“pause” on page 45
“priority” on page 47
“resume” on page 49
“run” on page 50
“search” on page 53
“status” on page 55
“tail” on page 57
The zos Command Line Tool13
cancel
This command cancels a running job.
Syntax
zos cancel [jobid] [--reason=]
Arguments
jobid
The user must enter the jobid that he or she is interested in. The default for this argument is the
last job run.
Options
-m, --reason=<value>
Specifies the reason to log for this action. The user must enter a value with this option.
novdocx (en) 13 May 2009
-C, --cols=<value>
Specifies the terminal width for formatting. The user must enter a value with this option.
-h, --help
Displays a help message for this operation.
-d, --debug
Turns on debug output during this operation.
-v, --verbose
Turns on verbose output during this operation.
-z, --tls=<value>
Force TLS/SSL encryption [on|off]. The user must enter a value with this option.
-Z, --tlsPort=<value>
Port number for TLS/SSL connections. The user must enter a value with this option.
-y, --tlsYesNew
Force acceptance of new TLS server certificates.
-Y, --tlsYesAll
Force acceptance of all TLS server certificates.
Examples
Example 1
To cancel the current job for the login user, use the following command:
14PlateSpin Orchestrate 2.0 Command Line Reference
zos cancel
Example 2
To cancel the named job instance <jobid> for the login user, use the following command:
zos cancel <jobid>
novdocx (en) 13 May 2009
The zos Command Line Tool15
cat
This command displays the contents of a datagrid file.
Syntax
zos cat path
Arguments
path
The path on the datagrid.
Options
-C, --cols=<value>
Specifies the terminal width for formatting. The user must enter a value with this option.
novdocx (en) 13 May 2009
-h, --help
Displays a help message for this operation.
-d, --debug
Turns on debug output during this operation.
-v, --verbose
Turns on verbose output during this operation.
-z, --tls=<value>
Force TLS/SSL encryption [on|off]. The user must enter a value with this option.
-Z, --tlsPort=<value>
Port number for TLS/SSL connections. The user must enter a value with this option.
-y, --tlsYesNew
Force acceptance of new TLS server certificates.
-Y, --tlsYesAll
Force acceptance of all TLS server certificates.
Examples
Example 1
To display the JDL file for the
zos cat grid:///!quickie/quickie.jdl
16PlateSpin Orchestrate 2.0 Command Line Reference
quickie
job, use the following command:
Example 2
novdocx (en) 13 May 2009
To display the
zos cat grid:///^/job.log
job.log
file for the active or last run job, use the following command:
The zos Command Line Tool17
copy
This command copies files and directories to and from the data zos.
Syntax
zos copy sourcedest [--recursive]
Arguments
source
The datagrid source from which the files or directories are to be copied.
dest
The datagrid destination to which the files or directories are to be copied.
Options
novdocx (en) 13 May 2009
-r, --recursive
Processes directories recursively.
-C, --cols=<value>
Specifies the terminal width for formatting. The user must enter a value with this option.
-h, --help
Displays a help message for this operation.
-d, --debug
Turns on debug output during this operation.
-v, --verbose
Turns on verbose output during this operation.
-z, --tls=<value>
Force TLS/SSL encryption [on|off]. The user must enter a value with this option.
-Z, --tlsPort=<value>
Port number for TLS/SSL connections. The user must enter a value with this option.
-y, --tlsYesNew
Force acceptance of new TLS server certificates.
-Y, --tlsYesAll
Force acceptance of all TLS server certificates.
18PlateSpin Orchestrate 2.0 Command Line Reference
Examples
Example 1
To copy a local file into a previously created datagrid subdirectory, use the following command:
zos copy local.txt grid:///images
Example 2
To copy a file from the current job instance directory to a local file, use the following command:
zos copy grid:///^/results.txt local.txt
Example 3
To copy a file from a named job instance directory to a local file, use the following command:
60PlateSpin Orchestrate 2.0 Command Line Reference
2
The zosadmin Command Line Tool
The zosadmin command line tool is used by administrators of PlateSpin Orchestrate from Novell®
to log in to the server, add or remove server components such as jobs and policies, to report on the
status of nodes, users, and the audit database, and to perform other administrative functions.
This section includes information about the following:
Section 2.1, “List of zosadmin Commands,” on page 61
Section 2.2, “Getting Started with the zosadmin Command,” on page 62
Section 2.3, “Details, Usage, and Syntax Examples of zosadmin Commands,” on page 64
2.1 List of zosadmin Commands
The following table includes a list of zosadmin commands in order of common usage, and a
description for each command.
novdocx (en) 13 May 2009
2
Table 2-1 Available zosadmin Commands and Their Descriptions
CommandDescription
auditcleanClean the audit database by removing old data
auditcountCount the number of jobs in the audit database
auditreportGenerate an audit report
cancelalljobsCancel all running jobs
createCreate a new server instance
deployDeploy a new component onto a server
disconnectDisconnect and/or revoke user or node sessions
dumpDump contents of the namespace (advanced diagnostics)
getRetrieve an attribute
helpDisplays help for any of the commands in this list
initRestore a server configuration to initial state
invokeInvoke an mbean method (advanced diagnostics)
listList the running servers
loginLog in to the server
logoutLog out of the server
nodesRetrieve the list of active or inactive nodes
passwordChange admin password
redeployRedeploy a component on a server
The zosadmin Command Line Tool
61
CommandDescription
rotatelogsBack up and rotate the log files
sessionsDisplay session information
setSet an attribute
startStart a local server
statusCollect the status of a server
stopShut down the server
undeployUndeploy a component from the server
upgradeUpgrade old server snapshot to current version
usersRetrieve the list of active or inactive users
verifyVerify a component for syntax
2.2 Getting Started with the zosadmin Command
novdocx (en) 13 May 2009
All zosadmin commands begin with zosadmin on the command line. The general format for a
zosadmin command is
zosadmin
followed by the command name, followed by command line
Before you use the zosadmin CLI, make sure that your path is correctly pointing to the PlateSpin
/bin
Orchestrate
directory.
This section includes the following information:
Section 2.2.1, “Logging In,” on page 62
Section 2.2.2, “Checking Login Status,” on page 62
Section 2.2.3, “Logging Out,” on page 63
2.2.1 Logging In
Login is required to operate on a running server. The commands
not require a login. Use the following syntax to log in:
>zosadmin login -user=usernameOrhestrator_Server_name
Please enter current password for 'username': *******
Logged into Orchestrate_grid_name> on Orchestrate_Server_name
The login should now be complete.
start, list, init
, and
create
do
Login information is stored in the
/home
directory, so further
login information. To operate on a different PlateSpin Orchestrate Server, run
log in to the new Orchestrate Server.
2.2.2 Checking Login Status
Enter the following command and parameter to retrieve the status of the current login:
62PlateSpin Orchestrate 2.0 Command Line Reference
zosadmin
commands use the saved
zosadmin login
to
>zosadmin login -c
Currently logged into testgrid on server 'tszen5'
2.2.3 Logging Out
Enter the following command to log out of the Orchestrate Server:
>zosadmin logout
Logged out from testgrid
novdocx (en) 13 May 2009
The zosadmin Command Line Tool63
2.3 Details, Usage, and Syntax Examples of
zosadmin Commands
novdocx (en) 13 May 2009
This section includes a detailed list of the
zosadmin
commands you can use. It also includes
examples for using these commands and shows the syntax of typical commands.
NOTE: Items shown in brackets [ ] are optional. Items shown in italics are contextual examples.
The section is organized according to the command names, which include the following:
“auditclean” on page 65
“auditcount” on page 66
“auditreport” on page 67
“cancelalljobs” on page 69
“create” on page 70
“deploy” on page 73
“disconnect” on page 74
“dump” on page 75
“get” on page 76
“init” on page 77
“invoke” on page 78
“list” on page 79
“login” on page 80
“logout” on page 82
“nodes” on page 83
“password” on page 84
“redeploy” on page 85
“rotatelogs” on page 86
“sessions” on page 87
“set” on page 89
“start” on page 90
“status” on page 92
“stop” on page 93
“undeploy” on page 94
“upgrade” on page 95
“users” on page 96
“verify” on page 97
64PlateSpin Orchestrate 2.0 Command Line Reference
auditclean
This command cleans the audit database by removing old data.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-d, --dayskept <value>
Specify the number of days of history kept in the database (0 removes all).
-g, --grid <value>
Specify a different grid (by ID). Use ‘*’ to match all. Include the single quotes only in a shell
environment.
novdocx (en) 13 May 2009
-t, --table <value>
Specify the table (workflow, actions). Default is workflow.
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
Examples
Example 1
To clean up all records older than 7 days for the logged in grid, use the following command:
zosadmin auditclean --dayskept=7
Example 2
To clean up all records older than 7 days from all servers stored in the audit database, use the
following command:
zosadmin auditclean --dayskept=7 --gridId=*
The zosadmin Command Line Tool65
auditcount
This command retrieves the count of the number of jobs in the audit database.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin auditcount [--root] [--grid=] [--table=]
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-R, --root
Display the count for root jobs only (default counts all jobs).
-g, --grid <value>
Specify a different grid (by ID). Use ‘*’ to match all. Include the single quotes only in a shell
environment.
novdocx (en) 13 May 2009
-t, --table <value>
Specify the table (workflow, actions). The default is “workflow.”
-v, --verbose
Turns on verbose output during this operation.
-V, --debug
Turns on debug output during this operation.
-h, --help
Displays a help message for this operation.
Examples
Example 1
To get the count of job records for the logged in grid, use the following command:
zosadmin auditcount
66PlateSpin Orchestrate 2.0 Command Line Reference
auditreport
This command displays an audit report generated from the audit database.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-m, --username <value>
Specify the username of the user who ran the job (default is all users).
novdocx (en) 13 May 2009
-F, --from <value>
Select jobs submitted on or after this date. For example,
2007 13:30:00
-T, --to <value>
Select jobs submitted on or before this date. For example,
Oct 2007 13:30:00
-L, --limit <value>
Limit the number of jobs reported (the default is 500).
-g, --grid <value>
Specify a different grid (by ID). Use ‘*’ to match all. Include the single quotes only in a shell
environment.
-I, --childjobs
Include child jobs (the default is root jobs only).
-t, --table <value>
Specify the table (workflow, actions). The default is “workflow.”
-V, --debug
Turn on debug output during this operation.
. The default day is the current day.
. The default day is the current time.
Fri, 12 Oct 2007
Fri, 12 Oct 2007
or
Fri, 12 Oct
or
Fri, 12
-v, --verbose
Turn on verbose output during this operation.
-h, --help
Display a help message for this operation.
The zosadmin Command Line Tool67
Examples
Example 1
To display a report of job records for the logged in grid, use the following command:
zosadmin auditreport
Example 2
To display a report of action status records for the logged in grid, use the following command:
zosadmin auditreport --table=actions
novdocx (en) 13 May 2009
68PlateSpin Orchestrate 2.0 Command Line Reference
cancelalljobs
This command cancels all running jobs.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin cancelalljobs
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-v, --verbose
Turns on verbose output during this operation.
-V, --debug
Turns on debug output during this operation.
novdocx (en) 13 May 2009
-h, --help
Displays a help message for this operation.
The zosadmin Command Line Tool69
create
This command creates a new server instance.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
Specify the hostname to use for this server. The default is the system hostname.
novdocx (en) 13 May 2009
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-N, --newdir <value>
The location where the new Orchestrate Server should be installed.
-G, --upgrade
Switch the upgrade behavior for snapshot handling.
-e, --profile <value>
Create a new instance based on named profile (the default is
-i, --id <value>
Select by kernel ID.
-g, --grid <value>
Select by grid name.
-C, --clusterhost <value>
Hostname of virtual cluster IP resource (for High Availability configuration).
-u, --user <value>
Username used in accessing secure remote sites.
server
).
-p, --password <value>
Password used in accessing secure remote sites.
-P, rmiport <value>
Select by RMI port.
70PlateSpin Orchestrate 2.0 Command Line Reference
-H, --rmihost <value>
Select or specify the RMI host (can be different from server host).
-W, --httpport <value>
Specify the http port used for the User Portal (the default is 80).
-M, --adminport <value>
Specify the http port used for Administrative Information Portal (default 8001).
-A, --agentport <value>
Specify the communication port for agent connections (default 8100).
-X, --auditurl <value>
Specify the connection URL to a PostgreSQL database (for example,
localhost/zos_db
).
-Y, --audituser <value>
Specify the audit database user.
novdocx (en) 13 May 2009
jdbc:postgresql://
-Z, --auditpasswd <value>
Specify the audit database password.
-k, --cert <value>
Specify the
.pem
file containing the new server’s TLS certificate.
-K, --key <value>
Specify the
.pem
file containing the new server’s TLS key.
-v, --verbose
Turns on verbose output during this operation.
-V, --debug
Turns on debug output during this operation.
-h, --help
Displays a help message for this operation.
Examples
Example 1
To create a new server instance in the install directory (default), use the following command:
zosadmin create
Example 2
To create a new server instance using host name myhost.mydomain.com, use the following
command:
zosadmin create myhost.mydomain.com
The zosadmin Command Line Tool71
Example 3
novdocx (en) 13 May 2009
To create a new server instance in the
zosadmin create --newdir=/zos/myserver
/zos/myserver/
directory, use the following command:
Example 4
To create a new upgraded server instance in an existing directory (
/zos/myserver/
), use the
following command:
zosadmin create --newdir=/zos/myserver --upgrade
IMPORTANT: This command removes the previous server instance data from the directory.
Example 5
To create an upgraded server and reuse saved tls certificates, use the following command:
72PlateSpin Orchestrate 2.0 Command Line Reference
deploy
This command deploys a new component onto a server.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin deploy [--port=] file|dir
Arguments
file|dir
Specify the deployable file or a directory containing deployable files.
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
novdocx (en) 13 May 2009
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
Examples
Example 1
To deploy the service file
zosadmin deploy myservice.sar
Example 2
To deploy the job file
zosadmin deploy quickie.job
Example 3
myservice.sar
quickie.job
, use the following command:
, use the following command:
To deploy a job file in the
zosadmin deploy /test/myjob.job
/test/myjob.job
directory, use the following command:
The zosadmin Command Line Tool73
disconnect
This command allows forceful disconnect or revocation of user or node sessions.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-i, --id
Identity of a specific user session.
novdocx (en) 13 May 2009
-n, --node <value>
Disconnect a node by name.
-u, --user <value>
Disconnect all of a user’s sessions by name.
-a, --all
Disconnect all user and node sessions.
-U, --allUsers
Disconnect all user sessions.
-N, --allNodes
Disconnect all node sessions.
-r, --revoke
Revoke the session or sessions in addition to disconnecting.
-V, --debug
Turn on debug output during this operation.
-v, --verbose
Turn on verbose output during this operation.
-h, --help
Display a help message for this operation.
74PlateSpin Orchestrate 2.0 Command Line Reference
dump
This command dumps the contents of namespace.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin dump [--dir=] --jndi=
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-d, --dir <value>
Specify the working directory for a Orchestrate Server installation.
-j, --jndi <value>
Specify the JNDI path to be displayed.
novdocx (en) 13 May 2009
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
Examples
Example 1
To dump the configuration for the naming facility, use the following command:
zosadmin dump --jndi=/facility/naming/config
The zosadmin Command Line Tool75
get
This command retrieves an attribute.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin get --mbean= --attr=
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-m, --mbean <value>
Specifies the name of the mbean to view.
-a, --attr <value>
Specifies the attribute name of the mbean to view.
novdocx (en) 13 May 2009
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
Examples
Example 1
To get the node autoregistration setting, use the following command:
zosadmin get --mbean=local:facility=nodeManager --attr=Autoregister
76PlateSpin Orchestrate 2.0 Command Line Reference
init
This command restores a server configuration to its initial state.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin init [--dir=]
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-d, --dir <value>
The working directory for a PlateSpin Orchestrate installation.
-v, --verbose
Turn on verbose output during this operation.
novdocx (en) 13 May 2009
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
The zosadmin Command Line Tool77
invoke
This command invokes an mbean method.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin invoke --mbean= --method=
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-m, --mbean <value>
Specify the name of the mbean to view.
-i, --method <value>
Specify the method name of the mbean to invoke.
novdocx (en) 13 May 2009
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
78PlateSpin Orchestrate 2.0 Command Line Reference
list
This command lists all of the running servers.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin list [--grid=] [--id=] [--server=] [--rmiport] [--rmipath] [-rmihost=] [--rmiurl=] [--timeout=]
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-g, --grid <value>
Select by grid name.
novdocx (en) 13 May 2009
-i, --id <value>
Select by kernel ID.
-s, --server <value>
Select by host name.
-P, --rmiport <value>
Select by RMI port.
-J, --rmipath <value>
Select or specify the RMI bind path.
-H, --rmihost <value>
Select or specify the RMI host (can be different from <server host>).
-r, --rmiurl <value>
Select by full RMI URL.
-t, --timeout <value>
Sets the query timeout (in seconds).
-V, --debug
Turn on debug output during this operation.
-v, --verbose
Turn on verbose output during this operation.
-h, --help
Display a help message for this operation.
The zosadmin Command Line Tool79
login
This command logs into the Orchestrate Server.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
Enter the server host name that you are logging into. The command polls for a server if none is
supplied.
Options
novdocx (en) 13 May 2009
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-g, --grid <value>
Select by grid name.
-i, --id <value>
Select by kernel ID.
-P, --rmiport <value>
Select by RMI port.
-J, --rmipath <value>
Select or specify the RMI bind path.
-H, --rmihost <value>
Select/specify RMI host (can be different from <server host>).
-r, --rmiurl <value>
Select by full RMI URL.
-t, --timeout <value>
Sets the query timeout (in seconds).
-u, --user <value>
Username used in accessing secure server management.
-p, --passwd <value>
Password used in accessing secure server management.
80PlateSpin Orchestrate 2.0 Command Line Reference
-c, --check
Check and report existing login. Ignores other options.
-V, --debug
Turns on debug output during the login operation.
-v, --verbose
Turns on verbose output during the login operation.
-h, --help
Display a help message for this operation.
Examples
Example 1
To login to server Eng, use the following command:
zosadmin login Eng
novdocx (en) 13 May 2009
Example 2
To check the current login, use the following command:
zosadmin login --check
The zosadmin Command Line Tool81
logout
This command logs out of the PlateSpin Orchestrate Server.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin logout
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-v, --verbose
Specifies the terminal width for formatting. The user must enter a value with this option.
-V, --debug
Turns on debug output during the logout operation.
novdocx (en) 13 May 2009
-h, --help
Displays a help message for this operation.
82PlateSpin Orchestrate 2.0 Command Line Reference
nodes
This command retrieves a list of all, online, offline, or mismatched nodes.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin nodes [--offline] [--mismatch] [--all]
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-o, --offline
Retrieve a list of offline users and nodes.
-m, --mismatch
Retrieve a list of nodes requiring update because of a version mismatch.
novdocx (en) 13 May 2009
-a, --all
Retrieve a list of all users and nodes.
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
The zosadmin Command Line Tool83
password
This command lets the administrator or developer change his or her password on the PlateSpin
Orchestrate Server.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin password [--passwd=] [--newpasswd=]
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-p, --passwd <value>
Password used for secure server management.
novdocx (en) 13 May 2009
-l, --newpasswd <value>
New password to use for secure remote access.
-v, --verbose
Turns on verbose output during this operation.
-d, --debug
Turns on debug output during this operation.
-h, --help
Displays a help message for this operation.
84PlateSpin Orchestrate 2.0 Command Line Reference
redeploy
This command redeploys a component onto a server.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin redeploy [--session=] file|dir
Arguments
file|dir
Specify the deployable file or a directory containing deployable files.
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
novdocx (en) 13 May 2009
-i, --session <value>
Specifies the deployment session ID.
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
Examples
Example 1
To redeploy the service file
zosadmin redeploy myservice.sar
Example 2
To redeploy the job file
myservice.sar
quickie.job
, use the following command:
, use the following command:
zosadmin redeploy quickie.job
Example 3
To redeploy the job files in directory
zosadmin redeploy /test/myjob.job
/test/myjob.job
, use the following command:
The zosadmin Command Line Tool85
rotatelogs
This command backs up and rotates the log files.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin rotatelogs
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
novdocx (en) 13 May 2009
-h, --help
Display a help message for this operation.
86PlateSpin Orchestrate 2.0 Command Line Reference
sessions
This command displays session information.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-i, --id <value>
Display this session for this session ID.
novdocx (en) 13 May 2009
-n, --node <value>
Display sessions for the specified node.
-u, --user <value>
Display sessions for the specified user.
-a, --all
Display sessions for all clients.
-N, --allNodes
Display sessions for all nodes.
-U, --allUsers
Display sessions for all users.
-s, --subSessions
Include subsession entries.
-I, --inactive
Include inactive entries.
-f, --full
Include full session information.
-c, --connaddr
Include local and remote addresses.
-d, --noDns
Do not look up host names in DNS.
The zosadmin Command Line Tool87
-V, --debug
Turn on debug output during this operation.
-v, --verbose
Turn on verbose output during this operation.
-h, --help
Display a help message for this operation.
novdocx (en) 13 May 2009
88PlateSpin Orchestrate 2.0 Command Line Reference
set
This command sets an attribute on an MBean.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin set --mbean= --attr= --value= --type=
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-m, --mbean <value>
Specify the name of the MBean to view.
-a, --attri <value>
Specify the attribute name of the MBean to view.
novdocx (en) 13 May 2009
-o, --value <value>
Specify the attribute value of the MBean to set in string form.
-t, --type <value>
Specify the attribute value type to convert string form into (String/Boolean/Integer).
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
Examples
Example 1
To change the node autoregistration to true, use the following command:
zosadmin set --mbean=local:facility=authenticationManager,properties=auth -attr=AutoregisterUnauthAgent --value=true --type=Boolean
The zosadmin Command Line Tool89
start
This command starts a local server.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-d, --dir <value>
Specify the working directory for a PlateSpin Orchestrate installation.
novdocx (en) 13 May 2009
-b, --jvmargs <value>
Pass the value as an argument to an invoked JVM process.
-B, --javaargs <value>
Pass the value as an argument to an invoked Java program.
-t, --timeout <value>
Specify the query timeout (in seconds).
-G, --upgrade
Switch upgrade behavior for snapshot handling.
-S, --snapshot=
Upgrade a server using the snapshot directory of an existing server.
-V, --debug
Turn on debug output during this operation.
-v, --verbose
Turn on verbose output during this operation.
-h, --help
Display a help message for this operation.
Examples
Example 1
To start a server instance using the install directory (default), use the following command:
zosadmin start
90PlateSpin Orchestrate 2.0 Command Line Reference
Example 2
novdocx (en) 13 May 2009
To start a server instance using directory
zosadmin start --dir=/zos/server
/zos/server/
, use the following command:
Example 3
To start a server instance and upgrade from an existing server snapshot, use the following command:
NOTE: Before you use this option, you must be using the “zosadmin upgrade” command to
manually upgrade the server configuration snapshot.
Example 4
To start a server instance setting the JVM maximum memory to be 4 Gb:
zosadmin start --jvmargs=-Xmx4g
The zosadmin Command Line Tool91
status
This command displays the status of a server (including information on managed components)
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin status [--mbeans] [--sessions] [--facilities]
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-m, --mbeans
Retrieve the list of all MBeans.
-s, --sessions
Display deployment sessions ID along with component name.
novdocx (en) 13 May 2009
-f, --facilities
Retrieve information on all facilities.
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
92PlateSpin Orchestrate 2.0 Command Line Reference
stop
This command shuts down the PlateSpin Orchestrate Server.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin stop [--force] [--snap]
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-f, --force
Do not prompt for server shutdown confirmation.
-s, --snap
Create a snapshot of server state for use in a later upgrade.
novdocx (en) 13 May 2009
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
Examples
Example 1
To stop a server instance without prompting for confirmation, use the following command:
zosadmin stop --force
Example 2
To stop a server instance and create a snapshot, use the following command:
zosadmin stop --snap
The zosadmin Command Line Tool93
undeploy
This command undeploys a component from the server.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin undeploy [--session=] component|dir
Arguments
component|dir
Specify the deployed file or a directory containing the deployed files.
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
novdocx (en) 13 May 2009
-i, --session <value>
Specify the deployment session ID.
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
Examples
Example 1
To undeploy the service
zosadmin undeploy myservice.sar
Example 2
To undeploy the job file
myservice.sar
quickie.job
, use the following command:
from the server, use the following command:
zosadmin undeploy quickie.job
Example 3
To undeploy the job files in directory
zosadmin undeploy /test/myjob.job
94PlateSpin Orchestrate 2.0 Command Line Reference
/test/myjob.job
, use the following command:
upgrade
This command upgrades an older server snapshot to a current version.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin upgrade snapshotdir
Arguments
snapshotdir
Specify the directory containing a server configuration snapshot.
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
novdocx (en) 13 May 2009
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
NOTE: The
zosadmin create
transformed configuration snapshot.
zosadmin upgrade
and
zosadmin start
command does not actually upgrade a server instance. Use the
commands for manually upgrading an instance using a
Examples
Example 1
To upgrade the server snapshot in the current directory, use the following command:
zosadmin upgrade ./snapshot
The zosadmin Command Line Tool95
users
This command retrieves a list of all active or inactive users.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin users [--offline] [--all]
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
-o, --offline
Retrieve a list of offline users/nodes.
-a, --all
Retrieve a list of all users/nodes.
novdocx (en) 13 May 2009
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
96PlateSpin Orchestrate 2.0 Command Line Reference
verify
This command verifies a component for syntax.
Syntax
Enter the command using the syntax shown below. Available options are shown in brackets.
zosadmin verify file
Arguments
file
Specify the deployable file to verify.
Options
When you add an option, use the syntax in the command line as shown above (where options are
shown in their long form). Short and long options for this command are listed below.
novdocx (en) 13 May 2009
-v, --verbose
Turn on verbose output during this operation.
-V, --debug
Turn on debug output during this operation.
-h, --help
Display a help message for this operation.
Examples
Example 1
To verify the policy file
zosadmin verify myjob.policy
Example 2
To verify the schedule file
command:
zosadmin verify mysched.sched --debug
myjob.policy
mysched.sched
, use the following command:
and dump reconstituted XML, use the following
The zosadmin Command Line Tool97
novdocx (en) 13 May 2009
98PlateSpin Orchestrate 2.0 Command Line Reference
A
Documentation Updates
This section contains information about documentation content changes that were made in this
PlateSpin Orchestrate Command Line Reference after the initial release of PlateSpin Orchestrate
2.0. The changes are listed according to the date they were published.
The documentation for this product is provided on the Web in two formats: HTML and PDF. The
HTML and PDF documentation are both kept up-to-date with the changes listed in this section.
If you need to know whether a copy of the PDF documentation that you are using is the most recent,
the PDF document includes a publication date on the title page.
The documentation was updated on the following dates:
A.1 May 15, 2009 (2.0.2 Release)
Updates were made to the following sections:
novdocx (en) 13 May 2009
A
LocationChange
auditclean (page 65)Added audit command options for action status.
auditcount (page 66)Added audit command options for action status.
auditreport (page 67)Added audit command options for action status.
Documentation Updates
99
novdocx (en) 13 May 2009
100 PlateSpin Orchestrate 2.0 Command Line Reference
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.