Automation Guide

The setup.sh script has command line options that can be used to either fully automate your installation, or used to override defaults.

Installation settings

Option	Meaning
`-c`	Install as a cluster
`-d [path]`	Path to install the simulator into
`-z`	Unattended - do not ask the user any questions. See the NOTE below.

Reconfiguration Settings

Also used at non-cluster install time.

Option	Meaning
`-a`	Disable DHCP (default is enabled)
`-b`	Enable Floppy Boot (default is enabled)
`-c`	Perform a cluster install (default is single node only)
`-d [path]`	The path you want to install the simulator into (default is `/sim`)
`-e [number]`	Additional disks to add. (you normally get 1 or 2 disks).
`-f [0 or 1]`	Amount of documentation to install (1=full documentation, 0=man pages only)
`-i`	Ignore any "defaults" file on disk if one exists
`-j [0 or 1]`	Allow core files to be created (0=no, 1=yes). This is intended for developer use only and is an advanced option.
`-k`	Generate a new mac address
`-l [number]`	Session logging (1=always generate a new log, 2=create a single log with append, 3=create a single log with overwrite)
`-m [number]`	Set the simulators memory to the amount specifed (default is 512)
`-p`	Delete any pulled disks
`-r [0 or 1]`	The disk adapter to put any disks on (added by -e option). Default is adapter 0
`-s`	Enable the Kernel Memory hack (depreciated, use -v 1 instead)
`-t [interface]`	Make the simulator use a specific network interface, e.g. `eth1`
`-u [a-f]`	Disk size that -e option uses. The default is the last disk size manually created or "a" if no others have been created. See here for details on the letters meaning
`-v [0 or 1]`	Select Kernel Memory hack mode (0=disabled, 1=enabled)
`-x`	Allow upgrades
`-z`	Unattended. Do not ask the user any questions. See the NOTE below.

For non-clustered installs you specify all options that you want at the same time from both the Installation Settings and the Reconfiguration Settings list. For clustered installs only the Installation Settings are processed, and for a reconfiguration of an existing simulator only the Reconfiguration Settings are processed.

If the -z option isn’t specified then you will still be asked every question but the default answer will be changed as appropriate.

NOTE: Do not attempt to perform an unattended (-z) upgrade of an existing simulator. Always do this interactively otherwise your simulators disks will be overwritten and the data inside lost.

Examples

An automated install that chooses the built in defaults (e.g. install into /sim, enable DHCP)
[root@localhost /media/cdrom]# ./setup.sh –z

An automated install, with the –d asking to install into the /root/mysimulator directory.
[root@localhost /media/cdrom]# ./setup.sh –z –d /root/mysimulator

Reconfigure a previously configured simulator to decrease the memory from the default 512MB to 128MB
[root@localhost /sim]# ./setup.sh –z –m 96

Reconfigure, but don’t use any defaults from the .setup_defaults file. Ask the user questions, but unless they select otherwise DHCP will be disabled.
[root@localhost /sim]# ./setup.sh -i -a