Skip to content

Latest commit

 

History

History
222 lines (164 loc) · 6.47 KB

INSTALL.md

File metadata and controls

222 lines (164 loc) · 6.47 KB
Raw

rpc-maas Install docs

Overview

RedHat OSP16, OSA changes for python3 are made into this branch.

Checkout the python2 branch for all release below OSP16 or OpenStack Ussuri:

  • Python3 support
  • RHEL8 system dependencies
  • Newer rally version
  • OSP16 inventory layout changes
  • OSA Ussuri and later changes

MTC is replaced with a shell script that sets up /root/ansible_venv used for the installation. Apart from the removal of MTC the internal documentation can still be used for everything else.

Download rpc-maas

git clone https://github.com/rcbops/rpc-maas /opt/rpc-maas
cd /opt/rpc-maas/

Setting up the installer venv

Ran as root on the director vm.

cd /opt/rpc-maas/

scripts/prepare.sh

Creating rackspace monitoring entities and agent tokens.

According to the docs the rackspace-monitoring-agent installation and entity creation is handled by the Rackspace cloud engineers. It doesn't cover this in detail, so I'm assuiming our deployment guys have the steps down for that. Before continuing on the following must be completed.

  • Entity and agent token creation.
  • Installation of the rackspace-monitoring-agent. (redhat 8 packages are available)
  • Configuration of the rackspace-monitoring-agent with the entity and agent token.

See the docs for details on a decoupled environment for more details.

Generating an auth-token

This may already be obtained from pitchfork or whatever the Rackspace cloud enginners used to set up the entities. If you have a pubcloud username and api key, you can use the following gating test script to pull the auth token. The values for the url and auth token can be found in /root/maas-vars.rc after.

/root/ansible_venv/bin/python3 tests/maasutils.py --username <pubcloud_username> --api-key <pubcloud_api_key> get_token_url

Credentials file written to "/root/maas-vars.rc"

Creating the rpc-maas config file

RedHat OSP

This is the primary config file used for the rpc-maas install. It will vary depending on the environment. Follow the docs to complete the config.

vi /home/stack/user_maas_variables.yml

OpenStack Ansible (OSA)

OSA typically deploys skeleton configuration at one of the following locations:

  • /etc/openstack_deploy/user_local_variables.yml
  • /etc/openstack_deploy/user_maas_overrides.yml
  • /etc/openstack_deploy/user_maas_variables_overrides.yml

Add or update existing keys in the first file found, of the above mentioned list.

Do not edit any file named with variables_defaults.yml or user_global_xxx.yml

Minimum MAAS configuration

  • Example:
# MaaS v2 overrides
maas_api_url: "https://monitoring.api.rackspacecloud.com/v1.0/hybrid:<tenant id>"
maas_auth_token: "<taken from the /root/maas-vars.rc if using the test script>"

# The entityLabel should based on the 'maas_fqdn_extension', as follows:
# entityLabel == 'controller1.cloud01.example.com
# Refer to the naming convention documentation section for additional details
#
maas_fqdn_extension: ".cloud01.example.com"

# Define a Unique Environment ID
# If multiple clouds exist on an account, each should have a different value
# This is also used to generate objects for private pollers if used.
#
maas_env_identifier: "cloud01"

# Enable this with  to install and configure private
# pollers for ping and lb checks.
# - 'maas_env_identifier' is also required for the private poller zone object
#maas_private_monitoring_enabled: true

# Identify data center requirements for PNM and hardware monitoring
#  true = Rackspace DC (RDC) or OpenStack Everywhere deployments
# false = Customer DC (CDC)
#
maas_raxdc: true

# Release-specific exclusions are now handled dynamically. These
# overrides will likely remain empty. These are included for
# compatibility to remove any remnant host_vars that may have
# existed in the inventory.
maas_excluded_checks: []
maas_excluded_alarms: []

RedHat OSP additionally requires passwords to be set in order for MAAS to login into rabbitmq and swift (when present):

maas_rabbitmq_password: "<some random pass>"
maas_swift_accesscheck_password: "<some random pass>"

Run the install

OpenStack Ansible (OSA)

cd /opt/rpc-maas
scripts/prepare.sh

# When present add the Ceph inventory to update the maas checks on
# the ceph nodes
export ANSIBLE_INVENTORY="$ANSIBLE_INVENTORY,/tmp/inventory-ceph.ini"

scripts/maas-ansible playbooks/maas-verify.yml -f 75

RedHat OSP

cd /opt/rpc-maas
scripts/prepare.sh

scripts/maas-ansible -i /opt/rpc-maas/inventory/rpcr_dynamic_inventory.py \
                     -e @/home/stack/user_maas_variables.yml \
                     -f 75 playbooks/site.yml

Verify the install

OpenStack Ansible (OSA)

cd /opt/rpc-maas

# When present add the Ceph inventory to update the maas checks on
# the ceph nodes
export ANSIBLE_INVENTORY="$ANSIBLE_INVENTORY,/tmp/inventory-ceph.ini"

scripts/maas-ansible playbooks/maas-verify.yml -f 75

RedHat OSP

cd /opt/rpc-maas

scripts/maas-ansible -i /opt/rpc-maas/inventory/rpcr_dynamic_inventory.py \
                     -e @/home/stack/user_maas_variables.yml \
                     -f 75 playbooks/maas-verify.yml

Rally performance checks(OSP only, if required by customer)

  • Update the config to enable rally
vi /home/stack/user_maas_variables.yml

...
maas_rally_enabled: true
maas_rally_users_password: "<some random pass>"
maas_rally_galera_password: "<some random pass>"
maas_rally_check_overrides:
  cinder:
    enabled: false
  glance:
    enabled: true
  keystone:
    enabled: true
  neutron_ports:
    enabled: true
  neutron_secgroups:
    enabled: true
  nova:
    enabled: false
  nova_cinder:
    enabled: false
  swift:
    enabled: true
    extra_user_roles:
      - "swiftoperator"
  • Run the rally install
cd /opt/rpc-maas
. /home/stack/overcloudrc

scripts/maas-ansible -i /opt/rpc-maas/inventory/rpcr_dynamic_inventory.py \
                     -e @/home/stack/user_maas_variables.yml  \
                     -e "keystone_auth_admin_password=${OS_PASSWORD}" \
                     -f 75 playbooks/maas-openstack-rally.yml