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:
- 4GB of physical memory is required to be allocated to this VM.
- 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.
- Download the Quick Start Service Fabric VM from here.
- 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.
- 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
- 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
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.
Setting Gateway to VM
- 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.