Table of Contents
Virtual Box is required for the following the Quick Start Service Fabric evaluation. In the following walk-through VirtualBox (version 5.0.26) is used.
Also note that:
The following Quick Start Guide walks you through the process of installing the Paremus Service Fabric in a virtual machine (VM) that you have downloaded from our website. Once installed this guide shows you how to run the first example in the Hello Tutorial.
- Click the
fabric-eval-1.13.ovaicon to start the installation process.
- Import the Appliance.
- If running on OSX, before starting the VM, please disable the USB Controller.
- Click on the fabric-eval VM to start it.
- As shown, the VM will start and prompt you to start the evaluation Service Fabric.
- To start the Fabric enter `
- Once started, the Fabric startup process will inform you of the management address. In the example below this address is seen to be .
To login to the VM use the following account details:
Pointing your browser at the address shown in your console window will allow you to access the
EVAL Fabric's management services, using the Paremus Entire GUI.
As shown, the
EVAL fabric is started with four Fibres.
To scale out the Fabric further, on the command line run the command
`fabric update eval`.
As shown, three more Fibres will be discovered and assimilated into the running Fabric, providing a 7 Fibres Fabric.
Installing and Deploying
Having created the
EVAL fabric we will now import and deploy the first example in the Hello Tutorial.
- As we are using a VM, we must first set a route to the network being used by the Fabric. In the following, the
192.168.1.79address should be replaced with the management address selected on your machine.
$ sudo route add -net 172.17.0.0/16 192.168.2.16
add net 172.17.0.0: gateway 192.168.2.16
$ sudo route add -net 172.17.0.0/16 gw 192.168.2.16
(Note: addition of “gw” in command)
# Windows - administrator command prompt
C:\Windows\system32>route add 172.17.0.0/16 192.168.2.16
- In the Service Fabric's Entire management
Systemsview, paste the following URL into the
Importdialogue box https://nexus.paremus.com/content/repositories/public/com/example/hello-1/13/helloworld-system/1.0.0/helloworld-system-1.0.0.xml
- Then click
EVALService Fabric will validate the
Hellosystem description and then import and cache all of the
Hellosoftware components required to run the example.
- Under the
system :: com.example.hello-1.13.hellowworld-systemview click the icon to deploy the example.
- In this case, the example can be seen being hosted by
- Go to Entire's
Appsview to see the URL endpoint published by the example.
- Click on this URL to access the example in a new browser window.
All of the examples in the Hello Tutorial and in the Advanced Examples tutorials (Promises & Async Services and Fabric ZooKeeper Ensemble Manager) will run with this Quick Start Paremus Service Fabric in a VM evaluation.
To run Packager examples (e.g. Kafka or Nginx), and / or to distribute a Service Fabric across your own population of network connected physical or virtual machines, register for a full evaluation of the Service Fabric, and then read the associated documentation for Service Fabric Installation and Administration.