Command Reference › prepare

prepare

The prepare command creates a virtual machine definition which defines the Server Controller for a grid. The prepare command is the first command that must be run when creating a grid.

The prepare command automatically runs the 'aldo check' command before taking any actions. If the 'check' command detects any problems with the configuration of the distribution server, or with the configuration of z/VM, the errors will be reported and the prepare process will be halted.

There are two options special to 'aldo prepare' that change this behavior: skip_check=1 and ignore_check-1.

Upon successful completion of this command, SMAPI authorization can be granted for the virtual machine.

This command has the following format:

aldo prepare grid=gridname grid_id=M.N [file=configfile] [option=val ...] [skip_check=1] [ignore_check=1]

grid=gridname

Specifies the name of the new grid. Short, single word, alphanumeric (for example, grid1, NewYork).

grid_id=M/N

Specifies the grid ID of the new grid. M is 1, and N is the grid number. See Configuration Options.

skip_check=1

Specifies that the prepare command should not run 'aldo check'.

ignore_check=1

Specifies that the prepare command should run 'aldo check', but should not halt if errors are detected.

file=configfile

Specifies a configuration file that contains additional command-line parameters. This option can appear multiple times on the command line. You can specify all command-line parameters in one or more configuration files, or all on the command line, or some on the command line and some in configuration files. Each line of the configuration file should contain one parameter, in the form "option=value". The same options that can be specified fo the 'aldo new' command can be specified for the 'aldo prepare' command. For a list of possible options see Configuration Options.

opt=val

Specifies any configuration parameters to the new command. See Configuration Options. The following settings are required and must appear either on the command line or in one of the configuration files: grid, grid_id.

Note: The following settings are required and must appear either on the command line or in one of the configuration files:

grid

grid_id.