OpenStack - User contributions [en]

Tuskar/Instack

2015-02-20T09:13:09Z

Jtomasek: /* Running TuskaUI in development mode */

== Using Tuskar and Tuskar-UI with instack ==

== Installing from source ==
Follow steps in https://github.com/agroup/instack-undercloud/blob/master/README-source.md

Create ssh tunnel so you can access Tuskar UI from you machine, example:
# 192.168.122.215 is undercloud ip
# ibm-x3550m4-07.lab.eng.brq.redhat.com is lab addr
# Tuskar-UI be accessible on localhost:8045 in your browser
ssh -L 8045:192.168.122.215:80 root@ibm-x3550m4-07.lab.eng.brq.redhat.com

=== Installing, Updating and testing Overcloud from CLI ===
# after you install Undercloud, deploy Overcloud using this:
export CONTROLSCALE=1
export COMPUTESCALE=1
export BLOCKSTORAGESCALE=0
export SWIFTSTORAGESCALE=0

source deploy-overcloudrc
source tripleo-undercloud-passwords
source stackrc
source instack-undercloud/deploy-virt-overcloudrc
source instack-undercloud/instack-sourcerc
instack-deploy-overcloud --tuskar

# And run this for stack-update:
export BLOCKSTORAGESCALE=1
export SWIFTSTORAGESCALE=1
instack-update-overcloud --tuskar

# Run tests of Overcloud
instack-test-overcloud

# if you want to verify Overcloud with CLI, run this:
source stackrc
source tripleo-overcloud-passwords
OVERCLOUD_ENDPOINT=$(heat output-show overcloud KeystoneURL|sed 's/^"$.*$"$/\1/')
export OVERCLOUD_IP=$(echo $OVERCLOUD_ENDPOINT | awk -F '[/:]' '{print $4}')
export no_proxy=${no_proxy:-""}
export no_proxy=$no_proxy,$OVERCLOUD_IP

NEW_JSON=$(jq '.overcloud.password="'${OVERCLOUD_ADMIN_PASSWORD}'" | .overcloud.endpoint="'${OVERCLOUD_ENDPOINT}'" | .overcloud.endpointhost="'${OVERCLOUD_IP}'"' $NODES_JSON)

echo $NEW_JSON > $NODES_JSON
export TE_DATAFILE=$NODES_JSON
source tripleo-incubator/overcloudrc

=== Installing from UI and testing Overcloud from CLI ===
# after you deploy and initialize overcloud from UI
OVERCLOUD_ADMIN_PASSWORD=<the one from UI overview page>
export NODES_JSON=${NODES_JSON:-"instackenv.json"}

source stackrc
OVERCLOUD_ENDPOINT=$(heat output-show overcloud KeystoneURL|sed 's/^"$.*$"$/\1/')
export OVERCLOUD_IP=$(echo $OVERCLOUD_ENDPOINT | awk -F '[/:]' '{print $4}')

touch ~/.ssh/known_hosts
chmod 600 ~/.ssh/known_hosts
ssh-keygen -R $OVERCLOUD_IP

export no_proxy=${no_proxy:-""}
export no_proxy=$no_proxy,$OVERCLOUD_IP

NEW_JSON=$(jq '.overcloud.password="'${OVERCLOUD_ADMIN_PASSWORD}'" | .overcloud.endpoint="'${OVERCLOUD_ENDPOINT}'" | .overcloud.endpointhost="'${OVERCLOUD_IP}'"' $NODES_JSON)

echo $NEW_JSON > $NODES_JSON

export TE_DATAFILE=$NODES_JSON
source /home/stack/tripleo-incubator/overcloudrc

nova flavor-create m1.demo auto 512 10 1

# TODO(lsmola) are those passwords used anywhere
tripleo setup-overcloud-passwords -o tripleo-overcloud-passwords

instack-test-overcloud

=== Running TuskaUI in development mode ===
For development it's better to install Horizon and Tuskar-UI on your lab, so you don't have to reinstall it every time
you reinstall Instack.

# Install Tuskar-UI and Horizon on your lab, follow:
http://tuskar-ui.readthedocs.org/en/latest/install.html

# Set routes, rerun this every-time Undercloud IP changes
BM_NETWORK_CIDR=192.0.2.0/24
ROUTE_DEV=virbr0
SEED_IP=libvirt default network ip of instack vm (undercloud VM)
ip route replace $BM_NETWORK_CIDR dev $ROUTE_DEV via $SEED_IP

