Creating a GigaSpaces Cluster in the Cloud
gsctl is a simple CLI tool for creating GigaSpaces clusters. You can create a cluster in minutes with a single command –
run java -jar gsctl.jar create.
In this topic, you will learn how to create, provision and install a GigaSpaces cluster on Amazon Web Services (AWS) and then remove it by doing the following:
- Create a GigaSpaces cluster.
- Deploy GigaSpaces services in the cluster.
- Undeploy the GigaSpaces services and tear down the cluster.
Before beginning to work with the gsctl tool, ensure that you have the following:
Java 8 or higher installed on your local workstation.
AWS account and appropriate credentials as described in the AWS Command Line Interface documentation.
To deploy a GigaSpaces cluster in AWS you need the following:
- Valid AWS account
- Credentials that include
- Configuration parameters that include a defined
- Windows only: Set the following environment variables manually:
Downloading and Running the Utility
The gsctl tool can be downloaded from a dedicated repository. You can start an interactive shell for gsctl and run commands using short notation, or you can run commands from outside the interactive shell (from the OS shell) by adding
java -jar gsctl.jar before each command.
You must run the utility from the same directory where you placed the gsctl.jar file.
To download the gsctl utility and launch the interactive shell:
Create an empty directory on your machine. In this example, the drive is C: and the directory name is gsDemo.
Download the most current version of the utility (gsctl.jar file) from the dedicated repository to the directory you created (gsDemo).
To start the interactive shell, open a command window and type the following:
java -jar gsctl.jar
java -jar C:\gsDemo\gsctl.jar
Creating a GigaSpaces Cluster
Follow the steps in the procedure to create a GigaSpaces cluster and deploy the GigaSpaces services. All of the procedures on this page describe the short notation as used from inside the interactive shell.
To create a cluster:
Verify that an
.awsfolder exists in the home directory on your local machine, and that it contains the config and credentials files. The credentials file should include your
aws_secret_access_key, and the config files should include your
Open a command window and type the following to initialize the utility and define a cluster called
initcommand creates a cluster.yaml file, which you can modify to supply your AWS resources, such as
securityGroupsvalues. If you edit any parameter in the AWS section, you must provide all the values for the section.
By default, the utility creates all the resources from the credentials and config files in the .aws folder.
aws: keyName: null vpcId: null vpcSubnetId: null securityGroup: null amiId: null userName: null servers: label: "GS Cluster [GS_CLUSTER] Server Group" groups: - type: "m4.xlarge" tags: null count: 3 clients: label: "GS Cluster [GS_CLUSTER] Client Group" groups: - type: "m4.xlarge" tags: null count: 3 gsManagers: 3 name: "GS_CLUSTER"
To deploy the cluster in the cloud, run the following command:
The cloud platform begins to create the cluster:
You can monitor the progress of the cluster in your cloud platform dashboard, for example the VPC Dashboard in AWS:
The process of creating the cluster takes only a few minutes until the nodes are up and running. You can see when the Master (server) nodes and Worker (client) nodes are running and have passed the status checks.
Deploying the GigaSpaces Services
After your cluster is up and running, you can deploy GigaSpaces services and microservices. The gsctl utility supports deploying stateful, stateless, and web services. The default service type is stateless.
The gsctl tool comes with sample feeder (stateful) and processor (stateless) services in the Services folder. You must use the default artifact repository when deploying the sample services.
For more information about the artifact repository, see the Managing the GigaSpaces Product Version topic.
To deploy the sample GigaSpaces services:
When deploying the sample services, you should first deploy the processor service . As this is a stateful service, you need to specify both the service type and service name. Type the following command to deploy a processor service called mySpace:
deploy --type=stateful mySpace data-processor.jar
Next, deploy the feeder service. As this is a stateless service, you only have to specify the service name. Type the following command to deploy a feeder service called myFeeder:
deploy --type=stateless myFeeder data-feeder.jar
Monitoring the GigaSpaces Services
After you deploy your GigaSpaces services and microservices, you can monitor them using the following built-in web interfaces:
- Ops Manager
To access the administration and monitoring tools:
Run the following command:
This returns all the services with their URLs.
Copy any of the GigaSpacesManager URLs into your browser to open Ops Manager and view the deployed GigaSpaces services.
Copy the grafana URL to your browser to open Grafana and navigate to the pre-defined dashboards:
Select the Telegraf system metrics dashboard in Grafana to view the cluster metrics:
Removing a GigaSpaces Cluster
You can delete your cluster when you no longer need it, in order to release the cloud resources. First, undeploy the GigaSpaces stateful service, and then tear down the cluster.
To remove the GigaSpaces cluster:
In the directory where you deployed the GigaSpaces services, type the following command:
The Space is undeployed from the cluster.
In the directory where you created the cluster, run the following command:
This tears down the cluster and deletes any dynamically created resources.