bf83829bc2
Reasons: - dib-run-parts was moved from DIB project to its own package called dib-utils Closes-Bug: #1371682 Change-Id: If90031ec2a5da21ab13b02b942bca61d04d7213a |
||
---|---|---|
apidocs | ||
scripts | ||
tests | ||
xsd | ||
.gitignore | ||
.gitreview | ||
README.md |
README.md
Integration dev scripts, tests and docs for Trove.
Steps to setup this environment:
Install a fresh Ubuntu 12.04 (Precise Pangolin) image ( We suggest to create a virtual machine )
Login to the machine as root
Make sure we have git installed:
# apt-get update
# apt-get install git-core -y
Add a user named ubuntu if you do not already have one:
# adduser ubuntu
# visudo
add this line to the file below the root user
ubuntu ALL=(ALL:ALL) ALL
**OR use this if you dont want to type your password to sudo a command**
ubuntu ALL=(ALL) NOPASSWD: ALL
if /dev/pts/0 does not have read/write for your user
# chmod 666 /dev/pts/0
Note that this number can change and if you can not connect to the screen session then the /dev/pts/# needs modding like above.
Login with ubuntu:
# su ubuntu
$ cd ~
Clone this repo:
$ git clone https://github.com/openstack/trove-integration.git
Go into the scripts directory:
$ cd trove-integration/scripts/
Running redstack is the core script:
Run this to get the command list with a short description of each
$ ./redstack
Install all the dependencies and then install trove via redstack.
This brings up trove (rd-api rd-tmgr) and initializes the trove database.
$ ./redstack install
Connecting to the screen session
$ screen -x stack
If that command fails with the error
Cannot open your terminal '/dev/pts/1'
If that command fails with the error chmod the corresponding /dev/pts/#
$ chmod 660 /dev/pts/1
Detach from the screen session
Allows the services to continue running in the background
ctrl+a then d
Kick start the build/test-init/build-image commands
Add mysql as a parameter to set build and add the mysql guest image
$ ./redstack kick-start mysql
Optional commands if you did not run kick-start
Initialize the test configuration and set up test users
$ ./redstack test-init
Build the image and add it to glance
$ ./redstack build-image mysql
Reset your environment
Stop all the services running in the screens and refresh the environment:
$ killall -9 screen
$ screen -wipe
$ RECLONE=yes ./redstack install
$ ./redstack kick-start mysql
or
$ RECLONE=yes ./redstack install
$ ./redstack build
$ ./redstack test-init
$ ./redstack build-image mysql
Recover after reboot
If the VM was restarted, then the process for bringing up Openstack and Trove is quite simple
$./redstack start-deps
$./redstack start
Use screen to ensure all modules have started without error
$screen -r stack
VMware Fusion 5 speed improvement
We found out that if you are running ubuntu with KVM or Qemu it can be extremely slow. We found some ways of making this better with in VMware settings. On a clean install of ubuntu 12.04 enable these options in VMware. (likey the same in other virutalizing platforms)
-
Shutdown the Ubuntu VM.
-
Go to the VM Settings -> Processors & Memory -> Advanced Options Check the "Enable hypervisor applications in this virtual machine" There is one other option that may improve your performance overall as well.
-
Go to the VM Settings -> Advanced Set the "Troubleshooting" option to "None"
-
I would suggest after setting these create a snapshot so that in cases where things break down you can revert to a clean snapshot.
-
Boot up the VM and run the
./redstack install
-
To verify that KVM is setup properly after the devstack installation you can run these commands.
ubuntu@ubuntu:~$ kvm-ok
INFO: /dev/kvm exists
KVM acceleration can be used
VMware Workstation performance improvements
In recent versions of VMWare, you can get much better performance if you enable the right virtualization options. For example in VMWare Workstation, (noticed in version 10.0.2), click on VM->Settings->Processor.
You should see a box of "Virtualization Engine" options that can be changed only when the VM is shutdown.
Make sure you check "Virtualize Intel VT-x/EPT or AMD-V/RVI" and "Virtualize CPU performance counters". Set the preferred mode to "Automatic".
Then boot the VM and ensure that the proper virtualization is enabled.
ubuntu@ubuntu:~$ kvm-ok
INFO: /dev/kvm exists
KVM acceleration can be used