Table of Contents outline true
Introduction
| outline | true |
|---|
...
Hostname | CPU Model | Memory | Storage | 1GbE: NIC#, VLAN, (Connected extreme 480 switch) | 10GbE: NIC# VLAN, Network (Connected with IZ1 switch) |
|---|---|---|---|---|---|
Jump | Intel 2xE5-2699 | 64GB | 3TB (Sata) | IF0: VLAN 110 (DMZ) | IF2: VLAN 112 (Private) |
Jump server Software Requirements:
...
Hostname | CPU Model | Memory | Storage | 1GbE: NIC#, VLAN, (Connected extreme 480 switch) | 10GbE: NIC# VLAN, Network (Connected with IZ1 switch) |
|---|---|---|---|---|---|
node1 | Intel 2xE5-2699 | 64GB | 3TB (Sata) | IF0: VLAN 110 (DMZ) | IF2: VLAN 112 (Private) |
node2 | Intel 2xE5-2699 | 64GB | 3TB (Sata) | IF0: VLAN 110 (DMZ) | IF2: VLAN 112 (Private) |
node3 | Intel 2xE5-2699 | 64GB | 3TB (Sata) | IF0: VLAN 110 (DMZ) | IF2: VLAN 112 (Private) |
Compute server Software Requirements:
...
Virtual deployment is used for the dev env using metal3 virtual deployment to create VM with PXE boot. VM Ansible scripts the node inventory file in the /opt/ironic. No setting is required from the user to deploy the virtual deployment. Virtual deployment is used for dev works.
Verifying the Setup - VMs
...
Snapshot Deployment Overview
no snapshot is implemented in ICN R2
Special requirements for virtual deployment
Install Jump Host
Host server or Jump host required to install with ubuntu 18.04. This install all the VMs and install the k8s clusters.
Verifying the Setup - VMs
"make verify_all" install two VMs with name master-0 and worker-0 with 8GB RAM and 8vCPUs, And install k8s cluster on the VMs using the ICN - BPAoperator and install the ICN - BPA rest API verifier. BPA operator installs the Multi cluster KUD to bring up the kubernetes with all addons and plugins.
...
VM Verifier: Run the "make vm_verifier", it will verify the Virtual deployment
Developer Guide and Troubleshooting
Utilization of Images
Post-deployment Configuration
Debugging Failures
Reporting a Bug
...
For development uses the virtual deployment, it take up 10 mins to bring up the setup virutal BMC VMs with pxeboot.
Virtual deployment works well for the BPA operator development for metal3 installation scripts.
Utilization of Images
No images provided in ICN R2 release
Post-deployment Configuration
no Post-deployment configuration required in ICN R2 release
Debugging Failures
- For first time installation enable KVM console in the trial or lab servers using Raritan console or use Intel web bmc console
- Deprovision state will result ironic agent to sleeping before next heartbeat - It is not a error message. It Baremetal without OS and installed with ramdisk
- Deprovision in metal3 is not straight forward - Metal3 follow various stages from provisioned → deprovisioning → ready. ICN BP take care navigating the deprovisioning and removing the BMH CR in case of clean
- Manual BMH cleaning of bmh or force cleaning of bmh resource result in hang state - Use make bmh_clean to remove the bmh state.
- Logs of ironic, openstack baremetal command to see the state of the node.
- Logs of Baremetal operator gives failure related to images or images md5sum errors
- It is not possible to change the state from provision to deprovision or deprovision to provision without completing that state. All the issues are handled in ICN scripts
- Kubernetes cluster failure can be debugged by KUD pod logs
Reporting a Bug
https://jira.akraino.org/projects/ICN/issues
Uninstall Guide
Baremetal deployment
- The command make clean_all unistall all the components installed by "make install"
- It deprovision all the servers provisioned and remove them from Ironic database
- Baremetal operator is deleted followed by Ironic database and container
- Network configuration such internal dhcp server, provisioning interfces
Troubleshooting
Error Message Guide
...