This topic describes the process of adding a UNIX host using the 3.0 command line interface.

Within Delphix, there are both hosts and host environments. A host represents a remote system, but may or may not be a source or target for linking or provisioning. For example, in an Oracle RAC cluster, the cluster environment represents the location of the Oracle installation(s), and while there are hosts within that cluster they are not individually manageable as environments.


  1. Create a new environment and set the parameter type to be a UNIX host.
    The default is a UNIX host, but for completeness this demonstrates how one would add another type of environment (Oracle cluster or Windows host).

    delphix> environment create
    delphix environment create *> set type=HostEnvironmentCreateParameters
    delphix environment create *> set hostEnvironment.type=UnixHostEnvironment
    delphix environment create *> set hostParameters.type=UnixHostCreateParameters
    delphix environment create *> set primaryUser.credential.type=PasswordCredential
    delphix environment create *> get
        type: HostEnvironmentCreateParameters (*)
            type: UnixHostEnvironment (*)
            name: (unset)
            description: (unset)
        hostEnvironment: (unset)
            type: UnixHostCreateParameters (*)
                type: UnixHost
                addresses: (required)
                sshPort: 22
                toolkitPath: (required)
            type: EnvironmentUser
            name: (required)
                type: PasswordCredential
                password: (required)
            environment: (unset)
  2. Set the host address.
    The name of the environment is derived from the address used, though you can provide a more descriptive name if desired. The addresses can be DNS names, IP addresses, or a comma separated list of the above.

    delphix environment create *> set
  3. Set the toolkit path.
    This is where Delphix will store temporary binaries used while the host is configured as part of Delphix.

    delphix environment create *> set
  4. Set the username and password to use when connecting over SSH.
    This user must have the privileges described in the Delphix Adminsitration Guide. To configure a SSH user, change the credential type to SystemKeyCredential.

    delphix environment create *> set
    delphix environment create *> set primaryUser.credential.password
    Enter primaryUser.credential.password: *******
  5. Commit the result.
    The environment discovery process will execute as an asynchronous job. The default behavior is to wait for the result, so progress will be updated until the discovery process is complete or fails.

    delphix environment create *> commit
        Dispatched job JOB-39
        ENVIRONMENT_CREATE_AND_DISCOVER job started for "".
        ENVIRONMENT_CREATE_AND_DISCOVER job for "" completed successfully.