Difference between revisions of "SaltStackImplementationNotes"
(Add salt-stack repository information for base build.) |
m (→Initial installation from CD: Fix misuse of template syntax) |
||
Line 42: | Line 42: | ||
## Full name for new user: '''Jedd''' | ## Full name for new user: '''Jedd''' | ||
## Username for your account: '''jedd''' | ## Username for your account: '''jedd''' | ||
− | ## Password created: ''' | + | ## Password created: ''' redacted ''' |
## Encrypt home directory: '''No''' | ## Encrypt home directory: '''No''' | ||
# Configure the clock | # Configure the clock |
Revision as of 14:00, 20 September 2016
About this page
Notes for the SaltStack implementation - a key component of the Migration_2016 project.
Some components of this page will be migrated into the Administrative_reference page, others may be removed as the system configuration documentation should become the SaltStack configuration (replete with in-line comments where appropriate). Part of this process will be to remove many of the historical build / config addenda described in each of the host-specific pages, as, again, history for these changes is described and defined within the SaltStack configuration repository (git or svn).
Base builds
This section describes a base Ubuntu 2016.04 (LTS) build.
A base build is everything that's done prior to being able to run the first SaltStack 'high state' command. Many of the configurations defined within the base (install) process are later confirmed & maintained by SaltStack, but are documented here for completeness.
Initial lab environment:
- 2GB RAM
- 1 x core CPU
- Single SCSI-emulated 20GB disk
- Ubuntu 16.04.1 AMD64 CD (iso)
- VMware ESXi
Initial installation from CD
- Boot from CD
- Language - Select English
- Installation Option - Select Install Ubuntu Server
- Langage - Select English
- Country - Select Australia
- Configure the Keyboard
- Do not auto-detect keyboard
- English (US)
- English (US) again
- Network Configuration
- DHCP attempt - in lab environment this will fail
- Configure network manually
- IP address: 10.6.1.200
- NetMask: 255.255.255.0
- Gateway: 10.6.1.1
- DNS: 192.168.1.1
- Hostname: baseprogclub (Unique string useful to search for later)
- Domain name: .lab
- Set up users and passwords
- Full name for new user: Jedd
- Username for your account: jedd
- Password created: redacted
- Encrypt home directory: No
- Configure the clock
- Timezone autodetection successful (Australia / NSW) - Select Yes
- Partition Disks
- Select - Guided - use entire disk
- Disk to partition - lab environment has only single disk - SCSI3 /dev/sda
- This defaults to sda1 (ext4) and sda5 (swap) with non-specified capacity
- @TODO Revisit this - ideally discard swap partitions in favour of swapfiles
- Write changes to disk
- Installing the system
- Configure the package manager
- Select no proxy for HTTP
- Configure TaskSel
- Select No automatic updates
- Software selection - select standard system utilities and OpenSSH server
- Install the GRUB boot loader
- Select 'Yes
- Nota bene: Finalising the installation takes a LONG time - notably building the initramfs on /target/boot
- Finish the installation
- Eject the (logical) CDROM and select Continue
Initial configuration on first boot
Once the base build has installed and rebooted, we need to configure common items to let us bootstrap SaltStack
Login, and sudo bash (or sudo all these separately)
Run this to get the apt key installed for saltstack:
wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
Add this content to the file: /etc/apt/sources.list.d/saltstack.list
deb http://repo.saltstack.com/apt/ubuntu/16.04/amd64/latest xenial main
Run:
apt-get update
Confirm by running:
apt-cache show salt-minion | grep -i version
Should show 2016.3.3+ds-1 or later. (Raw xenial (Ubuntu 16.04) references only version 2015.8.8+ds-1)