Mcl/proxmox

docs/admin/cobbler.md

@@ -0,0 +1,23 @@
+---
+template: admin.html
+title: Cobbler
+---
+
+HPCCF uses [cobbler](https://cobbler.github.io/) for provisioning and managing
+internal [DNS](../dns).
+
+There is a cobbler server per cluster as well as one for the public HPC VLAN.
+
+- `cobbler.hpc` - public HPC VLAN.
+- `cobbler.hive` - hive private and management VLANs
+- `cobbler.farm` - farm 
+- `cobbler.peloton` - peloton
+- `cobbler.franklin` - franklin
+
+`hpc1`, `hpc2`, and `lssc0` do not have associated cobbler servers. 
+
+## Add a new host
+
+```
+cobbler system add --name=<hostname> --profile=infrastructure --netboot=false --interface=default --mac=xx:xx:xx:xx:xx:xx --dns-name=hostname.cluster.hpc.ucdavis.edu --hostname=<hostname> --ip-address=10.11.12.13
+```

docs/admin/ddn.md

@@ -0,0 +1,13 @@
+---
+template: admin.html
+title: DDN
+---
+
+The DDN provides backend storage for proxmox.
+
+## Access
+
+The primary means of administration is via the [web interface](https://sbmf.hpc.ucdavis.edu/).
+You will need to be on the HPC VLAN.
+
+

docs/admin/dns.md

@@ -0,0 +1,15 @@
+---
+template: admin.html
+title: DNS
+---
+
+DNS is split between internal (what machines on one of the HPCCF VLANs
+see) vs. external (what the rest of the campus and world sees).
+
+## External
+
+HPCCF uses [InfoBlox](https://infoblox.ucdavis.edu/) for public-facing DNS.
+
+## Internal
+
+Internal DNS is managed by [cobbler](../cobbler). 

docs/admin/vms.md

@@ -2,3 +2,57 @@
 template: admin.html
 title: Virtual Machines
 ---
+
+HPCCF uses [Proxmox](https://www.proxmox.com/en/) for virtualization.  Current
+servers are `proxmox1`, `proxmox2`, and `proxmox3`.  
+
+To log in, point your browser to `port 8006` on any of the proxmox servers, and choose
+`UCD-CAS` as the realm.  You'll need to be on the HPC VLAN to access the interface.
+
+## Create a new VM
+
+Use [Netbox](../netbox) to locate a free IP address, or allocate one in the appropriate
+[cobbler](../cobbler) server.   See [provisioning](../provisioning) for more information 
+on selecting an IP/hostname and setting up PXE.
+
+### General
+
+Choose an unused VM ID.  Storage areas are pre-created on the DDN, on directory per
+VM ID.  If more need to be created, see the [DDN documentation](../ddn).  Populate
+the "Name" field with your chosen VM name.
+
+### OS
+
+If you're installing a machine via PXE from a cobbler server, choose "Do not use
+any media."
+
+To add a new ISO, copy it to `/mnt/pve/DDN-ISOs/template/iso/` on one of the
+proxmox hosts.
+
+### System
+
+Check the `Qemu Agent` box.
+
+### Disk
+
+Defaults are fine.  Adjust disk size as needed.
+
+### CPU
+
+Use type `x86-64-v3`.  Adjust cores to taste.
+
+### Memory
+
+Recent Ubuntu installer will fail unless you use at least 4096.
+
+### Network
+
+See Netbox for a [list of vlans](https://netbox.hpc.ucdavis.edu/ipam/vlans/).
+
+Make sure to select  `VirtIO (paravirtualized)` for the network type.  
+
+### Finish
+
+Do not forget to add to [DNS](../dns).
+
+If this is a production VM, add the "production" tag.

mkdocs.yml

@@ -42,6 +42,8 @@ nav:
     - Network Architecture: admin/network.md
     - Virtual Machines: admin/vms.md
     - Provisioning: admin/provisioning.md
+    - DNS: admin/dns.md
+    - Cobbler: admin/cobbler.md
     - Configuration: admin/configuration.md # puppet, etc
     - Software: admin/software.md
     - Netbox: admin/netbox.md