EventQ installation orientation

Read this orientation to get a handle on the scope of the installation and post-install process

The goal of this topic is to give you an idea for the scope of work involved in installing and configuring TeamForge EventQ. It serves as a high-level orientation with links to specifics for the express purpose of encapsulating the whole process as concisely as possible. By its nature, TeamForge EventQ touches multiple systems and therefore installation and configuration may require cross-functional involvement.

This quick-start orientation does not substitute for complete documentation. Please read all aspects of the installation documentation, including EventQ installation requirements.

Installation of server components

While a feature of TeamForge, EventQ requires the installation of new server-side components on a dedicated host.

  1. Prep host(s) for installation

    Read EventQ installation requirements for hardware and software requirements and prepare new host(s).

  2. Firewall considerations

    The installation process and subsequent functioning requires firewall access. Read EventQ installation requirements and make firewall adjustments as needed.

  3. Proxy considerations

    The EventQ service is designed to run proxied behind TeamForge's web server. The default configuration works for situations where EventQ and TeamForge are intended to run on the same machine. However, if you intend to install EventQ on a separate host, the TeamForge site-option ORC_HOSTNAME must be uncommented and changed from localhost to the desired hostname. Please read TeamForge-EventQ proxy settings for a complete list of proxy configuration options and make any needed changes in TeamForge's site-options.conf file before installation begins.

  4. Install server-side components

    Now you are ready to run the installation process itself, see EventQ installation walk-through.

TeamForge configuration

Once the server components are installed, configure TeamForge for end-user access to EventQ.

  1. Create administrative EventQ role

    Installation of TeamForge EventQ creates four new permissions in TeamForge. Create a new EventQ administrator role, or update existing roles with the "EventQ CREATE" permission, see TeamForge documentation. Add the role to desired users.

  2. Create a read-only EventQ role

    End-users without admin rights need a read-only role to see TeamForge EventQ data and features. Create a new EventQ read-only role, or update existing roles with the "EventQ READ" permission, see TeamForge documentation. Add the role to desired users.

Install adapters

Now that you have projects and users configured properly, you must make sure firewalls are configured to permit the flow of data from adapters to EventQ and install the adapters.

  1. Configure firewall rules

    In preparation for adding adapters, the next step requires that firewall rules be created to permit data from adapters to the TeamForge EventQ MQ server, see EventQ installation requirements.

  2. Install and configure adapters

    Download, install, and configure the corresponding adapter. See Adapters: Integration using TeamForge EventQ.