Pre-installation checklist

Servers

Operating system

OpenSuse 15.5

Amazon Linux 2 / 2023

Fedora 33

The product is tested on OpenSuse 15.5 but will run on most modern Linux versions supporting systemd.

On Linux, Jiglu is distributed as RPMs so you will need to be able to install these. We don't currently provide Debian packages but installing Debian's rpm package will allow Jiglu to be installed.

Application server

Tomcat 8.5 / 9.0

Tomcat is our preferred web application container. Please enquire about support for other application servers.

Mail server

Sendmail

▢ Postfix

Apache James

We support both Sendmail and Postfix as MTAs, with a preference for Sendmail.

On AWS mail can be received - but not sent - using Amazon Simple Email Service.

Database

PostgreSQL 14+

▢ Oracle 12c

PostgreSQL will be suitable for most small to moderately large installations but we also support Oracle for organisations that prefer it.

Clients

Web browsers

▢ Microsoft Edge (Chromium)

▢ Google Chrome

▢ Firefox

▢ Apple Safari 9+

▢ Opera 36+

Jiglu will work with all modern browsers supporting HTML 5. In earlier browsers it will try and degrade gracefully but some features may not be available.

Mail readers

▢ Outlook

▢ Thunderbird

▢ Apple Mail

▢ GMail

▢ Hotmail

▢ Yahoo Mail

Jiglu supports all mail readers conforming to current Internet standards. HTML 5 support is necessary when a user has chosen to receive HTML messages from the system.

Integration

DNS

▢ Physical / virtual machine address (A)

▢ Jiglu webapp address (A)

Jiglu mail domain (MX)

The machine on which Jiglu runs will need a static IP address. There will need to be a domain name to access the web application, which will resolve to the server IP address. For best practice, the machine domain name and the web application domain name should not be the same.

A domain name is required for mail, either resolving to the server itself if accessible externally or to another host with an MTA that knows how to forward mail to the machine with Jiglu.

Routing

▢ Routing to physical / virtual machine

Routing may need to be changed to ensure that users can access the web application and the MTA can receive messages.

Incoming mail

▢ Routed via smart host

▢ Own mail server

Outgoing mail

▢ Routed via smart host

▢ Own distribution

The system will need to be able to receive incoming mail. The simplest way to deal with this is to have an MTA on the same machine as Jiglu. If the machine is behind a firewall, then routing will be required, either by opening up the firewall for the MTA port or forwarding on messages at another MTA that is accessible externally.

To send out mail to users, the system will need an MTA to connect to. It can either use the MTA running on the same machine or an external ‘smart host’ (an MTA that knows how to relay mail to anywhere), for which the domain name will need to be known. Credentials may be needed for this host.

LDAP

▢ LDAP server address and port

▢ User and password to connect

▢ Repository context

▢ Class holding user data

▢ Field mappings

If the system is to use an external LDAP repository (such as Microsoft Active Directory or OpenLDAP) to authenticate users then Jiglu will need to know where the LDAP repository is, who to connect to it as and where in the repository it can find the user information it needs.

To map data from the repository into the system, Jiglu will need to know the class used to represent users, and which fields can be used for username, email address, given name and family name.

Written by Stephen Hebditch. Published on .
7.0.0
What needs to be considered and set up prior to Jiglu installation.