new (Command)

new

The new command installs, configures, and starts a new CA AppLogic® for System z grid on an LPAR.

This command has the following format:

aldo new grid=gridname [file=configfile] [opt=val ...]

grid=gridname

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

file=configfile

Specifies an additional configuration file. This option can appear multiple times on the command line.

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

servers=ip address

Specifies the IP address of a single server that acts as the Server Controller for the new grid. The IP address identifies the server accessible on the external network. See Configuration Options.

controller_ip=ip address

Specifies the IP address of a single server that acts as the Grid Controller for the new grid.

grid_id=M/N

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

ips=ips

Specifies at least one IP range on an external network available to CA AppLogic® applications. An application that accidentally or deliberately uses an address outside of the allowed ranges is not able to communicate. The assigned IP address ranges are also displayed on the controller dashboard. See Configuration Options for more information about the ips setting.

Example: ips=1.2.3.2-1.2.3.99/255.255.255.0:1.2.3.1

Where:

application IP range: 1.2.3.2-1.2.3.99

netmask: 255.255.255.0

gateway: 1.2.3.1

Examples: Set Up a New Grid

This example sets up a new grid, specifying all necessary parameters directly on the command line:

aldo new grid=test2 grid_id=1/1 controller_ip=10.64.10.20 servers=10.64.10.21 ext_gateway=10.64.10.1 account_id=myacct account_key=/root/myacct.pri ips=1.2.3.2-1.2.3.99/255.255.255.0:1.2.3.1

This example sets up a new grid, with all parameters specified in a premade configuration file for the grid:
```
aldo new file=mygrid.cfg
```

Remarks

The specified server addresses must not be in use. If the specified an address is in use, the command is aborted. The external gateway IP address must be specified explicitly. The aldo prepare command must have created the VM hosting the server controller for the grid. The VM must have been authorized for SMAPI use.