Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languagebash
./install-and-update.sh myrelease.zip

...


Warning

Caution: It is important to always run the installer with the rights of your webserver.

So in a typical Ubuntu setup a typical update process could look like the following code snippet:


Code Block
languagebash
sudo -u www-data ./install-and-update.sh --maintenance 14:00 "Reason for maintenance: Translate5 Update"
wget https://downloads.translate5.net/preconfigured/00000000000000000000000/translate5-x.x.x-your-company.zip  #this path is just an example, you get the right path from translate5s development team, if you are not using the public release package

If you run the update commands erroneously as root, ensure that you run "chown -R www-data:www-data . " afterwards, so that all files belong again to the webserver user.

Now wait until the time for maintenance you did set is reached and then call the following (omit the path to the zip, if you use the public update package - it will be fetched automatically from the web then)

Code Block
languagebash
sudo -u www-data ./install-and-update.sh /home/ubuntu/translate5-x.x.x-your-company.zip
sudo -u www-data ./install-and-update.sh --maintenance off


Called with the following parameters

The script does some maintenance tasks as listed below:

ArgumentAction
--helpShows the latest usage information, basically the same information as on this page.
--check

Shows some status information about the current installation, to decide if maintenance mode is needed or not.

For example how many users are currently logged in.

--maintenanceShows maintance mode status
--maintenance TIMESet the start of maintenance to TODAY TIME, TIME must be in format 13:47
--maintenance TIME "MESSAGE WITH QUOTES"Same as above, but sets additionally a freetext message shown to the user. The quotes surround the message are important.
--maintenance offDisables maintenance, must be used after maintenance since there is no automatic maintenance stop functionality.

--announceMaintenance TIME "MESSAGE WITH QUOTES"


Sends an email to specific users (by default the admin users) to announce the maintence mode at the given TIME with the additional MESSAGE.

DOES NOT SET THE MAINTENANCE MODE SO FAR! Just sends the email.

The group(s) of receivers can be set in the configuration.