You can create a new instance on a local or remote machine. When you run the command locally, you can execute commands even when the admin server is not running. However, when this command is executed in local mode, no validations are made to ensure that the --instanceport is not being used by any existing server instances. To validate this execute the create-instance command in remote mode by providing the - -user and --password information. This ensures that the instanceport is not being used by any other server instance.

On a remote machine an administration server is already running for the specified hostname, then the system defaults to the local hostname. To create the instance locally, not requiring the administration server to be up and running, specify the --local option. The named instance must not exist within that domain.

--user

administrative user associated for the instance.

--password

administrative password corresponding to the administrative user.

--host

host name of the machine hosting the administrative instance.

--port

administrative port number associated with the administrative host.

--sysuser

owner of the domain directory.

--domain

name of the domain.

--local

determines if the command should delegate the request to administrative instance or run locally.

--passwordfile

file containing passwords appropriate for the command (e.g., administrative instance).

--secure

if true, uses SSL/TLS to communicate with the administrative instance.

--instanceport

port where the instance listens for requests.

instance_name

name of the instance to be created.

0

command executed successfully

1

error in executing the command

delete-instance(1), start-instance(1), stop-instance(1), restart-instance(1)