# In horizon local_settings set:
OPENSTACK_HOST="192.0.2.1"
OPENSTACK_KEYSTONE_URL = "http://%s:5000/v2.0" % OPENSTACK_HOST
OPENSTACK_KEYSTONE_DEFAULT_ROLE = "_member_"
IRONIC_DISCOVERD_URL = "http://%s:5050" % OPENSTACK_HOST
UNDERCLOUD_ADMIN_PASSWORD = "yourOS_PASSWORDfromstackrc"
DEPLOYMENT_MODE = "scale"

# Run horizon manually
tools/with_venv.sh ./manage.py runserver 0.0.0.0:8320

# Either allow the Horizon port in firewall or setup ssh tunnel
ssh -L 8330:localhost:8320 root@ibm-x3550m4-07.lab.eng.brq.redhat.com

# Go to browser on localhost:8330

=== Connecting to Undercloud from external place (e.g. your laptop) ===

# Run this on your LAB MACHINE.
# Set routes on your lab machine, rerun this every-time Undercloud IP changes
BM_NETWORK_CIDR=192.0.2.0/24
ROUTE_DEV=virbr0
SEED_IP=libvirt default network ip of instack vm (undercloud VM)
ip route replace $BM_NETWORK_CIDR dev $ROUTE_DEV via $SEED_IP

# Run all below on your LAPTOP.
# Address of your lab machine or VM that holds undercloud VM inside
export VIRT_IP=192.168.1.113
# IP that is listed in keystone endpoint-list for all your endpoints
export UNDERCLOUD_IP=192.168.122.194

# Routing IP address from keystone to localhost
iptables -t nat -A OUTPUT -d $UNDERCLOUD_IP -j DNAT --to-destination 127.0.0.1

# Create ssh tunnels
ssh stack@$VIRT_IP -L 8774:$UNDERCLOUD_IP:8774 -L 9292:$UNDERCLOUD_IP:9292 -L 8777:$UNDERCLOUD_IP:8777 -L 9696:$UNDERCLOUD_IP:9696 -L 6385:$UNDERCLOUD_IP:6385 -L 8004:$UNDERCLOUD_IP:8004 -L 5000:$UNDERCLOUD_IP:5000 -L 8585:$UNDERCLOUD_IP:8585 -L 35357:$UNDERCLOUD_IP:35357

# Test you can connect to the following locally
curl http://127.0.0.1:8774/v2/
curl http://127.0.0.1:9292/
curl http://127.0.0.1:8777/
curl http://127.0.0.1:9696/
curl http://127.0.0.1:6385/
curl http://127.0.0.1:8004/v1/
curl http://127.0.0.1:5000/v2.0
curl http://127.0.0.1:8774/v3
# You may see authentication errors for some of them. As long as they are reachable that's ok.

# try it if NAT works, e.g:
curl http://192.0.2.1:5000/

# try it with python client locally
pip install python-glanceclient
# copy your stackrc from server
source stackrc
glance image-list

Tuskar/Instack

2014-12-08T12:15:23Z

Jtomasek: /* Running TuskaUI in development mode */

Tuskar/Instack

2014-12-08T12:15:05Z

Jtomasek: /* Running TuskaUI in development mode */

Tuskar/Instack

2014-12-05T14:41:33Z

Jtomasek: /* Running TuskaUI in development mode */

Tuskar/Instack

2014-12-05T14:41:15Z

Jtomasek: /* Running TuskaUI in development mode */

Tuskar/Instack

2014-12-05T14:40:55Z

Jtomasek: /* Running TuskaUI in development mode */

Tuskar/Instack

2014-12-05T14:40:38Z

Jtomasek: /* Running TuskaUI in development mode */

Tuskar/Instack

2014-12-05T14:39:00Z

Jtomasek: /* Running TuskaUI in development mode */

Tuskar/Instack

2014-10-24T08:41:59Z

Jtomasek: /* Installing and testing Overcloud from CLI */

Tuskar/Instack

2014-10-24T08:41:38Z

Jtomasek: /* Installing and testing Overcloud from CLI */

Tuskar/Devtest

2014-02-17T16:41:48Z

Jtomasek: /* Setup devtest */

== Overview ==
Devtest is a script that creates a development environment for TripleO / Tuskar / TuskarUI development. Below you can find step-by-step instructions for setting up the environment using devtest. If you would like more information about how devtest works as well as the script itself, see the following links
* http://docs.openstack.org/developer/tripleo-incubator/index.html
* https://github.com/openstack/tripleo-incubator/blob/master/scripts/devtest.sh
However, following the steps below should lead to a complete functioning setup.

== Instructions ==

=== Setup devtest ===
All commands (unless otherwise specified) should be run as root, in a dedicated machine you will use for TripleO development. We will call this machine "the lab machine" or "the lab server". The setup has been tested with lab machines running Fedora 19.

