D.68 tarantella prepare instance

Prepares and configures a VM instance of an SGD deployment.

Syntax

tarantella prepare instance { 
                             [ --external-name name]
                             [ --no-dhparam-regen ]
                             [ --no-prompt ] }

Description

This command is used for manual preparation of an SGD instance. For example, when an Administrator starts the SGD instance for the first time.

Note

If you are using a deployment script to integrate with a cloud service, this command is usually not required.

When run without any options, this command uses the settings configured when preparing the VM template image. See Section D.67, “tarantella prepare image”.

The following table shows the available options for this command.

Option

Description

--externalname

The hostname to be used for the VM instance. This will override any hostname returned by a deployment script.

Enter a fully qualified DNS name.

--no-dhparam-regen

Do not generate new Diffie-Hellman (DH) parameters for the VM instance.

Enabling this option results in quicker start up of the VM instance, but means that client connections are less secure.

Note

To use the most secure encryption for client connections, do not enable this option.

--no-prompt

Do not show on-screen prompts, asking the user to enter further information for the VM instance.

This option overrides any configuration for on-screen prompts that have been made using the tarantella prepare image command.

Examples

The following example prepares and configures a VM instance manually. The configuration prepared for the VM template image is used.

# tarantella prepare instance

The following example prepares and configures a VM instance manually. The hostname of the VM is set as sgd1.example.com.

# tarantella prepare instance --external-name sgd1.example.com

The following example prepares and configures a VM instance manually. On start up of the VM instance, new Diffie-Hellman parameters are not generated.

# tarantella prepare instance --no-dhparam-regen 
Note

Using the --no-dhparam-regen option means that the security of client connections is reduced. To use the most secure encryption for client connections, do not enable this option.