This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
joid:b_userguide [2016/02/01 21:41] Narinder Gupta created |
joid:b_userguide [2016/02/11 05:07] (current) Narinder Gupta [Access the openstack dashboard:] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | OPNFV Brahmaputra User Guide: | + | ====== OPNFV Brahmaputra User Guide: ====== |
| - | Installation Guide | + | ===== Installation Guide ===== |
| - | Post installation guide | ||
| - | User Guide: | + | ===== Post installation guide ===== |
| - | Access the openstack dashboard: | + | ===== User Guide: ===== |
| - | + | ||
| - | open a browser http://<vip>/ for Intel pod5 http://10.4.1.21/ | + | |
| - | crendtials: admin/openstack | + | |
| - | + | ||
| - | Command line: | + | |
| - | source ./cloud/admin-openrc | + | |
| - | openstack role list | + | |
| - | openstack user list | + | |
| - | + | ||
| - | glance image-list | + | |
| - | + | ||
| - | nova list | + | |
| - | + | ||
| - | keystone tenanant-list | + | |
| + | ==== OPNFV requirements: ==== | ||
| + | * Installers shall support the deployment of OpenStack with High-Availability (for those components that support it in Liberty) on 3 or more control nodes. Functest tests should be able to verify that the HA is enabled and functional. | ||
| + | * Hitless hardware upgrade: Increase size of a deployment in terms of compute nodes (add additional compute nodes) without service interruption. This requirement doesn't mandate upgrade/increasing the size of the control node cluster. | ||
| + | * Automatically populate discovered servers into install tool (reduce user-intervention to a minimum). | ||
| + | * Installers should support a common configuration file per platform/role, so that the installed OS can be customized for hardware and role. | ||
| + | * Neutron DHCP servers should be configured in HA per tenant. | ||
| + | * SDN Controller layer 3 forwarding support. | ||
| + | * Support layer 1/2 networking configuration. | ||
| + | * Support logical networks for target system. | ||
| + | * Support L3-neutron agent as an option for L3. | ||
| + | * Provide isolated compute node resources for CEPH OSD. | ||
| + | * Installers should track/control all versions of all components pulled from external sources (user should be able to identify the versions and origins of all software components deployed). | ||
| + | * Common ability to input site, topology, and server information. | ||
| + | * User-configurable parameters available via config files. | ||
| + | * Allow assignment of different roles to servers, so that hardware and software can be configured according to the role. | ||
| + | * Deployment tool to provide for automatic device discovery. | ||
| + | * Installers should configure NTP servers on the servers for clock synchronization. | ||
| + | * Installers to be agnostic to type of hard drives used. | ||
| + | * Installers should install ssh keys on servers so that key-based login can be used for administration. | ||
| + | * Ability to install with upstream artifacts. | ||
| + | * Installers should supply a script or set of scripts ("deploy.sh") | ||
| + | * Installers should support offline deployment. Jump host may have Internet access, but the installers should support offline installation on target hosts during the deployment phase (either manually or automatically). | ||
| + | ==== Access the openstack dashboard: ==== | ||
| + | Users can access the dashboard from the jumpshot directly. If you are working on jumpshot then please open a web browser on the jumpshot and start accessing the openstack dashboard. | ||
| + | http://<vip>/ for Intel pod5 http://10.4.1.21/ | ||
| + | credentials: admin / openstack | ||
| + | === Command line: === | ||
| + | |||
| + | * source ./cloud/admin-openrc | ||
| + | * openstack role list | ||
| + | * openstack user list | ||
| + | * glance image-list | ||
| + | * nova list | ||
| + | * keystone tenanant-list | ||
| + | ==== Troubleshooting: ==== | ||
| + | JOID is combination of MAAS and JUJU tools which do the OPNFV deployment on bare metal as well as on virtual machine. | ||
| + | 1. MAAS deployment | ||
| + | In case you are troubleshoot the deployment of 02-maasdeploy.sh then please look into logs during run time of any errors. Possible errors could be. | ||
| + | a) Hardware does not support the virtualization. Please enable the virtualization in BIOS and rerun | ||
| + | b) ERROR error: Failed to delete vol bootstrap.img | ||
| + | error: cannot unlink file '/var/lib/libvirt/images/bootstrap.img': Success | ||
| + | error: Failed to delete vol bootstrap.img | ||
| + | error: cannot unlink file '/var/lib/libvirt/images/bootstrap.img': Success | ||
| + | subprocess.CalledProcessError: Command 'virsh -c qemu:///system vol-delete --pool default | ||
| + | bootstrap.img' returned non-zero exit status 1 | ||
| + | solution: There could be some corruption on the images at /var/lib/libvirt/images/ please remove all | ||
| + | image file from the directory /var/lib/libvirt/images/ and reboot the server then start | ||
| + | redeplopenstackoying 02-maasdeploy.sh | ||
| + | c) timeout issue. | ||
| + | Make sure you have good internet connection and your server is not behind proxy and try it again. | ||
| + | 2. JUJU deployment | ||
| + | You may encounter issues in your lab environment. Below could be issues you may encounter | ||
| + | a) Right variable are not passed as part of deployment procedure. | ||
| + | ./deploy.sh -o liberty -s odl -t ha -l intelpod5 -f none | ||
| + | b) if you have setup maas not with 02-maasdeply.sh then you could encounter hang on ./clean.sh | ||
| + | juju status command may hang because correct MAAS API keys are not listed in envrinments.yaml | ||
| + | or environments.yaml does not exist in current working directory. | ||
| + | Solution: Please make sure you have environments.yaml file under joid/ci directory and correct | ||
| + | MAAS API key has been listed. | ||
| + | c) deployment stuck at long time and timeout: | ||
| + | use command juju status --format=tabular and make sure all services container got an ip and they are executing some code. There is no service in the error state. | ||
| + | | ||
| + | 3. Openstack deployment | ||