From 75464e9bbad0b4253619033b66cbaa49af15211a Mon Sep 17 00:00:00 2001 From: Jason Dunsmore Date: Fri, 11 Nov 2016 15:53:54 -0600 Subject: [PATCH] Remove out-dated method for installing in Devstack The new method for installing Magnum in Devstack is in doc/source/dev/quickstart.rst Change-Id: Ib765b571dee81c5ebef9427a3af020d221f847e5 --- doc/source/dev/manual-devstack.rst | 269 ----------------------------- doc/source/dev/quickstart.rst | 3 - doc/source/index.rst | 1 - 3 files changed, 273 deletions(-) delete mode 100644 doc/source/dev/manual-devstack.rst diff --git a/doc/source/dev/manual-devstack.rst b/doc/source/dev/manual-devstack.rst deleted file mode 100644 index 7f77bda211..0000000000 --- a/doc/source/dev/manual-devstack.rst +++ /dev/null @@ -1,269 +0,0 @@ -.. _manual-install: - -================================== -Manually Adding Magnum to DevStack -================================== - -If you are getting started with magnum it is recommended you follow the -:ref:`quickstart` to get up and running with magnum. This guide covers -a more in-depth process to setup magnum with devstack. - -Magnum depends on nova, glance, heat, barbican, and neutron to create and -schedule virtual machines to simulate bare-metal. Full bare-metal support -is still under active development. - -This session has only been tested on Ubuntu 14.04 (Trusty) and Fedora 20/21. -We recommend users to select one of them if it is possible. - -Clone devstack:: - - cd ~ - git clone https://git.openstack.org/openstack-dev/devstack - -Configure devstack with the minimal settings required to enable heat -and neutron:: - - cd devstack - cat > local.conf << END - [[local|localrc]] - # Modify to your environment - FIXED_RANGE=10.0.0.0/24 - FLOATING_RANGE=192.168.1.224/27 - PUBLIC_NETWORK_GATEWAY=192.168.1.225 - PUBLIC_INTERFACE=em1 - PHYSICAL_NETWORK=public - OVS_PHYSICAL_BRIDGE=br-ex - ENABLE_TENANT_VLANS=True - TENANT_VLAN_RANGE=1000:1999 - - # Credentials - ADMIN_PASSWORD=password - DATABASE_PASSWORD=password - RABBIT_PASSWORD=password - SERVICE_PASSWORD=password - SERVICE_TOKEN=password - - enable_service rabbit - - # Ensure we are using neutron networking rather than nova networking - disable_service n-net - enable_service q-svc - enable_service q-agt - enable_service q-dhcp - enable_service q-l3 - enable_service q-meta - enable_service neutron - - # Disable LBaaS(v1) service - disable_service q-lbaas - - # Enable LBaaS(v2) services - enable_service q-lbaasv2 - enable_service octavia - enable_service o-cw - enable_service o-hk - enable_service o-hm - enable_service o-api - - # Enable heat plugin - enable_plugin heat https://git.openstack.org/openstack/heat - # Enable barbican services - enable_plugin barbican https://git.openstack.org/openstack/barbican - enable_plugin neutron-lbaas https://git.openstack.org/openstack/neutron-lbaas - enable_plugin octavia https://git.openstack.org/openstack/octavia - - VOLUME_BACKING_FILE_SIZE=20G - END - -**NOTE:** Update PUBLIC_INTERFACE and other parameters as appropriate for -your system. -**NOTE:** Enable heat plugin is necessary. - -More devstack configuration information can be found at -http://docs.openstack.org/developer/devstack/configuration.html - -More neutron configuration information can be found at -http://docs.openstack.org/developer/devstack/guides/neutron.html - -Optionally, you can enable ceilometer in devstack. If ceilometer is enabled, -magnum will periodically send metrics to ceilometer. If you need this feature, -add the following line to your `local.conf` file:: - - enable_plugin ceilometer git://git.openstack.org/openstack/ceilometer - -Create a local.sh to automatically make necessary networking changes during -the devstack deployment process. This will allow clusters spawned by magnum to -access the internet through PUBLIC_INTERFACE:: - - cat > local.sh << 'END_LOCAL_SH' - #!/bin/sh - ROUTE_TO_INTERNET=$(ip route get 8.8.8.8) - OBOUND_DEV=$(echo ${ROUTE_TO_INTERNET#*dev} | awk '{print $1}') - sudo iptables -t nat -A POSTROUTING -o $OBOUND_DEV -j MASQUERADE - END_LOCAL_SH - chmod 755 local.sh - -Run devstack:: - - ./stack.sh - -**NOTE:** If using the m-1 tag or tarball, please use the documentation -shipped with the milestone as the current master instructions are slightly -incompatible. - -Prepare your session to be able to use the various OpenStack clients including -magnum, neutron, and glance. Create a new shell, and source the devstack openrc -script:: - - source ~/devstack/openrc admin admin - -Magnum has been tested with the Fedora Atomic micro-OS and CoreOS. Magnum will -likely work with other micro-OS platforms, but each requires individual -support in the heat template. - -Store the Fedora Atomic micro-OS in glance. Download the qcow2 Atomic image -from https://fedorapeople.org/groups/magnum/fedora-atomic-latest.qcow2 and -then upload it to glance:: - - glance image-create --name fedora-atomic-latest \ - --visibility public \ - --disk-format qcow2 \ - --os-distro fedora-atomic \ - --container-format bare < fedora-atomic-latest.qcow2 - -Create a domain and domain admin for trust:: - - TRUSTEE_DOMAIN_ID=$( - openstack domain create magnum \ - --description "Owns users and projects created by magnum" \ - -f value -c id - ) - TRUSTEE_DOMAIN_ADMIN_ID=$( - openstack user create trustee_domain_admin \ - --password "password" \ - --domain=${TRUSTEE_DOMAIN_ID} \ - --or-show \ - -f value -c id - ) - openstack --os-identity-api-version 3 role add \ - --user $TRUSTEE_DOMAIN_ADMIN_ID --domain $TRUSTEE_DOMAIN_ID \ - admin - -Create a keypair for use with the ClusterTemplate:: - - test -f ~/.ssh/id_rsa.pub || ssh-keygen -t rsa -N "" -f ~/.ssh/id_rsa - nova keypair-add --pub-key ~/.ssh/id_rsa.pub testkey - -Create a database in MySQL for magnum:: - - mysql -h 127.0.0.1 -u root -ppassword mysql <`_ - Clone devstack:: # Create a root directory for devstack if needed diff --git a/doc/source/index.rst b/doc/source/index.rst index ae96cba55d..023f50b3ef 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -60,7 +60,6 @@ Developer Info :maxdepth: 1 dev/quickstart - dev/manual-devstack dev/cluster-type-definition.rst dev/kubernetes-load-balancer.rst dev/functional-test.rst