|
|
| (46 intermediate revisions by 13 users not shown) |
| Line 1: |
Line 1: |
| − | = Installing StarlingX with containers: Standard Storage configuration = | + | {{Warning|header='''Warning - Deprecated'''|body='''This wiki page is out of date and now deprecated. For the current and upcoming versions, see [https://docs.starlingx.io/deploy_install_guides/index.html StarlingX Installation and Deployment guides]'''}} |
| | | | |
| − | this page is still under construction
| + | = Documentation Contribution = |
| | | | |
| − | == History ==
| + | You might consider contributing to StarlingX documentation if you find a bug or have a suggestions for improvement. |
| | + | To get started: |
| | | | |
| − | * '''January 30, 2019:''' Initial draft | + | * Please use "[https://docs.starlingx.io/contributor/index.html Contribute]" guides. |
| − | | + | * Launch a bug in [https://bugs.launchpad.net/starlingx/+bugs?field.tag=stx.docs StarlingX Launchpad] with the tag ''stx.docs''. |
| − | == Introduction ==
| |
| − | | |
| − | These instructions are for a Standard, 2 controllers, 2 computes, 2 storage (2+2+2) configuration, in VirtualBox.
| |
| − | | |
| − | Other configurations are in development.
| |
| − | | |
| − | Installing on bare metal is also possible, however the the process would have to be adapted for the specific hardware configuration.
| |
| − | | |
| − | '''Note''': These instructions are valid for a load built on '''January 30, 2019''' or later.
| |
| − | | |
| − | == Building the Software ==
| |
| − | | |
| − | Refer to these instructions on the AIO SX page [[StarlingX/Containers/Installation#Building_the_Software| Building the Software]]
| |
| − | | |
| − | == Setup the VirtualBox VM ==
| |
| − | | |
| − | Refer to these instructions on the Standard 2+2 page [[StarlingX/Containers/InstallationOnStandard#Setup_the_VirtualBox_VM| Setup the VirtualBox VM]]
| |
| − | | |
| − | Remember to setup 2 controllers, 2 computes and 2 storage nodes.
| |
| − | | |
| − | === VirtualBox Nat Networking ===
| |
| − | | |
| − | Refer to these instructions on the Standard 2+2 page [[StarlingX/Containers/InstallationOnStandard#VirtualBox_Nat_Networking| VirtualBox Nat Networking]]
| |
| − | | |
| − | == Setup Controller-0 ==
| |
| − | === Install StarlingX ===
| |
| − | Boot the VM from the ISO media. Select the following options for installation:
| |
| − | *Standard Controller Configuration | |
| − | *Graphical Console
| |
| − | *STANDARD Security Boot Profile
| |
| − | | |
| − | Log into Controller-0 as user wrsroot, with password wrsroot. The first time you log in as wrsroot, you are required to change your password. Enter the current password (wrsroot):
| |
| − | | |
| − | <pre>
| |
| − | Changing password for wrsroot.
| |
| − | (current) UNIX Password: wrsroot
| |
| − | </pre>
| |
| − | | |
| − | Enter a new password for the wrsroot account and confirm it.
| |
| − | | |
| − | === Docker Proxy Configuration ===
| |
| − | If you are using software built prior to Jan 30, 2019 refer to these instructions on the AIO SX page [[StarlingX/Containers/Installation#Docker_Proxy_Configuration| Docker Proxy Configuration]]
| |
| − | | |
| − | Docker Proxy support in config_controller was merged on Jan 30, 2019
| |
| − | | |
| − | === Run config_controller ===
| |
| − | | |
| − | <code>sudo config_controller --kubernetes</code>
| |
| − | | |
| − | Use default settings during config_controller, except for the following:
| |
| − | * External OAM floating address: 10.10.10.3
| |
| − | * External OAM address for first controller node: 10.10.10.4
| |
| − | * External OAM address for second controller node 10.10.10.5
| |
| − | * If you do not have direct access to the google DNS nameserver(s) 8.8.8.8 , 8.8.4.4 you will need to configure that when prompted. Press Enter to choose the default, or type a new entry.
| |
| − | * If you do not have direct access to the public docker registry (https://hub.docker.com/u/starlingx) and instead use a proxy for internet access, you will need to add proxy information when prompted.
| |
| − | | |
| − | The system configuration should look like this:
| |
| − | <pre>
| |
| − | System Configuration
| |
| − | --------------------
| |
| − | Time Zone: UTC
| |
| − | System mode: duplex
| |
| − | Distributed Cloud System Controller: no
| |
| − | | |
| − | PXEBoot Network Configuration
| |
| − | -----------------------------
| |
| − | Separate PXEBoot network not configured
| |
| − | PXEBoot Controller floating hostname: pxecontroller
| |
| − | | |
| − | Management Network Configuration
| |
| − | --------------------------------
| |
| − | Management interface name: enp0s8
| |
| − | Management interface: enp0s8
| |
| − | Management interface MTU: 1500
| |
| − | Management subnet: 192.168.204.0/24
| |
| − | Controller floating address: 192.168.204.2
| |
| − | Controller 0 address: 192.168.204.3
| |
| − | Controller 1 address: 192.168.204.4
| |
| − | NFS Management Address 1: 192.168.204.5
| |
| − | NFS Management Address 2: 192.168.204.6
| |
| − | Controller floating hostname: controller
| |
| − | Controller hostname prefix: controller-
| |
| − | OAM Controller floating hostname: oamcontroller
| |
| − | Dynamic IP address allocation is selected
| |
| − | Management multicast subnet: 239.1.1.0/28
| |
| − | | |
| − | Infrastructure Network Configuration
| |
| − | ------------------------------------
| |
| − | Infrastructure interface not configured
| |
| − | | |
| − | External OAM Network Configuration
| |
| − | ----------------------------------
| |
| − | External OAM interface name: enp0s3
| |
| − | External OAM interface: enp0s3
| |
| − | External OAM interface MTU: 1500
| |
| − | External OAM subnet: 10.10.10.0/24
| |
| − | External OAM gateway address: 10.10.10.1
| |
| − | External OAM floating address: 10.10.10.3
| |
| − | External OAM 0 address: 10.10.10.4
| |
| − | External OAM 1 address: 10.10.10.5
| |
| − | | |
| − | DNS Configuration
| |
| − | -----------------
| |
| − | Nameserver 1: 8.8.8.8
| |
| − | </pre>
| |
| − | | |
| − | TO DO: update this with proxy info
| |
| − | | |
| − | === Provisioning Controller-0 ===
| |
| − | | |
| − | ==== Set the ntp server ====
| |
| − | Refer to these instructions on the AIO SX page [[StarlingX/Containers/Installation#Set_the_ntp_server| Set the ntp server]]
| |
| − | | |
| − | ==== Enable Ceph Backend ====
| |
| − | Enable the ceph backend and wait for 'applying-manifests' task to complete
| |
| − | | |
| − | source /etc/platform/openrc
| |
| − | system storage-backend-add ceph --confirmed
| |
| − | | |
| − | while [ $(system storage-backend-list | awk '/ceph-store/{print $8}') != 'configured' ]; do echo 'Waiting for ceph to be configured'; sleep 5; done
| |
| − | system storage-backend-list
| |
| − | | |
| − | ==== Unlock Controller-0 ====
| |
| − | source /etc/platform/openrc
| |
| − | system host-unlock controller-0
| |
| − | | |
| − | == Install remaining hosts ==
| |
| − | | |
| − | === PXE boot hosts ===
| |
| − | Power-on, the remaining hosts, they should PXEboot from the controller. Press F-12 for network boot if they do not. Once booted from PXE, hosts should be visible with Check with 'system host-list':
| |
| − | | |
| − | <pre>
| |
| − | [wrsroot@controller-0 ~(keystone_admin)]$ system host-list
| |
| − | +----+--------------+-------------+----------------+-------------+--------------+
| |
| − | | id | hostname | personality | administrative | operational | availability |
| |
| − | +----+--------------+-------------+----------------+-------------+--------------+
| |
| − | | 1 | controller-0 | controller | unlocked | enabled | available |
| |
| − | | 2 | None | None | locked | disabled | offline |
| |
| − | | 3 | None | None | locked | disabled | offline |
| |
| − | | 4 | None | None | locked | disabled | offline |
| |
| − | | 5 | None | None | locked | disabled | offline |
| |
| − | | 6 | None | None | locked | disabled | offline |
| |
| − | +----+--------------+-------------+----------------+-------------+--------------+
| |
| − | </pre>
| |
| − | | |
| − | === Configure host personalities ===
| |
| − | | |
| − | <pre>
| |
| − | source /etc/platform/openrc
| |
| − | system host-update 2 personality=controller
| |
| − | system host-update 3 personality=worker hostname=compute-0
| |
| − | system host-update 4 personality=worker hostname=compute-1
| |
| − | system host-update 3 personality=storage hostname=storage-0
| |
| − | system host-update 4 personality=storage hostname=storage-1
| |
| − | </pre>
| |
| − | | |
| − | At this point hosts should start installing.
| |
| − | | |
| − | === Wait for hosts to become online ===
| |
| − | Once all Nodes have been installed and rebooted, on Controller-0 list the hosts:
| |
| − | | |
| − | <pre>
| |
| − | +----+--------------+-------------+----------------+-------------+--------------+
| |
| − | | id | hostname | personality | administrative | operational | availability |
| |
| − | +----+--------------+-------------+----------------+-------------+--------------+
| |
| − | | 1 | controller-0 | controller | unlocked | enabled | available |
| |
| − | | 2 | controller-1 | controller | locked | disabled | online |
| |
| − | | 3 | compute-0 | worker | locked | disabled | online |
| |
| − | | 4 | compute-1 | worker | locked | disabled | online |
| |
| − | | 5 | storage-0 | storage | locked | disabled | online |
| |
| − | | 6 | storage-1 | storage | locked | disabled | online |
| |
| − | +----+--------------+-------------+----------------+-------------+--------------+
| |
| − | </pre>
| |
| − | | |
| − | == Provisioning controller-1 ==
| |
| − | Refer to instructions on Standard page
| |
| − | | |
| − | UNDER CONSTRUCTION
| |
| − | | |
| − | == Verify the cluster endpoints ==
| |
| − | | |
| − | Refer to these instructions on the AIO SX page [[StarlingX/Containers/Installation#Verify_the_cluster_endpoints| here ]]
| |
| − | | |
| − | == Provider/tenant networking setup ==
| |
| − | | |
| − | Refer to these instructions on the AIO SX page [[StarlingX/Containers/Installation#Provider.2Ftenant_networking_setup| here ]]
| |
| − | | |
| − | == Horizon access ==
| |
| − | | |
| − | Refer to these instructions on the AIO SX page [[StarlingX/Containers/Installation#Horizon_access| here ]]
| |
| − | | |
| − | == Known Issues and Troubleshooting ==
| |
| − | | |
| − | None
| |
You might consider contributing to StarlingX documentation if you find a bug or have a suggestions for improvement.
To get started:
Warning - Deprecated
