...

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.

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 consoleImage Added
• 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

...