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: |
...
First, we highly recommend you change the default password for the administrator. You can do this by:
- Login to Log into the Stratos Controller.
- Switch to the Configure tab.
- Choose Users and Roles
- Select Users
- Click on Change Password next to admin and set a new password.
- Log out and Log in again.
Spawning an instance of a pre-configured Cartridge
- Login to Log into the Stratos Controller.
Log out of the Stratos Controller.
Log in to the Stratos Controller using the tenant credentials.
Search for pre-configured Cartridges.
Select a single tenant Cartridge, if you wish to spawn a single tenant instance of a Cartridge; otherwise select a multi-tenant Cartridge to spawn a multi-tenant Cartridge instance.The following actions can be carried out:
Make changes in the Git repository code and synchronize it with the Cartridge.
Access the application via the Access URL seen on the Subscribed Cartridges page.
...
- Create a custom Cartridge.
- Login to Log into the Stratos Controller.
Log out of the Stratos Controller.
Log in to the Stratos Controller using the tenant credentials.
Search for the created Cartridge.
Your Cartridge will be listed in the respective Cartridge type list, based on the type of Cartridge (single tenant/multi-tenant) you created.The following actions can be carried out:
Make changes in the Git repository code and synchronize it with the Cartridge.
Access the application via the Access URL seen on the Subscribed Cartridges page.
Excerpt | ||
---|---|---|
Registering a tenant
|
...
Excerpt | ||
---|---|---|
Searching for available Cartridges
|
...
Excerpt | ||||
---|---|---|---|---|
Subscribing to a Cartridge
|
...
Info |
---|
The user needs to only enter the alias when subscribing to data Cartridges. |
Login to Log into 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.
- Switch to the Main tab.
- Click Manage, Cartridges and then Available Cartridges.
- Search for available Cartridges.
- Subscribe to the Cartridge.
- Click Connect another Cartridge
- 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 (.). - Select the policy.
For more information, see Auto-scaling Cartridge instances. - 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:
- 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. - Enter the external Git repository username.
This field is optional, if the repository type is public, otherwise it is mandatory. - Enter the external Git repository password.
This field is optional, i f the repository type is public, otherwise it is mandatory.
- Enter the external Git repository URL.
- If you are using the Stratos demo:
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.
- Select the data Cartridge to be connected to from Connect Data Cartridge.
- Enter an alias for the data Cartridge in Data Cartridge Alias.
- Click Subscribe.
- 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:
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
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
Login to Log into 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.
- Switch to the Main tab.
- Under Subscribed Cartridges, click List Cartridges.
- Click on the Cartridge type.
- Click Multi-Tenant Cartridges to search for subscribed Multi-Tenant Cartridges.
For more information, see Multi-Tenant Cartridges.
- Click Single-Tenant Cartridges to search for subscribed Single-Tenant Cartridges.
For more information, see Single-Tenant Cartridges.
- Click Multi-Tenant Cartridges to search for subscribed Multi-Tenant Cartridges.
- Enter the name or the alias of the Cartridge.
- Click the Search icon.
The tenant user will be able to see the details of the Cartridge that he or she has subscribed to on the subscribed Cartridges page. The information available on the subscribed Cartridges are as follows:
...
Unsubscribing from a Cartridge
Login to Log into the Stratos Controller as 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.
- Switch to the Main menu tab.
- Under Subscribed Cartridges, click List Cartridges.
- Enter the name or the alias of the Cartridge.
- Click the Search icon.
- Click the corresponding Unsubscribe button.
The user will be prompted to confirm the unsubscribe action. - Click Yes.
...
Adding domain mapping to subscribed Cartridges
Login to Log into 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.
- Switch to the Main menu tab.
- Under Subscribed Cartridges, click List Cartridges.
- Enter the name or the alias of the Cartridge.
- Click the Search icon.
- Click the corresponding Map Domain button.
- Enter a domain.
- Click Submit.
...
The tenant will be able to carryout the following steps to manually synchronize the GIT repository contents with the Cartridge. This is useful if the user has not used a hook in GIT repository.
Login to Log into 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.
- Switch to the Main menutab.
- Under Subscribed Cartridges, click List Cartridges.
- Enter the name or the alias of the Cartridge.
- Click the Search icon.
The tenant user will be able to see the details of the Cartridge that he or she has subscribed to on the subscribed Cartridges page. - Click the Synchronize link.
A confirmation message will appear after the synchronization has been initiated.
Viewing more information on subscribed Cartridges
Login to Log into 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.
Switch to the Main menu tab.
- Under Subscribed Cartridges, click List Cartridges.
- Enter the name or the alias of the Cartridge.
- Click the Search icon.
- Click on the corresponding alias name of the Cartridge.
More information will appear in a pop-up window.
...
The Stratos Controller in EC2 can be used to view the Cartridge instance’s logs. The Cartridge instance’s logs can be easily browsed as EC2 is configured for logging by default.
Login to Log into 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.
- Switch to the Monitor tab.
- Click System Logs.
- All the logs of the Stratos Controller will appear.
Viewing a specific monitoring log of the Cartridge instances in EC2
Login to Log into 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.
- Switch to the Monitor tab.
- Click System Logs.
- Click Show advance Search.
The Cartridge alias list will appear. - Select a Cartridge alias based on a preferred instance.
The logs for the specific instance will appear.