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:

  1. 4GB of physical memory is required to be allocated to this VM. 
  2. To run the example at the end of this section you will need internet access to connect to the Paremus Nexus repository at https://nexus.paremus.com/content/repositories/public

 

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

Installing the EVAL Fabric

  • Download the Quick Start Service Fabric VM from here.

 

 

  • Click the fabric-eval-1.13.ova icon 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.

Starting the EVAL Fabric

  • As shown, the VM will start and prompt you to start the evaluation Service Fabric. 
  • To start the Fabric enter `Y`.

  • Once started, the Fabric startup process will inform you of the management address. In the example below this address is seen to be http://192.168.1.79:9105

To login to the VM use the following account details:

Username: fabric

Password: eval

 

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. 

  • A Fibre is smart OSGi based agent that runs on the host's Java VM: the host may be a physical machine, a virtual machine, or a container.
  • A Fibre may host one or more system.parts.
  • A Fibre may act as either:
    • `the container` for one or more OSGi assemblies. 
    • `the proxy / controller` for one or more container images.
    • A combination of each.

The Fibre is responsible for the creation of any required local Linux container (e.g. Docker), and then container image life-cycle management.

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 Hello

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.79 address should be replaced with the management address selected on your machine. 

# Mac
sudo route add -net 172.17.0.0/16 192.168.2.16
add net 172.17.0.0: gateway 192.168.2.16
# Linux
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

 

  • The EVAL Service Fabric will validate the Hello system description and then import and cache all of the Hello software components required to run the example.

  • Under the system :: com.example.hello-1.13.hellowworld-system view click theicon to deploy the example.

  • In this case, the example can be seen being hosted by fibre4.1.

  • Go to Entire's Apps view to see the URL endpoint published by the example.

  • Click on this URL to access the example in a new browser window.

Next Steps

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.