4.1.x Working with the Mock IaaS

The Mock IaaS feature in Stratos simulates the basic features that Stratos requires from an IaaS. Thereby, providing a cost effective way of trying out Stratos. For information on Mock IaaS, see Apache Stratos Mock IaaS.

Prerequisites

• Install Maven, JDK and MySQL. See Prerequisites for compatible versions. 
• Download the Apache ActiveMQ.
• Set the environment variable MAVEN_OPTS='-Xms2048m -Xmx4096m -XX:MaxPermSize=1024m' to avoid the maven OutOfMemoryError.
export MAVEN_OPTS='-Xms2048m -Xmx4096m -XX:MaxPermSize=1024m' 

Starting Stratos on a Mock IaaS

Follow the steps below to start Stratos on a Mock IaaS:

1. Ensure that the above mentioned prerequisites have been met prior to the Apache Stratos installation.

2. Obtain the apache-stratos-<VERSION>-SNAPSHOT.zip  binary file. This can be done using any of the following methods:

   • Download the Stratos binary distribution from Apache Download Mirrors. 

   • Build the Stratos source using the following instructions:

   1. 1. Checkout the source from Apache Stratos remote repository to a folder of your choice.

         git clone https://git-wip-us.apache.org/repos/asf/stratos.git <local-folder-name>

         For example: 
         git clone https://git-wip-us.apache.org/repos/asf/stratos.git myLocalRepo

         Make sure that you have setup Git properly. For more information, go to http://git-scm.com/book/en/Getting-Started-First-Time-Git-Setup

      2. Build Stratos using Maven.

         1. Navigate to the stratos/ directory, which is within the directory that you checked out the source.

            cd <local-folder-name>/stratos/

            For example: cd myLocalRepo/stratos/
 

         2. Use Maven to build the source.
            mvn clean install

            You can use one of the following commands instead of the above Maven build command

            Command	Description
            mvn clean install -Dmaven.test.skip=true	To build source distribution, without running any of the unit tests. This will reduce the time taken to build the source distribution.
            mvn clean install -Dmaven.test.skip=true -o	To build source distribution, without running any of the unit tests, in offline mode. This can be done only if you've already built the source at least once.

3. Unzip the Stratos binary distribution (apache-stratos-<VERSION>-SNAPSHOT.zip). If you built Stratos from source, the binary distribution can be found in the <STRATOS_HOME>/products/stratos/modules/distribution/target/ directory.

   For easy access, move the Stratos binary distribution to a location of your choice.

4. Unzip the ActiveMQ distribution.

5. Navigate to the <ACTIVEMQ-HOME>/bin/ directory, which is in the unzipped ActiveMQ distribution, and run the following command to start ActiveMQ.
   ./activemq start 

6. Navigate to the <apache-stratos-<VERSION>-SNAPSHOT>/bin/ directory, which is in the unzipped Stratos distribution, and run the following command to start Stratos.
   ./stratos.sh

Accessing the management console

Once the installation is complete, the Carbon management console URL will appear.
For example:

Thereafter, you can access the Apache Stratos Console using the following URL:

https://<STRATOS-DOMAIN>:9443/console

The default username and password is as follows: admin

Stopping the servers

Follow the instructions below to stop Stratos and ActiveMQ:

1. Stop Stratos by pressing Ctrl+C in the terminal.
2. Navigate to the <ACTIVEMQ-HOME>/bin/ directory, which is in the unzipped ActiveMQ distribution, and run the following command to stop ActiveMQ.
   ./activemq stop