This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
pub:ubuntu_14.04_campus_build [2015/04/06 18:55] rlhaffer |
pub:ubuntu_14.04_campus_build [2022/05/06 20:15] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Campus Ubuntu 14.04 Foreman/Puppet Installation ====== | + | ====== Campus Ubuntu 14.04 Foreman |
The current 14.04 build has been tested on: | The current 14.04 build has been tested on: | ||
Line 27: | Line 27: | ||
- Register the system to the correct owner/group just like any other system in our mst-users domain. | - Register the system to the correct owner/group just like any other system in our mst-users domain. | ||
+ | - {{: | ||
- Under the NetDB options, set the DHCP option to **PXE-RST** | - Under the NetDB options, set the DHCP option to **PXE-RST** | ||
- Add the proper location and description to the system. | - Add the proper location and description to the system. | ||
- In the Admin comments section, add **Ubuntu 14.04 Workstation**. | - In the Admin comments section, add **Ubuntu 14.04 Workstation**. | ||
+ | - {{: | ||
+ | |||
====Rebooting to iPXE==== | ====Rebooting to iPXE==== | ||
Line 36: | Line 39: | ||
- Based on the correct DHCP option in NetDB, this will then boot to our iPXE server. | - Based on the correct DHCP option in NetDB, this will then boot to our iPXE server. | ||
+ | * iPXE boot screen | ||
+ | {{: | ||
+ | |||
+ | * ITRSS iPXE Menu | ||
+ | * Select **Foreman Discovery Image** | ||
+ | * | ||
+ | {{: | ||
+ | |||
+ | |||
+ | ====NOTES about Foreman/ | ||
+ | * Foreman/ | ||
+ | * Effectively, | ||
+ | |||
+ | While the Discovery Image is loading, open a browser and go to [[https:// | ||
+ | * Accept the security certificate if prompted. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | As the image boots, when it gets to the point where you see what is in the < | ||
+ | |||
+ | {{: | ||
+ | |||
+ | We have hostname based provisioning configured, however if you are using a custom host name you may be required to use the steps below regarding discovered hosts. You will know this to be the case if the host doesn' | ||
+ | |||
+ | Back on the Foreman website, click on the **Hosts > Discovered Hosts** menu. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Click on the **mac############ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Clicking on the **mac############ | ||
+ | **Provisioning** is what Foreman does to configure the system to build and this page is a summary of what Foreman knows about the system as this point.\\ | ||
+ | Click the blue <fc # | ||
+ | |||
+ | {{: | ||
+ | |||
+ | When provisioning, | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Here, enter the name of the system. | ||
+ | Under the **Host Group**, select **Workstation**. | ||
+ | * These are different, pre-configured options to tell Foreman what to install, based on the need of the system.\\ | ||
+ | * Most of what we do are **Workstations**, | ||
+ | |||
+ | Next, click on the **Puppet Classes** tab. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Basically, the Puppet Classes are the packages we have created for Foreman to install.\\ | ||
+ | Similar to our template generator, where we select the software we want to install, the classes operate in a similar manner.\\ | ||
+ | |||
+ | When you expand the wk_pkgs (workstation packages), selecting the **+** sign next to the package name, adds that package to the build list. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Once the correct packages are added, visit the **Network** tab.\\ | ||
+ | |||
+ | * Everything here is auto-populated. | ||
+ | |||
+ | |||
+ | After the Network tab is the **Operating System** tab. | ||
+ | In a larger setting, where multiple operating systems are supported, this is the summary page telling the installer what will be used.\\ | ||
+ | Everything here is set be default.\\ | ||
+ | * Our Ubuntu workstation build is about 10GB in size. | ||
+ | * We usually make virtual machines in the 50GB+ range, to accommodate for user data or other software packages like Ansys or Matlab.\\ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | After the OS tab, comes the **Parameters** Tab.\\ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Again, options here are set as default, but we can add localadmins and localusers. | ||
+ | [[Add Privileges to Users on Campus Ubuntu]]\\ | ||
+ | |||
+ | On the **Additional Information** tab, this lists the machine owner, or really the installer that built the system.\\ | ||
+ | The Hardware Model is just that, desktop models, precision models, VMware, Virtualbox, etc.\\ | ||
+ | The Comments section can contain details about the build, its purpose, specific non-campus software, or other special considerations.\\ | ||
+ | |||
+ | |||
+ | =====Installation===== | ||
+ | |||
+ | Now that each tab has been seen and updated, the configuration is ready.\\ | ||
+ | Click the blue <fc # | ||
+ | |||
+ | You will see it being the preseed installation, | ||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | Now, at the end of the magenta install screens, there will come a point where you will see this.\\ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | This screen is somewhat deceiving. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | When the build is complete you should see this:\\ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | At this point, the system is ready to be logged into.\\ | ||
+ | |||
+ | There are more finer points to the build, like the S drive, printers and adding other software from the Ubuntu repos or elsewhere.\\ | ||
+ | Those tutorials are in process.\\ | ||
+ | |||
+ | =====Adding Software===== | ||
+ | |||
+ | Adding supported software titles to an existing installation is as easy as editing the host in foreman, visit [[https:// | ||
+ | |||
+ | |||
+ | {{: | ||
+ | |||
+ | Then click the Puppet Classes tab and wk_pkgs, the plus button adds the package to the machine and it should begin installing inside 30 minutes of being added to the system.\\ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | =====Troubleshooting===== | ||
+ | |||
+ | ====DNS conflict errors==== | ||
+ | Sometimes Foreman will not flush it's dns entries of systems that have long since changed IP addresses and the system you are trying to build will grab an IP that the Foreman server thinks is someone else. This causes a dns reverse lookup error to occur, to resolve the conflict we have to remove the offending IP from the reverse lookup table and restart the dns service on rssinst. Here's how you do that: | ||
+ | < | ||
+ | ssh rssinst.srv.mst.edu | ||
+ | sudo -i | ||
+ | cd / | ||
+ | vi db.151.131.in-addr.arpa | ||
+ | </ | ||
+ | |||
+ | In this file IP addresses are broken down by octet in reverse order, see picture: | ||
+ | |||
+ | {{: | ||
+ | |||
+ | For example, if you're looking for IP 131.151.53.112, | ||
+ | |||
+ | Now save the file and go out to the system and restart the bind service. | ||
+ | |||
+ | < | ||
+ | service bind9 restart | ||
+ | </ | ||
+ | |||
+ | Then retry your build attempt. | ||