Install a Solace Message Router onto a Google Compute Engine Linux Virtual Machine

The Solace PubSub+ Software Broker (formerly known as VMR) provides enterprise-grade messaging capabilities deployable in any computing environment. The PubSub+ Software Broker provides the same rich feature set as Solace’s proven hardware appliances, with the same open protocol support, APIs and common management. The VMR can be deployed in the datacenter or natively within all popular private and public clouds.

How to Deploy a VMR

This is a 2 step process:

• Download and install the Google SDK on your computer See https://cloud.google.com/sdk/

• Clone this project, edit the gce_vmr_startup... scripts as appropriate to change passwords and run either the create-rhel-vmr-singleton.sh for a standalone VMR or create-rhel-vmr-ha-group.sh script for a full HA triplet with built-in redundancy. This will create one or three GCE compute nodes with disks for your VMRs and download, install and initialize the latest Solace PubSub+ evaluation version on those nodes.

Set up network security to allow access

Now that the VMR is instantiated, the network security firewall rule needs to be set up to allow access to both the admin application and data traffic. Under the "Networking -> VPC network -> Firewall rules" tab add a new rule to your project exposing the required ports:

tcp:80;tcp:8080;tcp:1883;tcp:8000;tcp:9000;tcp:55003;tcp:55555

For more information on the ports required for the message router see the configuration defaults . For more information on Google Cloud Platform Firewall rules see Networking and Firewalls

Gaining admin access to the VMR

For persons used to working with Solace message router console access, this is still available with the google compute engine instance. Access the web ssh terminal window by clicking the [ssh] button next to your VMR instance, then launch a SolOS cli session:

sudo docker exec -it solace /usr/sw/loads/currentload/bin/cli -A

For persons who are unfamiliar with the Solace mesage router or would prefer an administration application the SolAdmin management application is available. For more information on SolAdmin see the SolAdmin page. To get SolAdmin, visit the Solace download page and select OS version desired. Management IP will be the Public IP associated with youe GCE instance and port will be 8080 by default.

Testing data access to the VMR

To test data traffic though the newly created VMR instance, visit the Solace developer portal and and select your preferred programming langauge to send and receive messages. Under each language there is a Publish/Subscribe tutorial that will help you get started.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

See the list of contributors who participated in this project.

License

This project is licensed under the Apache License, Version 2.0. - See the LICENSE file for details.

Resources

For more information about Solace technology in general please visit these resources:

• The Solace Developer Portal website at: http://dev.solace.com
• Understanding Solace technology.
• Ask the Solace community.