Updating an AMI installation

Let's say you set up an EC2 instance from our AMI when FixMyStreet was on version 1.1.2, and you now want to upgrade to version 1.2. This page should help.

(If you forked the code on GitHub and cloned it yourself, you probably want to see our main update help.)

Firstly, log in to your EC2 instance as the ubuntu user, as you did when setting up the instance. You should become the fms user and switch to the right directory:

ubuntu@ip-10-58-191-98:~$ sudo su - fms
fms@ip-10-58-191-98:~$ cd fixmystreet
fms@ip-10-58-191-98:~/fixmystreet$

To fetch new upstream code, but not yet use it, use:

fms@ip-10-58-191-98:~/fixmystreet$ git fetch origin

Then merging the new version of the upstream code into your version will bring your code up-to-date. You can do that with:

fms@ip-10-58-191-98:~/fixmystreet$ git merge v1.2

If you have made alterations to your local repository, then you will need to make sure they are all committed to your local branch and fork first, see setting up a fork for more information. You may want to try checking out your repository elsewhere and trying the merge there first, to see if it there are any problems.

After updating the code, you should run the following commands to update any needed dependencies and any schema changes to your database. It’s a good idea to take a backup of your database first.

fms@ip-10-58-191-98:~/fixmystreet$ bin/install_perl_modules
fms@ip-10-58-191-98:~/fixmystreet$ bin/update-schema --commit
fms@ip-10-58-191-98:~/fixmystreet$ bin/make-css
fms@ip-10-58-191-98:~/fixmystreet$ commonlib/bin/gettext-makemo

If you have made changes to the schema yourself, this may not work, please feel free to contact us to discuss it first.

Lastly, you should restart the Catalyst FastCGI server with:

fms@ip-10-58-191-98:~/fixmystreet$ logout
ubuntu@ip-10-58-191-98:~$ sudo /etc/init.d/fixmystreet restart