Using CA AppLogic® › Appliance Developer Guide › Appliance Kit › Appendix › CA AppLogic® Configuration File Formats › Network Configuration File

Network Configuration File

The .net file for an appliance contains the configuration of the appliance's network, in text form that is designed to be easy to interpret in a shell script and be converted to configuration commands to the appliance's network subsystem. Some of the configuration statements in the .net file are compatible directly with the command line format of the ip utility used on all modern Linux distros. The file format is line-based and each line consists of a directive name, followed by parameters.

ncfg_vmname name

Defines the instance name for the appliance. This matches the component name, for example, main.WEB.

ncfg_sshkey type base64data

Defines the appliance-access public SSH key and should be installed by the appliance, if it is to be accessible through the 3t ssh command. The matching private key is owned by the controller.

ncfg_interface name mac-addr

Starts a section with configuration definitions for a CA AppLogic® terminal. The following nt_* directives apply to the terminal specified, up until the next ncfg_interface directive.

ncfg_alias addr name ...

Defines named aliases for an IP address. These will be stored by the appliance in its /etc/hosts file, or otherwise provided to the local name resolution service. ACS provides named aliases the same way as the vol-fix in ABS does, that is: for an input terminal, the terminal's name resolves to its IP address. For an output terminal, the name resolves to the terminal's peer address. Unconnected inputs are aliased to 127.0.0.2 (the loopback interface). Unconnected outputs are aliased to an invalid IP address (will cause connect() and sendto() APIs to fail without delay).

nt_ip addr add laddr peer raddr

Defines a peer-to-peer terminal connection. Most terminals will have exactly one such directive, inputs may have more than one.

nt_ip addr add addr/net

Defines a subnet connection. This is only given for the appliance's default interface and matches the address and netmask provided by DHCP.

nt_ip route add default via addr

Defines a default route. This is only given for a 'gateway' output terminal. The appliance should configure its default gateway to the given address and set its name server to that address too.

ncfg_sshkey

Public SSH key to install.