Note: You might want to move the location of the default libvirt storage pool. The default location is /var/lib/libvirt/images. Depending on your file system / partitions setup, there might not be enough space for images at this default location. To be on the safe side, you can move it to another location which has plenty of space. Below is an example how to move the default storage pool location to /home/images. If you are sure that there is enough space at the default location, you can skip this step.

mkdir /home/images
yum install -y libvirt
service libvirtd start
virsh pool-destroy default
virsh pool-undefine default
virsh pool-define-as default dir --target /home/images
virsh pool-start default
virsh pool-autostart default
service libvirtd restart

Install git and kvm. Installing kvm at this point sets the ownership of the /dev/kvm correctly (it should be owned by the root user and kvm group). If you don't do this, devtest will fail due to incorrectly set ownership of /dev/kvm.
yum -y install git kvm

Check access rights on /dev/kvm afterwards. If group is not kvm or group doesn't have rw on this file, execute the following commands and reboot:
chgrp kvm /dev/kvm
chmod g+rw /dev/kvm

Create devtest configuration file:
cat <<'EOF' > ~/.devtestrc
export NODE_CPU=1 NODE_MEM=4096 NODE_DISK=20 NODE_ARCH=amd64
export NODE_DIST="fedora selinux-permissive"
export DIB_RELEASE=19
export UNDERCLOUD_DIB_EXTRA_ARGS=""
export OVERCLOUD_DIB_EXTRA_ARGS=""
export OVERCLOUD_COMPUTESCALE=1
export TRIPLEO_CLEANUP=1
EOF

Clone the tripleo-incubator repo and run the devtest script:
export TRIPLEO_ROOT=~/tripleo
mkdir -p $TRIPLEO_ROOT
cd $TRIPLEO_ROOT
git clone https://git.openstack.org/openstack/tripleo-incubator
$TRIPLEO_ROOT/tripleo-incubator/scripts/devtest.sh --trash-my-machine
# wait around 2+ hours
# mawagner: if openvswitch fails to start, see https://bugzilla.redhat.com/show_bug.cgi?id=1006412 (or just mkdir /var/lock/subsys)

Create more baremetals, you can use their MAC addresses to register them from the UI later, so save the MACS somewhere
source $TRIPLEO_ROOT/tripleorc
export MORE_MACS=$(create-nodes $NODE_CPU $NODE_MEM $NODE_DISK $NODE_ARCH 2 | tr '\r\n' ' ')

To list MAC's for virsh listed machines run
virsh list --all
virsh dumpxml baremetal_0 | grep 'mac address' | cut -d\' -f2

At this point, your devtest environment is configured. To proceed, you need to install Tuskar, Horizon and Tuskar-UI, since they are not installed by devtest.

=== Install Tuskar ===

mkdir -p /opt/stack && cd /opt/stack
git clone https://git.openstack.org/openstack/tuskar

Follow the instructions here to complete the install: https://github.com/openstack/tuskar/blob/master/docs/INSTALL.rst. Make sure that you create the initial data.

=== Add Horizon and Tuskar-UI ===
Install and configure Horizon and Tuskar-UI:
easy_install pip
easy_install nose
cd /opt/stack
git clone git://github.com/openstack/horizon.git
git clone git://github.com/openstack/tuskar-ui.git
cd horizon
python tools/install_venv.py
./run_tests.sh
cp ../tuskar-ui/local_settings.py.example openstack_dashboard/local/local_settings.py
tools/with_venv.sh pip install -r ../tuskar-ui/requirements.txt
tools/with_venv.sh pip install -e ../tuskar-ui/
cp ../tuskar-ui/_50_tuskar.py.example openstack_dashboard/local/enabled/_50_tuskar.py

Copy /root/stackrc from the undercloud to the lab machine, change the OS_AUTH_URL to point to the undercloud, and source it:
ssh heat-admin@192.0.2.3 "sudo -i cat /root/stackrc" > /root/stackrc
sed -i 's/localhost:5000/192.0.2.3:5000/' /root/stackrc
source /root/stackrc

Configure OPENSTACK_HOST in horizon settings to point to the undercloud machine:
sed -i 's/OPENSTACK_HOST = "127.0.0.1"/OPENSTACK_HOST = "192.0.2.3"/' /opt/stack/horizon/openstack_dashboard/local/local_settings.py

Start the server:
tools/with_venv.sh ./manage.py runserver 0.0.0.0:8111

Now you can see the UI from your browser (you can find credentials for dashboard in undercloud machine in /root/stackrc):
lab-machine:8111

If you want to develop locally, you need only to mount the remote folder containing the code, in your local file system:
yum install -y sshfs && mkdir -p ~/devtest
sshfs root@lab-machine:/opt/stack/ ~/devtest