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.
- For Jiglu, the domain name will need to be changed for the
properties. After making these changes run
systemctl restart jiglu.
- For Tomcat, you may want to set the domain name correctly for the
<Host>directive in the
xmlconfiguration file. After making these changes run
systemctl restart tomcat. See Tomcat installation for more details.
- For Apache, you will want to set the host name correctly for the
RedirectMatchdirective in the
/etc/httpd/conf.d/redirect.confconfiguration file. You may also want to change the
ServerAdminvalues in this and the
conffiles. After making these changes run
systemctl restart httpd. See Configuring Apache for more details.
- For sendmail, edit
/etc/mail/mailertableand change example.domain to the new domain name. Afterwards you should run
/etc/maildirectory to update the database files. You do not need to restart sendmail after these changes. See Sendmail configuration for more details.
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/ssl.conf 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 can 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.