Skip to content

Operations

This section is for people supporting a running UnderStack. It covers three
roles, and the navigation is grouped by which one you are in today:

  • System operators supporting the deployment as a whole — Troubleshooting
    and Architecture    , OpenStack Services, Platform Services, Scripts and
    Tools    .
  • Data centre technicians working on an individual machine —
    Hardware.
  • Network operations working on network configuration —
    Networking.

If something is broken right now, start at
Troubleshooting.

Authenticating

While the User Guide explains how to configure your CLI for regular
projects, for operators most of the baremetal infrastructure lives in the infra
domain under the baremetal project. So you will need another authentication
setup. You can achieve this by adjusting OS_ environment variables or you can
add a second entry into clouds.yaml and change OS_CLOUD appropriately.

$HOME/.config/openstack/clouds.yaml
clouds:
  uc-prod-infra:
    auth_type: v3websso
    identity_provider: sso
    protocol: openid
    auth:
      auth_url: https://your.endpoint.url/v3
      project_domain_name: infra
      project_name: baremetal
  uc-prod:
    auth_type: v3websso
    identity_provider: sso
    protocol: openid
    auth:
      auth_url: https://your.endpoint.url/v3
      project_domain_name: Default
      project_name: myproject

In the above case uc-prod-infra would be the operator area while uc-prod would
be the regular project area.

Upgrading

  • Release Notes - What you have to do to move a
    deployment between versions. If you deploy from main, read the
    Unreleased page.

Platform Services

The services UnderStack runs alongside OpenStack. Full list in the navigation;
these are the ones people look for first: