Upgrading Your On-premise Deployment

To upgrade your existing MangoApps deployment to the newest version available on the application update server:

  1. Log in (SSH) as root to each server in your deployment that is an application server.

  2. Back up your database with this command: /opt/mango/bin/mangodb.sh -d backup. If you have a separated DB (not running on the application server, nothing else needs to happen on the DB server.

  3. Since the MangoApps Application Upgrade Server traffic goes over VPN, you need to open the VPN connection from your deployment to the MangoApps Application Upgrade Server. You can check if it’s running by typing the following and looking for atun0connection: ifconfig If it is not running you can start it by typing: /etc/init.d/openvpn restart After restarting make sure you can see atun0connection inifconfig

  4. On each application server as root, type the following command: puppet agent --no-daemonize --verbose --onetime

  5. Allow the puppet process to complete on each application server and note any errors. Completion should look similar to this, showing the seconds required to complete the run:

  6. Follow instructions in the install notes for the version

  7. Restart Apache on the main application server by typing the following command:

    1. /etc/init.d/apache2 restart

  8. Restart Janus on each Media / Document server by typing the following commands: /var/www/mjanus/bin/janus_imps.sh stop /var/www/mjanus/bin/janus_imps.sh start

  9. Restart the email delivery service on the main application (only on one) server by typing the following command: /opt/mango/bin/deliveremails.sh restart

  10. Check running processes by running two commands:

    1. pstree -ap | moreResults should show these processes running (among others):

      • apache2 with Passenger subprocess

      • java with soffice subprocess

      • java with a process listing similar to (this is Janus): -cp../lib/mina/*:../lib/vysper_jars/vysper-core-0.7.jar:../lib/vysper_jars/vysper-websockets-0.7.jar:../lib/vysper_ja

      • memcached

      • memcachedb

      • mysqld (if MySQL is running on application server)

      • redis-server

      • ruby

      • start_workers

    2. Verify janus is running by executing "ps -ef | grep janus" Result should should a long string containing the word “janus”

Last updated