Skip to content

Upgrade 4.0 to 4.1#

Follow these steps to upgrade from 4.0 to 4.1.

Important

Upgrades should always be thoroughly scoped and tested on a development environment first.

  1. Take a backup of your Kong and Konga database. Use the following command to export a Database. Make sure your postgresql service is started. 

    pg_dump --dbname=postgresql://<user>:<password>@localhost:5432/konga > konga.sql
pg_dump --dbname=postgresql://<user>:<password>@localhost:5432/kong > kong.sql

    If you get Ident authentication failed for user ... problem then you need to update the file /var/lib/pgsql/10/data/pg_hba.conf. Set host .. .. .. ident to host .. .. .. md5. After this change you need to restart the service postgresql restart service.

  2. Take a backup of /opt/gluu-gateway/konga/config/local.js, /etc/kong/kong.conf and /opt/oxd-server/data/oxd_db.mv.db. Run the following command.

    cp /opt/gluu-gateway/konga/config/local.js ./
cp /opt/oxd-server/data/oxd_db.mv.db ./
cp /etc/kong/kong.conf ./

  3. Stop the Gluu Gateway service

    service gluu-gateway stop
service kong stop
service konga stop
service oxd-server stop

  4. Uninstall GG 4.0, nodejs, oxd-server and Kong.

    For Ubuntu 16 and 18 

    apt-get purge gluu-gateway kong nodejs oxd-server

    For CentOS 7 and RHEL 7 

    yum remove gluu-gateway kong nodejs oxd-server

  5. Install GG 4.1 by following details here. Don't run the setup script. Follow the next step for upgrade.

  6. Move konga.sql, kong.sql and oxd_db.mv.db file to /opt/gluu-gateway-setup/templates

    mv konga.sql kong.sql oxd_db.mv.db  /opt/gluu-gateway-setup/templates

  7. Download upgrade script from here and start installation with the following command.

    • When asked to generate client, select n and it will prompt to ask oxd_id.
    • Open a new terminal, open local.js which you have take backup in step-2. Open it and copy past the oxd_id, client_id and client_secret.
    cd /opt/gluu-gateway-setup/
python gg-upgrade-4-0-to-4-1.py

  8. The upgrade is done here. If there are any configuration missing from the config files, update manually. Please check all the services running using command netstat -ntlp.