Update.md

Upgrading pyha

These upgrade instructions are written for Ubuntu, and for the remote Oracle database server. The instructions require that all user-specific (non-sudo) commands be executed by the user created for the system. For example user pyha and group pyha.

The most significant changes that require upgrade commands are:

• Database changes
• Changes to variables NOT defined as environment variables
• New python library to install (schedule)
• Translation changes
• Changes to static content

NOTE: Database updates may cause anomalies if users are able to use the service during the update.

0 - Start

In the terminal, go to the root directory of the Pyha git project.

Download the latest version from git:

git pull

1 - Automated updating

Run in the terminal:

bash updateserver.sh

Restart the service.

If step 1 was successful until the end, you're done.

2 - Manual update

Examine the commands inside updateserver.sh.

Open the python virtual environment:

source env/bin/activate

Set the environment variables in the virtual environment. Run the following commands:

pip install -r Requirements.txt (Python libraries)

and / or

pip3 install -r Requirements.txt (Python libraries)

rm -r project/static (static network elements)

python project/manage.py collectstatic (static network elements)

python project/manage.py makemigrations (Database Changes)

python project/manage.py migrate (Database Changes)

python project/manage.py createcachetable (Database changes)

python project/manage.py makemessages -a (Language changes)

python project/manage.py compilemessages (Language changes)

Restart the service.