create

This command creates a new server instance.

Syntax

Enter the command using the syntax shown below. Available options are shown in brackets.

zosadmin create [--newdir=] [--upgrade=] [--profile=] [--id=] [--grid=] [--clusterhost=] [--user=] [--passwd=] [--rmiport=] [--rmihost=] [--httpport=] [--adminport=] [--agentport=] [--auditurl=] [--audituser=] [--auditpasswd=] [--auditdriver=] [--cert=] [--key=] [<hostname>]

Arguments

hostname

Specify the hostname to use for this server. The default is the system hostname.

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.

Specifically, this command removes everything from the server instance directory except the logs/, dataGrid/, and snapshot/ sub-directories. It then invokes zosadmin upgrade to apply XSL transforms on the /snapshot directory. This last action might be a problem if you want more control over where your snapshot is stored: the --upgrade option assumes that the snapshot exists in the /var/opt/novell/zenworks/zos/server/snapshot default location.

If you want more control or flexibility over where you store the snapshot, use the zosadmin upgrade command and specify the location of the /snapshot directory.

When you use either this command or the zosadmin upgrade command, you need to follow it with the zosadmin start --upgrade command, optionally specifying the location of the upgraded /snapshot directory to complete the upgrade.

NOTE:We recommend that the zosadmin create --upgrade command be used only by advanced users. For most upgrade scenarios, you should use the config or guiconfig scripts for upgrading. For more information, see Upgrading the PlateSpin Orchestrate Server Components in the PlateSpin Orchestrate 2.5 Upgrade Guide.

-e, --profile <value>

Create a new instance based on named profile (the default is server).

-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.

-p, --passwd <value>

Password used in accessing secure remote sites.

-P, --rmiport <value>

Select by RMI port.

-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 Server 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, jdbc:postgresql://localhost/zos_db).

-Y, --audituser <value>

Specify the audit database user.

-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 

Example 3

To create a new server instance in the /zos/myserver/ directory, use the following command:

zosadmin create --newdir=/zos/myserver 

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 

Example 5

To create an upgraded server and reuse saved tls certificates, use the following command:

zosadmin create --newdir=/zos/myserver --upgrade --cert=/tls/cert.pem
     --key=/tls/private.pem