WebADM Upgrade Guide
  Download PDF

1. Introduction

This document provides the necessary information for upgrading servers running WebADM v1.5.x to WebADM v1.7.x. WebADM v1.7 is a major upgrade of RCDevs WebADM.

The reader should notice that this document is not a guide for installing WebADM or its applications (Web Services and WebApps). Specific application guides are available through the RCDevs Online Documentation. WebADM usage manual is not covered by this guide and is documented in the RCDevs WebADM Administrator Guide available through the RCDevs’ online documentation website. In this guide, we will consider a common installation scenario where WebADM is running in cluster mode with two active servers.

2. Backup Your Server

Before upgrading, please back up your WebADM configurations on any WebADM server. Therefore, please follow this guide Backup & Restore, that covers backup and restore recommendations for a typical RCDevs solution deployment including WebADM, OpenOTP with Radius Bridge and RCDevs Directory Server.

3. Install the Upgrade Package

You will need to perform the following instructions on all the servers of your cluster.

3.1 Upgrade WebADM through RCDevs Repository

To upgrade RCDevs packages with the RCDevs repository, packages should be installed first through the repository. To install RCDevs repository and install packages through the repo, please follow the RCDevs Repository documentation.

To upgrade packages through the repository:

3.1.1 RHEL/CentOS

[root@localhost tmp]# yum update 

3.1.2 Debian/Ubuntu

[root@localhost tmp]# apt-get update 

3.2 Upgrade WebADM through the Shell Script

  • Download the WebADM v1.7.x all-in-one package.

  • Copy the package on the servers with WinSCP or another SCP tool.

  • Connect the servers via SSH or Putty.

  • Uncompress the package with:

gunzip webadm_all_in_one-1.7.x.x64.sh.gz

Note

Please uncompress the GZ archive once copied on the Linux server and not under Windows!

  • Run the upgrade tool with the commands:
[root@centos7 tmp]# bash webadm_all_in_one-1.7.0-x64.sh 
WebADM v1.7.0 Self Installer
Copyright (c) 2010-2019 RCDevs SA All rights reserved.

A WebADM installation is already present in '/opt/webadm'.
Remove(R) or upgrade(U) or quit(Q)? U
Verifying package update... Ok
Are you sure you want to upgrade the WebADM installation in '/opt/webadm' (y/n)? y
Stopping WebADM HTTP server... Ok
Stopping WebADM PKI server... Ok
Extracting files, please wait... Ok
Removing temporary files... Ok
Executing upgrade script for WebADM version 1.5.8
> Adjusting WebADM configuration file... Ok
Executing upgrade script for WebADM version 1.5.8-1
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
Executing upgrade script for WebADM version 1.5.9
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
Executing upgrade script for WebADM version 1.5.10
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
Executing upgrade script for WebADM version 1.5.11-1
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
Executing upgrade script for WebADM version 1.6.0
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM webadm.conf file... Ok
Executing upgrade script for WebADM version 1.6.5-1
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
Executing upgrade script for WebADM version 1.6.5-2
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
Executing upgrade script for WebADM version 1.6.6
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM configuration file... Ok
Executing upgrade script for WebADM version 1.6.6-4
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
Executing upgrade script for WebADM version 1.6.8
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Updating systemd service file... Ok
Executing upgrade script for WebADM version 1.6.8-2
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Updating systemd service file... Ok
Executing upgrade script for WebADM version 1.6.8-3
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Updating systemd service file... Ok
> Adjusting Rsignd configuration file... Ok
Executing upgrade script for WebADM version 1.7.0
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM webadm.conf file... Ok
> Adjusting WebADM configuration file... Ok
> Adjusting WebADM configuration file... Ok
> Updating systemd service file... Ok
> Adjusting Rsignd configuration file... Ok
> Adjusting WebADM configuration file... Ok
Resetting file permissions... Ok
WebADM has been successfully upgraded.
Restart WebADM (y/n) y
Checking libudev dependency... Ok
Checking system architecture... Ok
Checking server configurations... Ok

No Enterprise license found (using bundled Freeware license)
Please contact sales@rcdevs.com for commercial information

Starting WebADM Session server... Ok
Starting WebADM PKI server... Ok
Starting WebADM Watchd server... Ok
Starting WebADM HTTP server... Ok

Checking server connections. Please wait... 
Connected LDAP server: LDAP Server (127.0.0.1)
Connected SQL server: SQL Server (127.0.0.1)
Connected PKI server: PKI Server (127.0.0.1)
Connected Session server: Session Server (::1)

Checking LDAP proxy user access... Ok
Checking SQL database access... Ok
Checking PKI service access... Ok
[root@centos7 tmp]# 

Your WebADM server is now up to date.

4. Adjust Application Configurations

WebADM 1.7.x comes with upgrades for all your registered applications. Some of them may be missing some mandatory settings after the upgrade. In this case, go to the Applications menu and click the REGISTER button for any application where the Not Configured message in red is displayed.

screenshot

The Web Service Status should be now Enabled.

screenshot

Your server is now ready to work with the updated version.