Skip to end of metadata
Go to start of metadata


Overview

We are using Virgo is a completely module-based Java application server that is designed to run enterprise Java applications with a high degree of flexibility and reliability. It offers a simple yet comprehensive platform to develop, deploy, and service enterprise Java applications. 

We deploy artifacts on Virgo (which could be plans, bundle and other stuffs).

Plans are basically the artifacts that comprise an application, optionally making the application atomic to tie the artifact lifecycles together, and scoped to isolate the application from other applications.

To get better understanding of How Virgo is packaged with Ariane, we strongly recommend you to look at 4 - Ariane core overview.

The Ariane community core distribution can be downloaded from here. It's a zip file which is build by Ariane Distrib Tool from Ariane development environment by removing some specific development environment files (like the dmk.sh, syncwebdev.sh and template plan files) and copy the versioned jar coming from the compilation.

  • The Ariane development environment repositories are configured in order to use the last compiled jar from your maven repository. You can look at $VIRGO_HOME/repository/ariane-core/*ariane*.tpl files to see that we're creating the *ariane*.plan files from these templates according to your local $HOME env dir. This plan files are created at each Virgo startup. You can look at $VIRGO_HOME/bin/dmk.sh to see how. NOTE : This dmk.sh has been especially modify to feet our development needs.
  • The Ariane development environment offer the static css/html/xhtml file deployment tool which help developers to update these files without restarting Virgo. You can look at $VIRGO_HOME/bin/syncwebdev.sh

Pre-Requisites

 

System requirements

Currently Ariane is using Java 1.7 (Oracle version), so you need to install Java runtime 1.7.

Database requirements

Ariane is using two SQL databases (one for Ariane IDM module and one for Ariane Directory)

In order to install MySQL server and client you need to do something like this :

On Ubuntu :

On Fedora :

After installing MySql you need to enable and start MySql server like this:

On Ubuntu :

On Fedora :

Once the service is started you can secure the server and setup password like this :

Answer Yes to all in oder to full secure you server and then you can setup your databases and Ariane user like this:

and setup the databases :

Here we created user ariane which will be identified by password. This will be explained later in documentation.

Now we need to grant all permission to ariane user.

We need to create the tables in the databases and add some data inside them. This tables must be created from the Ariane installer SQL files :

  • For ariane_idm component :

    1. Define the ariane_idm DB 

    2. Insert the commons Ariane RBAC data (permissions, resources, ...) in ariane_idm DB 


  • For portal component :

    1. Insert Ariane Portal RBAC data into ariane_idm

  • For mapping component :

     

    1. Add some new tables in ariane_idm DB :

    2. Insert Ariane Mapping RBAC data into ariane_idm :

  • For directory component :

     

    1. Insert the Ariane Directory RBAC data into ariane_idm :

    2. Define the ariane_directory DB :

  • For injector component :

    1. Insert Ariane Injector data into ariane_idm

RabbitMQ requirement

RabbitMQ is a Message Oriente Middleware broker following the AMQP specifications. This is not a mandatory requirement.

Deploy Plan

In order to deploy bundle and plans you need change directory to :

Where $SOURCECODE will the location of parent directory where the all Ariane source code is cloned.

Now you can start the Virgo server like this:

You are all set to deploy plans in your development environment.

If setup locally then you can able to see the admin page for Virgo server by visiting following link in browser:

Else if done remotely on any machine then :

It will prompt you for credentials By default

user name : admin

password : admin

You will see the Virgo content overview like this :

Under Artifacts tab, you will find Deployed Artifacts like this :

Under Repositories tab you will find the modules which you want to deploy. Sort the Repositories till you get the plan like this.

Deployments

Described order needs to follow in order to deploy plan.

Always point mouse cursor to defined plan and you will find the deploy option in last column like this :

wait till you get one popup dialog like this :

Sequence in which plan to deploy :

  1. com.typesafe.akka
  2. org.infinispan
  3. org.hibernate
  4. org.neo4j
  5. net.echinopsii.ariane.community.messaging
  6. net.echinopsii.ariane.community.core.idm
  7. net.echinopsii.ariane.community.core.portal
  8. net.echinopsii.ariane.community.core.mapping
  9. net.echinopsii.ariane.community.core.directory
  10. net.echinopsii.ariane.community.core.injector

You can find deployed plan under Artifacts tab.

You can check the logs while deploying plan like this :

Why Password sets to "password" ?

You might wondering why we need to set our Database password to "password" by default.

Below you get answer for it :

In output of more command you will find the Mariadb base configuration which contains these two lines :

That's why we need to set password by default to "password" .

 

  • No labels