7/27/2019 Apace Apollo Getting Started

1/2

Getting Started Guide

InstallationOptional Windows PrerequisitesCreating a Broker Instance

Running a Broker InstanceWeb Administration

This guide will help you install, setup and run an Apollo broker and validate that the broker isoperating correctly.

Installation

1. Download the Apollo distribution that is most appropriate for your operating system.

2. Extract the distribution archive:

Unix/Linux/OS X

t ar - zxvf a ache- a ol l o- 1. 6- uni x- i st r o. t ar . z

Windows

ar - xvf a ache-a ol l o- 1. 6- wi ndows- i str o. zi

The distribution will be ex tracted into a directory called, apache- apol l o- 1. 6. The rest of thisdocument will refer to the full path to this directory as ${APOLLO_HOME}.

Optional Windows Prerequisites

If you're on Windows Vista, Server 2008, or later you should install the MS VC++ 2010Redistributable package so that Apollo can use the JNI implementation of LevelDB.

If you're running a 32 bit JVM, install: Microsoft Visual C++ 2010 RedistributablePackage (x86)If you're running a 64 bit JVM, install: Microsoft Visual C++ 2010 RedistributablePackage (x64)

Creating a Broker Instance

A broker instance is the directory containing all the configuration and runtime data, such as logsand data files, associated with a broker process. It is recommended that you donotcreate theinstance directory under ${APOLLO_HOME}. This separation is encouraged so that you can moreeasily upgrade when the next version of Apollo is released.

On Unix systems, it is a common convention to store this kind of runtime data under the / var / l i bdirectory. For example, to create an instance at '/var/lib/mybroker', run:

cd / var / l i b${APOLLO_HOME}/ bi n/ apol l o cr eat e mybroker

Apo ll o 1.6 Developers Community Download

7/27/2019 Apace Apollo Getting Started

2/2

A broker instance directory will contain the following sub directories:

bi n: holds execution scripts associated with this instance.etc: hold the instance configuration filesdata: holds the data files used for storing persistent messagesl og: holds rotating log filest mp: holds temporary files that are safe to delete between broker runs

At this point you may want to adjust the default configuration located in the etc directory.

Running a Broker Instance

Assuming you created the broker instance under / var / l i b/ mybr oker all you need to do startrunning the broker instance is execute:

/ var / l i b/ mybr oker / bi n/ apol l o- br oker run

Now that the broker is running, you can optionally run some of the included examples toverifythe

the broker is running properly.

Web Administration

Apollo provides a simple web interface to monitor the status of the broker. Once the admininterface will be accessible at:

http://127.0.0.1:61680/ or https://127.0.0.1:61681/

The default login id and password is admi n and password.