Update to Latest Version

This article is only for upgrade, not for new installation.

Latest version: v1.5.0 (Mar 24, 2024)

View current version

The version information is available at admin portal, or:

./janusec --version

From v0.9.10+ ~ 1.4.x

You do not need to uninstall the old version, just download the latest package and update JANUSEC like this:

#tar zxf ./janusec-1.5.x-amd64.tar.gz
#cd janusec-1.5.x-amd64
#./install.sh
#systemctl restart janusec

Notice: If you have previously enabled Dingtalk OAuth2 authentication, the following changes need to be made when upgrading to this version：

• In the global settings interface of the gateway, configure the CorpId parameter, which can be obtained from the Dingtalk development platform.
• In Dingtalk development platform, upgrade the application and release a version of it.
• Under privilege management of Dingtalk development platform, grant all users the privilege of reading the personal information address book (通讯录个人信息读权限).

From V0.9.9

First, nftables is required for CC defense from v0.9.10.

nftables is not installed for CentOS 7 by default, installation is required:

#yum -y install nftables
#systemctl enable nftables
#systemctl start nftables

nftables has been installed for CentOS 8, and as backend of firewalld, just enable firewalld ：

#systemctl enable firewalld
#systemctl start firewalld

Then, download the latest package and update JANUSEC like this:

#tar zxf ./janusec-1.5.x-amd64.tar.gz
#cd /data/janusec-1.5.x-amd64/
#./install.sh
#systemctl restart janusec

From V0.9.5~V0.9.8

Step 1:

config.json changed in V0.9.9, so backup and new config.json is required.
And then, download the latest package and update JANUSEC like this:

#cd /data/
#tar zxf ./janusec-1.5.x-amd64.tar.gz
#mv /usr/local/janusec/config.json /usr/local/janusec/config.json.old
#cp ./janusec-1.5.x-amd64/config.json.primary_bak /usr/local/janusec/config.json

Edit /usr/local/janusec/config.json, refer to Configuration File, set database information.

#vi /usr/local/janusec/config.json

Step 2:

Check nftables started.

Step 3:

Install the latest version（config.json will not be overwrote if it exists.）：

#cd /data/janusec-1.5.x-amd64/
#./install.sh
#systemctl restart janusec

From Version 0.9.4 or earlier

0.9.5 changed the service type, so before installation:

Step 1:

#systemctl stop janusec

stop the service.

Step 2:
Check nftables started.

Step 3:

Backup /usr/local/janusec/config.json or record the password in it.
Delete /usr/local/janusec/config.json , then install script will copy a new config.json .
Install latest Janusec, and check config.json to fill in the password.

If:

#systemctl restart janusec

not work, just kill it.