Before proceeding with the AutomatedSystemInstall new nodes must be added to HCoop's infrastructure.

== Network ==

After deciding on the host name through a poll of the members:

 1. Allocate an addresses from the free list on IpAddresses (and update the page!)
 1. Using the peer1 request portal, add a reverse dns mapping to the hostname
    * You cannot install the machine until the reverse dns mapping has been created; various services rely on the rdns mapping to behave correctly.
 1. Add basic node information to DomTool config
    1. Edit `/afs/hcoop.net/common/etc/domtool/lib/hcoop.dtl` and add definition for `HOSTNAME_ip`
    1. Edit `/afs/hcoop.net/user/h/hc/hcoop/.domtool/hcoop.net` to add a DNS entry for `$HOST.hcoop.net`, using `HOSTNAME_ip`
    1. Apply DomTool configuration (run `DOMTOOL_USER=hcoop domtool hcoop.net`)
    1. Synchronize DomTool library with source code git repository

== Documentation ==

Add the machine to the [[Hardware]] page. KernelVirtualMachine``s go into a sub-section of their current physical node. Note any relevant information such as the resources available for the node, intended purpose, etc.

Make sure the machine is listed on the [[IpAddresses]] page.

After install, update the notes with any quirks of the install (ideally: none, but reality is a work in progress).

== Add to Infrastructure ==

To control the node with DomTool minimally:

 * Add to `Config.nodeIps`
 * Add to `Config.Firewall.firewallNodes`

If you are configuring the node for a specific purpose, you'll need to add it to more configuration. See the DomTool documentation where it exists.

Prepare DomTool for deployment: [[DomTool/Installation]].

Enable mail routing by adding to exim configuration on the mail server (unless [[https://bugzilla.hcoop.net/show_bug.cgi?id=939|Bug 939]] has been fixed, in which case update this documentation with the domtool managed procedure). In the exim config directory:

 * `update-exim4.conf.conf`: Add to `dc_other_hostnames` and `dc_relay_nets`
 * `conf.d/main/01_exim4-config_listmacrosdefs.conf`: Add to `unix_domains`
 * Run `update-exim4.conf`

Add machine server key to Kerberos:

 * SetupNewMachines#ConfigureSSHServer

 * Sync keytabs in `create-user`
 * Create `WebNode` for portal



----
CategorySystemAdministration