Get Started with Hazelcast Enterprise in VMware Tanzu

Download the product file from VMware Tanzu Network.

Go to your Ops Manager dashboard at the pre-installed VMware Tanzu Application Service environment.

Navigate to the Ops Manager Installation Dashboard and click Import a Product to upload the product file.

Click Add next to the uploaded Hazelcast IMDG Enterprise for VMware Tanzu tile in the Ops Manager Available Products view to add it to your staging area.

Click the newly added Hazelcast IMDG Enterprise for VMware Tanzu tile.

Click Assign AZs and Networks. In the AZ and Network Assignments pane, do the following:

Click First On-demand plan. In the Hazelcast on-demand plan pane, do the following:

Specify the number of Hazelcast instances for this plan. This property defines the number of Hazelcast instances to be created. It can be overridden for each service instance when creating a service instance by using instanceCount parameter. See Step 2 in the Using Hazelcast IMDG Enterprise for VMware Tanzu topic for more information.

Select a Hazelcast VM type. Choose a suitable VM type according to your data size and processing power requirements.

If you are planning on using features like Hot Restart that require a persistent disk, select a Hazelcast Disk type. Otherwise, you can leave this option empty because Hazelcast, by default, does not require a persistent disk.

Select a Management Center VM type.

If you are planning on migrating Management Center between service instances and deployments that require a persistent disk, select a Management Center VM type. Otherwise, you can leave this option empty because Management Center, by default, does not require a persistent disk.

Select the Hazelcast availability zone(s) in which to create VMs for this plan.

Click Save.

If you want to modify the additional Hazelcast IMDG Enterprise for VMware Tanzu plans, repeat the step above to configure the second and third on-demand plans.

Click Errands and ensure that both Register on-demand broker and Deregister on-demand broker are selected. These are necessary to create and destroy Hazelcast service instances. You can disable smoke-tests errand to decrease installation time.

Click Resource Config and review the IaaS resources used by the Hazelcast IMDG Enterprise for VMware Tanzu components. Do not modify these default settings.

Return to the Ops Manager Installation Dashboard and click Apply Changes to complete the installation of Hazelcast IMDG Enterprise for VMware Tanzu. Installation porcess takes 15 minutes approximately.

Login with the CLI to TAS environment:

    $ cf login -a API-URL -u USERNAME -p PASSWORD -o ORG -s SPACE --skip-ssl-validation

To check availability of Hazelcast IMDG Enterprise for VMware Tanzu, run the following command:

    $ cf marketplace
    Getting services from marketplace in org system / space system as admin...
    OK
    service         plans                            description
    hazelcast       small, medium, large    Hazelcast Service

Clone the project to get JSON file containing service-specific configuration parameters:

    $ git clone https://github.com/hazelcast-guides/vmware-tanzu.git

To create a 3 nodes Hazelcast IMDG cluster and Management Center that coonnects to it, run the following command:

    $ cf create-service hazelcast PLAN SERVICE_INSTANCE_NAME -c /path/to/project/hazelcast-mancenter.json

After the services are created, you can build sample client application that utilizes VCAP_SERVICES environment variable at project path:

    $ mvn clean install

To push application and , run following commands:

    $ cf push APP_NAME -m 2G -i 1 -p /path/to/project/target/tanzu-sample-client-app-0.1.jar --no-manifest --no-start

Now you can bind Hazelcast IMDG services to the application and start it:

    $ cf bind-service APP_NAME SERVICE_INSTANCE_NAME
    $ cf start APP_NAME

To put/get data into Hazelcast IMDG map, run following commands:

    $ export APP_ROUTE=`cf app APP_NAME | grep routes | awk '{ print $2 }'`
    $ curl -s "http://${APP_ROUTE}/put?key=1&value=1"
    $ curl -s "http://${APP_ROUTE}/get?key=1"

You can reach Management Center dashboard via http://mancenter.YOUR_APPS_DOMAIN URL. Replace YOUR_APPS_DOMAIN with the output of following command:

    $ cf domains | grep -i apps.*.cf-app.com | awk '{ print $1 }'