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.
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
located in the ~postgres directory.
psql postgres postgres
(Enter postgres password)
(Enter new postgres password twice)
(Enter new jiglu password twice)
(Enter new jigluowner password twice)
You will then need to change the
com.jiglu.jdbc.ownerPassword properties in
/etc/jiglu/bootstrap.properties to match the jiglu and jigluowner passwords.
The domain name will need to be changed for the
com.jiglu.mail.domain properties in
properties. You may also want to set the domain name correctly for Apache and Tomcat rather than relying on the default localhost shortcut.
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
SSLCertificateFile entries. You may also need to set the
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.