| Apahe Stratos version 4.0.0-SNAPSHOT |
| ----------------------------- |
| |
| 14th January 2014 |
| Welcome to the Apache Stratos 4.0.0-SNAPSHOT |
| |
| |
| Important |
| ----------- |
| |
| Apache Stratos could be installed on a single node or on multiple nodes. When installing on |
| multiple nodes copy stratos_installer to each node and update configuration parameters in conf/setup.conf file accordingly. |
| |
| |
| How to Install |
| ---------------- |
| |
| 1. Install following prerequisites: |
| |
| java -jdk1.6.x |
| git |
| zip |
| mysql-server |
| |
| 2. Build Apache Stratos from source: |
| |
| git clone https://git-wip-us.apache.org/repos/asf/incubator-stratos.git |
| cd incubator-stratos |
| mvn clean install |
| |
| 3. Copy cloud controller, stratos manager, autoscaler and cli packages to a desired location (this will be identified as stratos-pack-path): |
| |
| cp incubator-stratos/products/cloud-controller/modules/distribution/target/apache-stratos-cc-<version>.zip <stratos-pack-path> |
| cp incubator-stratos/products/stratos-manager/modules/distribution/target/apache-stratos-manager-<version>.zip <stratos-pack-path> |
| cp incubator-stratos/products/autoscaler/modules/distribution/target/apache-stratos-autoscaler-<version>.zip <stratos-pack-path> |
| |
| 4. Copy cep extensions jaf file to stratos-pack-path. |
| |
| cp incubator-stratos/extensions/cep/stratos-cep-extension/target/org.apache.stratos.cep.extension-<version>.jar <stratos-pack-path> |
| |
| 5. Download WSO2 Message Broker binary distribution from http://wso2.com/products/message-broker/ and copy it to stratos-pack-path. Here you could use any preferred |
| message broker product which supports AMQP. |
| Message broker is used for communication of Stratos products,here we show how to use WSO2 MB for this. |
| |
| 6. Download WSO2 Complex Event Processor binary distribution from http://wso2.com/products/complex-event-processor/ and copy it to stratos-pack-path. |
| |
| 7. Download MySql Java connector from http://dev.mysql.com/downloads and copy the jar file to stratos-pack-path. |
| |
| 8. Download andes client jar from http://maven.wso2.org/nexus/content/groups/wso2-public/org/wso2/andes/wso2/andes-client/0.13.wso2v8/ and copy to stratos-pack-path. |
| |
| 9. Create and download keys from IaaSs and store them on a secure location. |
| |
| 10. If Apache Stratos being setup in multiple nodes open up the security rules in IaaSs for ports which are used in cloud controller, stratos manager, autoscaler, |
| WSO2 Message Broker and WSO2 Complex Event Processor as well as stratos_db_port, userstore_db_port ports (defined in ./conf/setup.conf file). |
| |
| 11. Either download pre-built cartridge images from Apache Stratos website or create your own cartridges. Please refer Apache Stratos documentation |
| for more information on creating cartridge images. For Amazon EC2, you could find pre-built PHP, MySQL and Tomcat cartridges published in Amazon EC2 |
| AMI image repository. |
| |
| 12. Update ./conf/setup.conf and configure settings. If you run the stratos in a single node and for openstack, please update the following entries in the setup.conf |
| |
| - setup_path ==> Folder path containing stratos_setup(stratos_installer) |
| - stratos_pack_path ==> Folder path containing stratos packages(all stratos packs + cep + mb) |
| - stratos_path ==> Folder which stratos will be installed (Eg: /opt ) |
| - JAVA_HOME ==> java home |
| - host_user ==> A host user account for stratos |
| - mb_ip ==> Machine ip on which mb run |
| - cep_ip ==> Machine ip on which cep run |
| - cc_ip ==> Machine ip on which cc run |
| - as_ip ==> Machine ip on which auto scalar run |
| - sm_ip ==> Machine ip on which sc run |
| - puppet_ip ==> Machine ip on which puppet master run |
| - cep_artifacts_path ==> Folder path containing cep artifacts(STRATOS_SOURCE_ROOT/extensions/cep/artifacts) |
| - andes_client_jar ==> andes client jar file name |
| - mysql_connector_jar ==> mysql connector jar file name |
| - userstore_db_hostname ==> hostname or ip where mysql is running |
| - userstore_db_schema ==> "userstore": the name of the userstore database |
| - userstore_db_port ==> "3306": the port that mysql is running |
| - userstore_db_user ==> "root": the username of the mysql |
| - userstore_db_pass ==>"mysql": the password of the mysql user |
| |
| For ec2 as IaaS |
| =============== |
| - openstack_provider_enabled ==> flase |
| - ec2_provider_enabled ==> true |
| - ec2_identity ==> "<ec2_identity>" |
| - ec2_credential ==> "<ec2_credential>" |
| - ec2_keypair_name ==> "<ec2_keypair_name>" |
| - ec2_owner_id ==> "<ec2_owner_id>" |
| - ec2_availability_zone ==> "<ec2_availability_zone>" |
| - ec2_security_groups ==> "<ec2_security_groups>" |
| |
| For openstack as IaaS |
| ===================== |
| - ec2_provider_enabled ==> false |
| - openstack_provider_enabled ==> true |
| - openstack_identity ==> "xxx:xxx" # Openstack project name:Openstack login user |
| - openstack_credential ==> "xxxxx" # Openstack login password |
| - openstack_jclouds_endpoint ==> "http://xxxxxxxxx:5000/v2.0" |
| |
| |
| 13. Run setup.sh as root to install. |
| |
| sudo ./setup.sh -p "<product-list>" |
| <product-list> could be defined as "cc sm as mb cep" or any other combination according to the deployment configuration. |
| Example: |
| sudo ./setup.sh -p "all" |
| |
| If you need to clean the setup run bellow command: |
| sudo ./clean.sh -u <mysql-username> -p <mysql-password> |
| |
| |
| --------------------------------------------------------------------------- |
| Thanks for using Apache Stratos |
| Apache Stratos Team |