* 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 Issues=None =HardwareConfiguration='''Dell Rack Server(F1DH):'''

* 32GB PC2-5300 RAM (8x4)* Two Gigabit Network InterfacesInterface

<br>'''Server #1 (CURRENT):'''* OpenStack release Yoga* Operating System: CentOS 8 Stream* 32GB PC2-5300 RAM (8x4)* Four Quick Swap Drive Bays** 1 - 850GB 1TB** 2 - 750GB (OS and Backup)** 3 - EMPTY** 4 - EMPTY<br>'''Server #2 (BACKUP):'''* OpenStack release Wallaby* Operating System: CentOS 8 Stream* 24GB PC2- 2 TB 5300 RAM (4x2/8x2)* Quick Swap Drive Bays** 1 - 850GB (Images and BackupLVM)** 2 - EMPTY** 3 - 120GB SSD (VMsBackup)** 4 - EmptyEMPTY =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> ICMP / Any</li><li> TCP / 22</li><li> TCP / 80</li><li> TCP / 3000</li><li> TCP / 443 (<i>Optional</i>)</li></ul><li> Add users and private keys for SSH login</li><li> Disable SSH password and root login</li><li> Add users to web UI access</li><li> Ensure OS updates applied and reboot</li><li> Create a single instance with floating IP</li><li> Verify all is working as expected.</li></ul>

<b>NOTE:</b> A terminal script has been developed to automate the installation steps above for OpenStack after CentOS is installed. =SetupNaming Convention=Work in progressThe 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'', ''dlmaster-vol'', etc)

This will outline how to build OpenStack images using [https://www.proxmox.com/en/ Proxmox VE] (alternate method in development).

* 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

*# * 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>/var/lib/vz/imagesdev/###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

'''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]

This is a nice straight forward 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''* Volumes - ''04 Jul 2021'' 

* ''/etc/resolve.conf''

<precode>: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</precode>

:<code>:source keystonerc_admin</code>:<code>cinder reset-state ''volume_id''</code>

** Stop all instances via SSH** Detach volumes from instances (not needed in Mitaka)** Verify all volumes detached and instances stopped** Perform Update/Reboot/Shutdown<br>* Once system rebootedStarted/Rebooted:** Verify cinder_volumes (LVM) is operational** Reattach volumes to instances (not needed in Mitaka)

neutron <code>:openstack portcreate -create internal -network private --fixed-ip subnet_id=internal_subnetprivate_subnet,ip_address=x.x.x.xstatic-ip-1</code>

nova boot <code>: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>

==Change Instance Flavor==As ''root'' user:<code>:source keystonerc_admin</code>See [https://docs.openstack.org/newton/user-guide/cli-change-the-size-of-your-server Change the size of your server] for command line guidance. ==Fedora Cloud Base Images==See [https://wwwalt.rdoprojectfedoraproject.org/Running_an_instance#Step_5:_Launch_the_instance Launch cloud/ Fedora Cloud Base Images] for guidance. == Migration ===== Images ===See [https://raymii.org/s/tutorials/Openstack_Glance_Image_Download.html OpenStack Glance Image Download Tutorial] for how to transfer imagesfrom one server to another. === Snapshots ===See [https://community.cisco.com/t5/cloud-blogs/how-to-snapshot-an-openstack-nova-instance-boot-it-download/ba-p/3661228 Snapshot an OpenStack instance, boot it, and download] for guidancehow to transfer 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>