Package: breqwatr-deployment-tool
Breqwatr Deployment ToolThe Breqwatr deployment tool is a toolkit for deploying Breqwatr OpenStack and
its accompanying services. The Breqwatr Deployment Tool is accessed from the
command line of an Ubuntu based OS using the commandbwdt.BWDT requires Docker, and either a removable drive provided by Breqwatr for
offline installs or a special key and ID for configuring the tool to pull files
and images from the upstream servers.InstallationFrom PyPipipinstallbreqwatr-deployment-toolFrom GitHubpipinstallgit+https://github.com/breqwatr/breqwatr-deployment-tool.gitFrom Offline MediaThe offline media will contain a file namedbwdt.tar.gz. Unpack it to a
directory off of the removable media, then install with this command:pipinstall--no-index--find-links<directory>breqwatr-deployment-toolFeaturesHelpbwdt--helpConfigurationBreqwatr deployment tool supports both offline and online installations.# Online Examplebwdtconfigure--key-id<keyID>--key<key>--online# Offline Examplebwdtconfigure--offline--offline-path<directoryofofflinefiles>Docker RegistryStart RegistryLaunch a local Docker registry containerbwdtregistrystartSync Images to RegistrySync an OpenStack image from Breqwatr's upstream online registry to a  locally
hosted registry.bwdtregistrysync-openstack-image<registryurl><imagename>Sync all the required images for an OpenStack deployment to a local registry.bwdtregistrysync-all-openstack-images<registryurl>List Images in RegistryList the images in a local registry and their tagsbwdtregistrylist-images<registryurl>Ubuntu AptBWDT can deploy an optional private Apt service. This allows servers to run theapt-getcommand to install software when they don't have an internet
connection.The Breqwatr Apt container is not a complete mirror, but it does contain all
the required packages to deploy OpenStack along with some other useful ones.The private Apt service also provides a mechanism to limit
OpenStack servers to the Ubuntu packages which Breqwatr has tested, ensuring
the stability of Breqwatr clouds.Start Apt ContainerbwdtaptstartPython PipSimilar to the Apt container, BWDT can deploy a private Pip service.Start Pip ContainerbwdtpipstartPXEBWDT can launch a PXE service based on DNSMasq and Nginx to enable fast,
offline installation of Ubuntu 18.04 on remote servers.Start PXE Containerbwdtpxestart--interfaceenp0s25--dhcp-start10.1.0.90--dhcp-end10.1.0.99AnsibleThe Ansible service is used to deploy OpenStack and supporting tools.Start Ansible ContainerThe--kolla-dirpath helps to keep the files generated on the host.mkdir-p/etc/kolla
bwdtansiblestart\--ssh-key-path<pathtoid_rsa>\--cloud-yml-path<pathtocloud.yml>\--kolla-dir/etc/kollaDeploy OpenstackThe Ansible container leverages some open source Ansible libraries which often
take a long time to run. For that reason, these bwdt commands printdocker execcommands which need to be ran. Surrounding the commands with the$()will make them auto-execute.# generate kolla config$(bwdtansibleopenstackgen-config)# bootstrap the servers$(bwdtansibleopenstackbootstrap)# Deploy openstacl$(bwdtansibleopenstackdeploy)# Post-deploy$(bwdtansibleopenstackpost-deploy)ArcusArcus is Breqwatr's custom web UI, API, and cloud management daemon. Among
other uses, Arcus is a drop-in replacement of OpenStack Horizon.Initialize the Datbasebwdtarcusdatabase-init--host<host>--admin-userroot--admin-pass<password>--arcus-pass<password>Create the Openstack service accountbwdtarcuscreate-service-account--cloud-fqdn<fqdnorvip>--bootstrap-password<passwordofbootstrapuser>--sa-password<passwordforarcusSA>Start the Arcus API servicebwdtarcusapistart\--openstack-fqdn<fqdnorvipforopenstack>\--sql-ip<databaseIPorFQDN>\--sql-password<dbpasswordforarcususer>\--rabbit-ip<serveripaddr1>--rabbit-ip<server2>--rabbit-ip<server3>\--rabbit-pass<rabbitmqopenstackuserpassword>Start the Arcus Clientbwdtarcusclientstart\--openstack-ip<viporfqdntoopenstack>\--glance-https\--api-ip<viporfqdnofarcus-api>\--arcus-https\--cert-path<pathtoHTTPScertificatefile>--cert-key-path<pathtoHTTPScertificateprivatekeyfile>Start the Arcus MgrThe Arcus Mgr needs Kolla-Ansible's files to do some things like repairing
Mariadb when it goes down. Distribute those files to the control nodes first.Also ensure the Arcus Manager has an SSH key which is authorized to each
OpenStack server.# From the Deployment Serverbwdtansibletransfer-kolla-dir--server-ip<ipaddress># On the OpenStack control nodebwdtarcusmgrstart\--kolla-dir<directoryofKollafiles>\--openstack-ip<viporfqdnofopenstack>\--rabbit-ip<serveripaddr1>--rabbit-ip<server2>--rabbit-ip<server3>\--rabbit-pass<rabbitmqopenstackuserpassword>\--sql-ip<databaseIPaddress>\--sql-password<arcususerpasswordfordatabase>\--ssh-key-path<authorizedSSHkey>Docker UtilitiesBuild Offline Installation MediaTo build your own offline install media on a USB stick for a dark-site cloud:bwdtexport-offline-media<path>Download Cloud Config TemplateTo download a template cloud configuration for use with the Ansible container:bwdtdownloadcloud-yml<path>