Once you have Launched, Initialized, Set up and configured the WME, it is time for the developers to log in and build apps. For this, you need to add developer and deployment infrastructure capacity by adding instances.
In this document, we will explain how to add/increase the developer and deployment capacity of your WME setup.By default, WME installation allows for limited capacity for app development in WaveMaker Studio and app deployments onto WaveMaker Cloud. You can increase this capacity by adding Studio and Cloud instances thus scaling your WME.
In this document, when we say App Deployment we are referring to deployment to WaveMaker Cloud.
Increasing Development & Deployment Capacity
Adding an instance to either Studio or Cloud aids in the scalability of the VM in terms of application development and deployment, respectively. Each added Studio and Cloud instance would allow for a specific number of app developments and app deployments. These numbers will vary based on the WME version, refer to the table below for the exact numbers.
|WME Version||Developer logins per 16GB WaveMaker Studio Instance||App Deployments per 16GB WaveMaker Cloud Instance|
The actual app development and deployment support are further determined by your license terms. This means that, even if your infrastructure has the capacity, the apps that can be developed and deployed is restricted by your license terms. Similarly, even though your license terms allow, the apps that can be developed and deployed are limited by the infrastructure capacity.
To add instances, you must first launch an additional machines (VM/EC2 instances) by following steps mentioned Launching Instances in page.
Increasing Developer Capacity Adding Developer Workspace instances increases Development Capacity and allows more developers to use Studio subject to license.
- Keep IP, Port, UserName, Password(or Key) for ssh access of the instance.
- Open Launchpad and from the Developer Workspace section, you can add instances for app development or Studio.
- Click Capacity on the Developer Workspace page.
- To add new instances, click Add Instance.
- Enter the Instance Name and IP Address of the new Instance (Note: The IP address should be the IP address of the external instance launched using the WME External Instance Image and NOT that of the WME Platform mechine).
- The SSH Port is selected as 22 by default.
- Enter the credentials in the Authentication Details section (credentials will be shared with you by the WaveMaker team).
- Click Test to verify the authentication details.
- Click Add Instance. Your instance is now added.
Once the instance is added, it will be in CONFIGURING state and the instance will be setup in the background. The instance will be ready for use, when the state changes to STARTED. Increasing Deployment Capacity Release Management feature helps ease the app life-cycle process. You can use this feature through the Apps Portal to add deployment environments to your projects and use them for a phased release of the app from QA -> Stage -> Live. To be able to push the code from one phase to another, your WME needs to be capable of handling the deployments.
There are three deployment phases provided by WME – QA, Stage and Live.
By default, QA Phase comes with an in-built capacity to deploy 2-3 apps to QA phase, depending upon the VM size. Stage and Live Deployment Phases do not come with any such in-built capacity, you need to add cloud instances else configuration of the phases for any project from Apps Portal will fail. Cloud Instances for all three phases can be viewed/added from the Capacity tab of the App Deployments section in Launchpad. Adding Deployment instances increases Deployment capacity and allows more apps to be deployed, subject to license. Every deployed app is allocated 768MB of memory and is deployed into a separate container within the instance. Thus every 3 GB of memory provides capacity for 2 additional apps to be deployed. For example, adding a 16GB instance will support up to 22 deployed apps (after allowing approximately 3GB for the OS on the instance).
Cloud Instances for all three phases can be added to increase Deployment capacity. We will illustrate the steps in adding instances to Stage Phase. The same can be followed for the QA & Live Deployment Phases.
Click Add Instance. The first time you click Add Instance for a phase, you will be prompted to enter the Base URL if it doesn’t exist already. This URL will be used to access the Studio apps deployed to the phase. Each deployment phase requires a separate Base URL. This URL will be used to access the Studio apps deployed to the phase, this cannot be changed later. Corresponding DNS entries need to be added to your DNS server for this Base URL to be resolved to the WaveMaker Studio IP.
Enter the Instance Name and IP Address of the new Instance (Note: The IP address should be the IP address of the external instance launched using the WME External Instance Image and NOT that of the WME Platform Instance)
- The SSH Port is selected as 22 by default
- Enter the credentials in the Authentication Details section (credentials will be provided by the WaveMaker team).
- Click Test to verify the authentication details.
Click Add Instance. Your instance is now added.
Once the instance is added, it will be in CONFIGURING state and the instance will be setup in the background. The instance will be ready for use, when the state changes to STARTED. Follow the same steps for setting up the other Phases. Refer here to learn more on how to use the Release Management feature.