Install and configure the Fogbow Rendezvous

The Fogbow Rendevouz (FR) is distributed in two forms: as source code, or as a binary package for debian-based distributions. Choose the best distribution for your system, download it and install it as follows.

Pre-installation

# If not installed previously
apt-get install maven
# If not installed previously
apt-get install openjdk-7-jdk

Install from source

To get the lastest stable version of the component, download it from our repository:

wget https://github.com/fogbow/fogbow-rendezvous/archive/master.zip

Then, decompress it:

unzip master.zip

Now, install it with Maven:

cd fogbow-rendezvous-master
mvn install -Dmaven.test.skip=true

Install from debian package

Download a stable version from our package repository and install it with dpkg:

dpkg -i fogbow-rendezvous_$version.deb

Configure

After the installation, move the file rendezvous.conf.example to rendezvous.conf and edit its contents as appropriate:

# XMPP address of your Rendezvous Component
xmpp_jid=my-rendezvous.internal.mydomain

# XMPP component password
xmpp_password=rendezvous_password

# Address of the host running the XMPP server.
xmpp_host=IP_of_external.domain

# XMPP server port (to listen for components communication)
xmpp_port=5347

# The neighbors property indicates other existent rendezvous
# which this component can exchange information about Fogbow Managers liveness.
neighbors=neighbor1@domain1.com,neighbor2@domain2.com

# The properties below are used to limit, in size, the rendezvous' responses.
# Maximum number of managers that should be returned in a whoIsAlive response.
max_whoisalive_manager_count=100
# Maximum number of managers that should be returned in a whoIsAliveSyncresponse.
max_whoisalivesync_manager_count=100
# Maximum number of neighbors that should be returned in a whoIsAliveSyncresponse.
max_whoisalivesync_neighbor_count=100

# The properties below control "iamalive" mechanism
# The period in milliseconds between successive "iamalive" messages.
iamalive_period=30000
# How many "iamalive" messages should be lost before the Fogbow Rendezvous suspects
# the Fogbow Manager is not available.
iamalive_max_message_lost=3

# The property below indicates the WhiteList pluging used by the rendevouz.
white_list_class=org.fogbowcloud.rendezvous.core.plugins.whitelist.AcceptAnyWhiteListPlugin

Remember that the xmpp_jid and xmpp_password must match the values assigned when installing the XMPP server (refer to the Install and configure XMPP section of our documentation).

After adding the FR to your XMPP server, you need to add a new entry in your DNS to resolve the FR name to the XMPP server IP address, as shown in the example below.

my-rendezvous.internal.mydomain        22      IN      A       IP_of_external.domain

Configure LOG

Rename the file log4j.properties.example to log4j.properties and edit it according your necessity.

# Root logger option
log4j.rootLogger=DEBUG, file

# Direct log messages to a log file
log4j.appender.file=org.apache.log4j.RollingFileAppender
# log path
log4j.appender.file.File=/var/log/fogbow-rendezvous/fogbow-rendezvous.log
log4j.appender.file.MaxFileSize=10MB
log4j.appender.file.MaxBackupIndex=10
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n

# Different log levels for restlet and http-client
log4j.category.org.restlet=INFO

Run

To start the FR, run the start-rendezvous script inside ./bin.

./bin/start-rendezvous