Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

Once the Stratos main servers have been started, you can connect to the Stratos controller (which is the “heart” of Stratos) to create a tenant. A tenant is an organization that will use the PaaS. Inside an organization, one or N Cartridges (runtimes) can be subscribed to.

The Stratos controller runs at: https://<INSTANCE_HOSTNAME>:9445 (for example,  https://ec2-184-72-129-229.compute-1.amazonaws.com:9445). Once you are connected, login using the default admin user (admin/admin). This logs you in as the super tenant administrator.

...

Excerpt

Subscribing to a Cartridge

Info

Carbon Cartridges currently only support HTTP GIT repositories. However, you can setup your own GIT server to support GIT repositories with HTTP access. For more information, see Configuring a Git Server.  

  1. Login to the Stratos Controller  as  the tenant administrator. This is done by specifying the full admin name (for example, admin@isalive.com).

    Info

    When you log in, you will see a message stating your domain email has not been validated. You can safely ignore this in this setup.

  2. Switch to the Main tab.
  3. Click ManageCartridges and then Available Cartridges.
  4. Search for available Cartridges
  5. Click the corresponding Subscriber link.
  6. Enter an Alias for the Cartridge. 
    The alias has to be unique as it is used to identify the Cartridge instance. The alias can contain a period (.).
  7. Select the policy.
    See Auto-scaling Cartridge instances for more information.
  8. Select the repository type (such as public or private).  
  9. Add Git repository details. 
    The Git system is used behind the scenes to deploy applications.

    • If you are using the Stratos demo:
        This system is already configured with an internal Git system, so you can select the Use Internal Repository option.
    • If you are not using the Stratos demo:
      1. Enter the  external Git repository URL.  
        The URL should not contain the username and it  should be specified separately in the text boxes for the Git Repository Username and Git Repository Password.  
        For example: 
        https://user@git.server.com/8443/test.git   (Incorrect as the URL contains the username)  
        https://git.server.com/8443/test.git    (Correct as the URL doesn't contain the username) 
      2. Either a Github repository URL or a Git repository from your own Git server can be used (HTTP or HTTPS). For information on configuring your own Git server on with Gitblit, see Configuring a Git Server.
      3. Enter the  external Git repository username.
        This field is optional, if the repository type is public, otherwise it is mandatory. 
      4. Enter the  external Git repository password.
        This field is optional, if the repository type is public, otherwise it is mandatory.   
  10. Click Subscribe.
  11. Map the host name to the ELB IP, by either adding an entry in the /etc/hosts file or DNS. If this is not done you will not be able to access the Cartridge after subscribing. 

...

  1. Login to the Stratos Controller  as  the tenant administrator. This is done by specifying the full admin name (for example, admin@isalive.com).

    Info

    When you log in, you will see a message stating your domain email has not been validated. You can safely ignore this in this setup.

     

  2. Switch to the Main tab.
  3. Click ManageCartridges and then Available Cartridges.
  4. Subscribe to the Cartridge.
  5. Click Connect another Cartridge
  6. Enter an Alias for the Cartridge.
    The alias has to be unique as it is used to identify the Cartridge instance. The alias can contain a period (.).
  7. Select the policy.
    For more information, see Auto-scaling Cartridge instances.
     
  8. Add Git repository details. 
    The Git  system is used behind the scenes to deploy applications.

    • If you are using the Stratos demo:
        This system is already configured with an internal Git system, so you can select the Use Internal Repository  option.
       
    • If you are not using the Stratos demo:
      1. Enter the external Git repository URL. 
        The URL should not contain the username and it should be specified separately in the text boxes for the Git Repository Username and Git Repository Password. 
        Example: 
        https://user@git.server.com/8443/test.git (Incorrect as the URL contains the username) 
        https://git.server.com/8443/test.git  (Correct as the URL doesn't contain the username) 

        Either a Github repository URL or a Git repository from your own Git server can be used (HTTP or HTTPS). For information on configuring your own Git server on with Gitblit, see 
        Configuring a Git Server.
      2. Enter the external Git repository username.
        This field is optional, if the repository type is public, otherwise it is mandatory. 
      3. Enter the external Git repository password.
        This field is optional, i f the repository type is public, otherwise it is mandatory.  
  9. Click Test Connection.
    This step can be carried out if you wish to check whether the entered repository details are valid.

    Info

    Please note that the repository credentials can not be verified for public repositories.

  10. Select the data Cartridge to be connected to from Connect Data Cartridge.
  11. Enter an alias for the data Cartridge in Data Cartridge Alias.
  12. Click Subscribe. 
  13. Map the host name to the ELB IP, by either adding an entry in the /etc/hosts file or DNS. If this is not done you will not be able to access the Cartridge after subscribing.  
 

Mapping the host name to ELB IP

To map the host name to the ELB IP:

  1. Run the following command to retrieve  your public IP:

    Code Block
    nslookup <Instance-hostname>

     For example:

    Code Block
    nslookup ec2-184-72-129-229.compute-1.amazonaws.com


  2. Edit your hosts file (on /etc/hosts, /private/etc/hosts on Mac OS, system32/etc/drivers on Windows) and add the following entry:

    Code Block
    <public IP> <subscribed-cartridge-type>.<domain-name>

    For example:

    Code Block
    184.72.129.229 appserver.isalive.com appserver.isawso2.com

    In the above example, appserver.isalive.com is the domain mapping. Domain mapping is not compulsory, but if a mapping has been done it should be added in the host file entry.


Viewing subscribed Cartridge details

...