OpenStack

Make sure that the mentioned prerequisites are available for the demo deployment (for more information see Prerequisites) and also that the common configurations are configured (for more information see Common IaaS Configurations).

You can use any OpenStack configured IaaS. We have tested Stratos 2.0 with Essex and Folsom which are versions of OpensStack. We recommend the SUSE Cloud since it has a production ready OpenStack IaaS. You can use a single node or multi node OpenStack environment. You can install WSO2 Stratos 2.0 servers into the same single node or on a separate node.

Install OpenStack Iaas.
Download wso2s2-openstack-1.0.0.zip.
Extract wso2s2-openstack-1.0.0.zip on your OpenStack installed server.
Follow the instructions in the README.txt file.
Install Java in your server.
Copy the JDK to any preferred location and export environment variable JAVA_HOME to point to your java run-time. We recommend that you use Java 6.0.
```
export JAVA_HOME="/opt/jdk1.6.0_24"
```
Download mysql-connector-java-5.1.17-bin.jar
Copy the jar inside wso2s2-openstack-1.0.0 If you intend to use a different MySQL connector version then make sure you update the following line in the wso2s2-openstack-1.0.0 / conf/setup.conf file.
```
export mysql_connector_jar="mysql-connector-java-5.1.24.jar" 
```
Configure MySQL to allow requests from Cartridges as follows:
- Add the following entry to the /etc/hosts file.
  <host_ip> stratos.wso2.com
- Add the following entry to the /etc/mysql/my.cnf file.
  bind-address = 0.0.0.0
- Restart MySQL using the following command:
  sudo service mysql restart

Create a public key to use with OpenStack
Do not enter any passwords while creating the public key, to ensure ease of use. Just press ENTER.

$ ssh-keygen -t rsa

You can check the created public key as follows:

$ cat ~/.ssh/id_rsa.pub

Edit wso2s2-openstack-1.0.0 / conf/setup.conf according to your environment.
When editing, you need to provide information about your OpenStack environment.

Ensure to give the following information in the wso2s2-openstack-1.0.0 / conf/setup.conf .

openstack_public_key="/.ssh/id_ras.pub"

File path of the public key location.

Make sure that the conf/setup.conf is according to your environment (specially the “General configuration” section and “OpenStack” section). You can accept the default values for most of the parameters.
The parameter descriptions are as follows:

Parameter	Description
hostip	IP of the machine where you setup Stratos2 packs
stratos2_domain	Define your own domain
agent_hostname	Hostname of the agent
bam_hostname	Hostname of the bam
cc_hostname	Hostname of Cloud Controller
s2_db_hostname	Hostname of the database
sc_hostname	Hostname of the Stratos Controller
userstore_db_hostname	Hostname of the userstore
userstore_db_schema	Schema name of the userstore
userstore_db_port	Port of userstore database
userstore_db_user	User of the userstore database
userstore_db_pass	Password of the userstore database
s2_db_hostname	Hostname of the Stratos2 foundation databse
s2_db_schema	Schema of the Stratos2 foundation databse
s2_db_port	Port of the Stratos2 foundation database
s2_db_user	User of the Stratos2 foundation databse
s2_db_pass	Password of the Stratos2 foundation databse
git_user	Username of the Git
email	email
git_hostname	Hostname of the Git
git_ip	IP of the Git server
openstack_provider_enable	Default value should be "true" when using OpenStack
openstack_identity	Openstack login username
openstack_credential	OpenStack login password
openstack_tenant	OpenStack project name
openstack_project_id	ID of the Openstack project
openstack_api_key	Defualt should be "openstack"
openstack_jclouds_endpoint	jclouds endpoint URL e.g., http://10.100.0.29:5000/
openstack_scaleup_order	Scale up order
openstack_scaledown_order	Scale down order
openstack_keypair_name	Keypair used in OpenStack
openstack_region	OpenStack region provided in the setup
openstack_instance_type_tiny	Type of instance (tiny) spawed in OpenStack
openstack_instance_type_small	Type of instance (small) spawed in OpenStack (will be used by Carbon Cartridges)
openstack_security_group	Security group name in OpenStack
php_cartridge_image_id	PHP Cartridge image ID
carbon_cartridge_image_id	Carbon Cartridge image ID
mysql_cartridge_image_id	MySQL Cartridge image ID

Run the setup.sh (given below) inside wso2s2-openstack-1.0.0 as a root user to install Stratos2 Paas with Openstack demo.
When you enable the Stratos2 demo, it will upload images of all out of the box Carbon and Non-Carbon Cartridges provided into the glance image server.
```
sudo JAVA_HOME=/opt/jdk1.6.0_24 ./setup.sh -d openstack -p"all"
```
Command Argument Description
Syntax Description
-d
The IaaS that is used.
-p
All components in Stratos 2
You can see the logs at:
```
$ tail -f /var/log/s2/s2.log
$ tail -f /var/log/s2/s2-openstack.log
```
If you want to re-do the Stratos2 setup by running the setup.sh, first you need to clean the existing setup by using clean.sh and then if you enabled Stratos2 Openstack demo clean_openstack.sh. The commands are as follows:
```
sudo ./clean.sh -a<hostname> -b<host_user> -c<Openstack mysql root user> -d<Openstack mysql password>
```
Example:
```
sudo ./clean.sh -as2demo -bwso2 -croot -dopenstack
```