Repository: incubator-stratos Updated Branches: refs/heads/4.0.0-incubating 6c94caf44 -> 632e90cf8
Updated installer readme file to refer installation guide wiki page Project: http://git-wip-us.apache.org/repos/asf/incubator-stratos/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-stratos/commit/632e90cf Tree: http://git-wip-us.apache.org/repos/asf/incubator-stratos/tree/632e90cf Diff: http://git-wip-us.apache.org/repos/asf/incubator-stratos/diff/632e90cf Branch: refs/heads/4.0.0-incubating Commit: 632e90cf8ef460317015520535fa99a41bfe5fbf Parents: 6c94caf Author: Imesh Gunaratne <[email protected]> Authored: Fri Apr 18 15:34:04 2014 +0530 Committer: Imesh Gunaratne <[email protected]> Committed: Fri Apr 18 15:34:04 2014 +0530 ---------------------------------------------------------------------- tools/stratos-installer/README.txt | 110 ++------------------------------ 1 file changed, 4 insertions(+), 106 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-stratos/blob/632e90cf/tools/stratos-installer/README.txt ---------------------------------------------------------------------- diff --git a/tools/stratos-installer/README.txt b/tools/stratos-installer/README.txt index fac2639..aee1c4b 100644 --- a/tools/stratos-installer/README.txt +++ b/tools/stratos-installer/README.txt @@ -1,114 +1,12 @@ -Apahe Stratos version 4.0.0-incubating +Apache Stratos 4.0.0-incubating ----------------------------- -14th January 2014 -Welcome to the Apache Stratos 4.0.0-incubating - - -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. - +Apache Stratos (Incubating) is a polyglot PaaS framework, providing developers a cloud-based environment for developing, testing, and running scalable applications. 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> - +Please refer the following Stratos Wiki page for detailed installation guide: +https://cwiki.apache.org/confluence/display/STRATOS/4.0.0+Installation+Guide --------------------------------------------------------------------------- Thanks for using Apache Stratos
