Installing Jiglu on Amazon Web Services

It is assumed that the user already has an Amazon Web Services account and is familiar with the process of launching a new EC2 server.

Launching with a Jiglu AMI

Select the Launch instance button and then go to the Community AMIs tab. Search for Jiglu and install the most recent AMI - this will be named similar to "Jiglu 10.4.0 on Amazon Linux AMI 2017.09.1 EBS/HVM" and from owner 446302093934. If you cannot locate it then place contact support at jiglu.com as we may need to copy the AMI to the region that you are using.

After choosing the instance type you can configure the instance details as you wish. For storage you have two choices. Either you can set the root volume to be a suitable size for the database or you can add a separate volume for the database. If you do the latter then you will need to format the volume and mount it then move the PostgreSQL data to it.

In the security group used for the instance you will need to allow inbound connections from anywhere to HTTP (80), HTTPS (443) and SMTP (25) and outbound connections to anywhere. You will also need SSH access to be able to carry out the post-launch tasks and any future administration.

Post-launch tasks

There are a small number of additional tasks that need to be completed after the instance has successfully launched.

Change PostgreSQL passwords

While the PostgreSQL database is not accessible externally, it is still good practice to change the default passwords. The postgres password can be found in the file password located in the ~postgres directory.

As root:

psql postgres postgres
(Enter postgres password)
\password
(Enter new postgres password twice)
\password jiglu
(Enter new jiglu password twice)
\password jigluowner
(Enter new jigluowner password twice)
\q

You will then need to change the com.jiglu.jdbc.password and com.jiglu.jdbc.ownerPassword properties in /etc/jiglu/bootstrap.properties to match the jiglu and jigluowner passwords.

Domain name

You will almost certainly want to be able to access Jiglu using a friendlier domain name than the default. See Integration for more on this.

The domain name will need to be changed for the com.jiglu.web.host and com.jiglu.mail.domain properties in /etc/jiglu/bootstrap.properties. You may also want to set the domain name correctly for Apache and Tomcat rather than relying on the default localhost shortcut.

SSL certificate

You will need to install your own SSL certificate. The key should be in /etc/pki/tls/private and the certificate in /etc/pki/tls/certs. To change the names of these files edit /etc/httpd/conf.d and alter the SSLCertificateKeyFile and SSLCertificateFile entries. You may also need to set the SSLCertificateChainFile and SSLCACertificateFile entries to use appropriate files depending on the SSL registry used.

Accessing the system

If you have configured a permanent domain name from the system then you enter that name in your browser now. If you have not done this step then you can connect using the public DNS address shown for the instance in the EC2 console, e.g. https://ec2-999-999-999-999.eu-west-2.compute.amazonaws.com/. If you have not configured your own SSL certificate then you may need to override your browser's security warning about the certificate being invalid.

For the next steps, see Accessing Jiglu for the first time.

Written by Stephen Hebditch. Published on .
6.0.0
Getting started with Jiglu on Amazon Web Services.