Changes

From Amahi Wiki
Jump to: navigation, search
{{WorkInProgress}}
'''Last Update:''' May 22, 2022
=Objective=
This is a project to update and modernize the infrastructure that keeps the Amahi web sites and services running.
=Goals=
We have multiple goals:
* run some of Operate internal build machines in a reliable, efficient way, so that we have consistent and updated builds/releases* have consistent Consistent and recent backups making things recoverable* run Execute some testing of Amahi apps more easily and efficiently* test Test new features in an isolated manner
=Known IssuesConfiguration=* Cannot use multiple SSH keys via Dashboard '''Dell Server ([httpsF1DH)://bugs.launchpad.net/nova/+bug/1499751 OpenStack Bug #1499751]) =Hardware=Dell Rack Server'''
* Dual Xeon E5450 3.0 GHz Processors
* 32GB PC2-5300 RAM (8x4)* Two Gigabit Network InterfacesInterface
* KVM Network Interface
* RAID Controller
<br>'''Server #1 (CURRENT):'''* OpenStack release Yoga* Operating System: CentOS 8 Stream* 32GB PC2-5300 RAM (8x4)* Four Quick Swap Drive Bays** 1 - 1 TB 1TB** 2 - 750GB (OSBackup)** 2 3 - EmptyEMPTY** 3 4 - 750 GB EMPTY<br>'''Server #2 (BackupBACKUP):'''* OpenStack release Wallaby*Operating System: CentOS 8 Stream* 4 24GB PC2- Empty5300 RAM (4x2/8x2)* Quick Swap Drive Bays=Software=** 1 - 850GB (LVM)* CentOS 7.* 2 x86_64 - EMPTY** 3 - 120GB SSD (MinimalBackup)* [https://releases.openstack.org/ OpenStack] Ocata Release* 4 - EMPTY
=Setup=
The following guidance is based on the latest release of OpenStack (Yoga):
<ul>
<li> Download [https://www.centos.org/download/ CentOS 8 Stream] minmal image and install following [https://linuxhint.com/install_centos8_netboot_iso/ Installing CentOS 8 using NetBoot ISO Image] tutorial (use LVM, but remove ''/home'' partition and redistribute space to ''/''). </li>
<li> [https://linuxconfig.org/rhel-8-configure-static-ip-address Set Static IP Address] and [https://techjourney.net/how-to-set-change-hostname-fqdn-fully-qualified-domain-name-in-rhel-centos-7/ configure Fully Qualified Domain Name], then reboot</li>
<li> Follow step 0 - 3 of the [https://www.rdoproject.org/install/packstack/ RDO Packstack Quickstart] for the OpenStack installation (ensure step 0 prerequisites are completed first).</li>
<li> At step 4, follow the [https://www.rdoproject.org/networking/neutron-with-existing-external-network/ Neutron with existing network guidance]:</li>
<ul>
<li> Use command: <code>packstack --allinone --provision-demo=n --cinder-volumes-size=100G --keystone-admin-passwd={set password} --os-neutron-ml2-mechanism-drivers=openvswitch --os-neutron-ml2-tenant-network-types=vxlan --os-neutron-ml2-type-drivers=vxlan,flat,vlan --os-neutron-l2-agent=openvswitch --os-neutron-ovs-bridge-mappings=extnet:br-ex --os-neutron-ovs-bridge-interfaces=br-ex:eth0 --nova-libvirt-virt-type=kvm</code> (replace {set password} and ''eth0'' with appropriate values)</li>
<li> Skip down to ''Now, create the external network with Neutron.'' and follow guidance.</li>
<li> Next move to ''Then create a router and set its gateway using the external network...'' and follow remaining guidance.</li>
</ul>
<li> Set up the floating IP addresses to the external network.</li>
<li> Create flavors named ''amahi.small'' of 10GB and ''amahi.medium'' of 15GB.
<li> Add the following rules to ''default'' Security Group (Ingress, IPv4, Remote IP 0.0.0.0):
<ul>
<li> Download [http:ICMP /Any</mirrors.cat.pdx.eduli><li> TCP /centos22</7/isos/x86_64/CentOS-7-x86_64-Minimal-1611.iso CentOS 7.2 x86_64 minimal] image and install following [http://www.if-not-true-then-false.comli><li> TCP /2014/centos-7-netinstall-guide/ CentOS 7.2 Netinstall Guide] tutorial. 80</li><li> Configure FQDN (<code>/etcTCP /hosts3000</codeli> and <codeli>TCP /etc/hostname443 (<i>Optional</codei>)</li></ul>
<li> Add users and private keys for SSH login</li>
<li> Disable SSH password and root login</li>
<li> Follow step 0 - 3 of the [[media:Packstack quickstart.pdf|RDO Packstack Quickstart]] for the Open Stack installation (ensure step 0 prerequisites are completed first).Add users to web UI access</li><li> At the <code>packstack --allinone</code> step, follow the [[media:Neutron with existing external network.pdf|Neutron with existing network guidance]] instead (omit <code>–os-neutron-ovs-bridge-interfaces=br-ex:eth0</code> argument). Networks can also be setup with the web UI (preferred).Ensure OS updates applied and reboot</li><li> Refer to [[media:Floating ip range.pdf|floating IP range]] for setting up the Create a single instance with floating IP addresses to the external network. This can also now be done with the web UI (preferred).</li><li> Create flavor named ''amahi.small'' of 10GBVerify all is working as expected.<li> Extend cinder-volumes past 20GB:</li></ul>  <lib> Followed the [[mediaNOTE:Openstack_increase_volume_capacity.pdf|OpenStack increase volume capacity]] and [[media:Maintaining_Loopback_devices_after_reboot.pdf|Maintaining loopback devices after reboot]] tutorials (i.e. highlighted text)</lib><li> Results in 50Gb additional space A terminal script has been developed to automate the installation steps above for volumes.</li><li> Total volume space available OpenStack after CentOS is now 70GBinstalled.</li></ul></ul>
=Naming Convention=
The following is recommended for standardization:
* Instances: '''os-function''' (i.e. ''f24-bot'', ''f24-repo'', ''f24-dev'', etc)
* Images: '''os-type''' (i.e. ''f24-cd'', ''f24-dvd'', etc)
* Snapshot: '''os-function-ss#''' (i.e. ''f24-repo-ss1'', ''f24-bot-ss2'', etc)
* Volumes: '''instance-vol''' (i.e. ''f24-repo-vol'', ''mirrormgr-vol'', ''dl-masterdlmaster-vol'', etc)
=Build Images=
This will outline how to build OpenStack images using [https://www.proxmox.com/en/ Proxmox VE](alternate method in development).
* Log into Proxmox VE web UI
* Create a VM or clone an existing one(<code><i>type</i>=qemu64</code>)
** If creating a VM, install the OS
** If using a clone, start the VM
* Open a console window for the VM
** Log in and as <code>root </code> do the following
*** <code>dd if=/dev/zero of=/mytempfile bs=1M</code> (zero out any unused space)
*** <code>rm -f /mytempfile</code>
** Shutdown VM
** Log into Proxmox VE via SSH and execute the following from command line
*** Navigate to <code>/vardev/lib/vz/images/###pve</code> (number of VM)*** <code>mv original_image.qcow2 original_image.qcow2_backup</code> (rename original image)*** <code>qemu-img convert -O qcow2 original_image.qcow2_backup original_imagenew_image.qcow2</code>*** Copy new <code>new_image.qcow2</code> image to a safe location for uploading into OpenStack*** Remove <code>.backup</code> file
*** Delete the VM from Proxmox VE web UI
* Use WINScp WinSCP or similar program to copy the <code>new_image.qcow2</code> image to client machine
* Upload into OpenStack via the web UI
'''REFReference:''' [httphttps://wwwgazelle.jamescoyleihe.net/how-tobook/323-reclaim-disk-space-from-a-sparse-image-file-qcow2-vmdk Reclaim disk space from .qcow2 or .vmdk imageexport/html/917 Transfer Proxmox VM]
=Create Instance=
This is a nice straightforward tutorial on [https://communitywww.hpcloudtecmint.com/article/creatingcreate-deploy-and-launch-virtual-yourmachines-firstin-openstack/ how to deploy and launch an instance(VM)]. Also refer to [https://docs.openstack.org/mitaka/user-0 Creating an guide/cli_nova_launch_instance_using_ISO_image.html launch instancefrom ISO]for an alternate method.
=Backup=
'''Last Backup completed:''' * Instances - ''04 Jul 2021''6 Aug 2017* Volumes - ''04 Jul 2021''  <br />'''NOTES:'''
* Back up scripts have been created to synchronize instances, volumes, and snapshots to a secondary drive on demand.
* Recommend Minimal of monthly back ups be done in case of catastrophic failure.* See [https://github.com/Nexenture/openstack-instances-backups OpenStack Instance Backups] to automate via terminal script (some modification is needed).
=Tips=
==Command Line==
[https://docs.openstack.org/python-openstackclient/ussuri/ OpenStack Command Line Guide]
==Network Issues==
If the DNS server is changed or networking appears inoperable, check the following to ensure the DNS is correct:
Next restart neutron network services:
<blockquotecode><code>:service neutron-server restart<br />:service neutron-dhcp-agent restart<br />:service neutron-l3-agent restart<br />:service neutron-metadata-agent restart<br />:service neutron-openvswitch-agent restart</code></blockquote>
==Volume Issues==
Also refer to [https://bugs.amahi.org/issues/2051 Amahi Bug #2051].
 
==Instance Issues==
When an instance '''Status''' reflects an ''error'' state, reset it by:
<code>
:source keystonerc_admin
:nova reset-state --active INSTANCE_ID
</code>
 
'''NOTE:''' Should the '''Power State''' reflect ''no state'' or blank, it can be corrected by doing the above step, then starting the instance.
==Update/Reboot/Shutdown Process==
Follow guidelines below to prevent corruption:
* Shutdown/Disconnect
** Stop all instances
** Verify all instances stopped
** Perform Update/Reboot/Shutdown <br>
* Once system Started/Rebooted:
** Start all needed instances
* As root user, execute <code>source keystonerc_admin</code>
* Use the following to reserve the IP address:
:<code>neutron :openstack portcreate --create private_network network private --fixed-ip subnet_id=private_subnet,ip_address=x.x.x.xstatic-ip-1</code>
* Create the instance and boot via command-line vs the web UI:
:<code>nova boot :openstack server create --image NAME_OF_IMAGE IMAGE_NAME --flavor amahi.small --nic port-id=ID_FOR NETWORK_FROM_ABOVE_COMMAND_RESULTS VM_NAMENETWORK_ID_FROM_ABOVE_COMMAND INSTANCE_NAME</code>
:'''NOTE:''' If image name has spaces, enclose it in double quotes.
Ref: [https://ask.openstack.org/en/question/30690/add-multiple-specific-ips-to-instance/ Add Multiple Specific IPs to Instance]
==Fedora Cloud ImagesChange Instance Flavor==As ''root'' user:<code>:source keystonerc_admin</code>See [https://wwwdocs.rdoprojectopenstack.org/Running_an_instance#Step_5:_Launch_the_instance Launch Fedora Cloud imagesnewton/user-guide/cli-change-the-size-of-your-server Change the size of your server] for command line guidance.
== Transfer Fedora Cloud Base Images ==See [https://raymiialt.fedoraproject.org/scloud/tutorials/Openstack_Glance_Image_Download.html OpenStack Glance Image Download TutorialFedora Cloud Base Images] for how to transfer images from on server to anotherguidance.
== Transfer Snapshots Migration ===== Images ===See [https://communities.ciscoraymii.comorg/communitys/developertutorials/openstack/blog/2017/01/13/how-to-snapshot-an-openstack-nova-instance-boot-it-download-and-upload-it Snapshot an Openstack_Glance_Image_Download.html OpenStack instance and download itGlance Image Download Tutorial] for how to transfer snapshots images from one instance server to another.
== Transfer Volumes = Snapshots ===See [httphttps://blogcommunity.oddbitcisco.com/2015t5/09cloud-blogs/29/migratinghow-cinderto-volumessnapshot-betweenan-openstack-environmentsnova-instance-boot-it-download/ba-p/ Migrating cinder volumes between Open Stack environments3661228 Snapshot an OpenStack instance, boot it, and download] for how to transfer volumes snapshots from one instance to another.
==Miscellaneous= Volumes ===Refer to See [httpshttp://bugsblog.amahioddbit.orgcom/2015/09/issues29/2050 Amahi Bug #2050migrating-cinder-volumes-between-openstack-environments/ Migrating cinder volumes between OpenStack environments] for some OpenStack Commandhow to transfer volumes from one instance to another. ==Fix Broken Web UI==Add the following line to ''/etc/httpd/conf.d/15-Line syntaxhorizon_vhost.conf'': WSGIApplicationGroup %{GLOBAL}Then restart the web server Ref: [https://ask.openstack.org/en/question/91352/openstack-mitaka-can-not-access-dashboard/ OpenStack cannot access Dashboard] =Known Issues=Cannot use multiple SSH keys via Dashboard ([https://bugs.launchpad.net/nova/+bug/1499751 OpenStack Bug #1499751])<br>
12,424

edits