Upgrade Procedure for Linux (CentOS, Red Hat Enterprise, Ubuntu, Debian)

To operate the below steps, you need to have shell access, have superuser privilege (i.e. root), experience with Unix commands, and you need to have some experience on installing/upgrading our products before.

Assumption

You have installed AhsayCBS in the path /usr/local/cbs. Substitute our default path with your true installation path. Alternatively, you may install into any mount if it is not nested in an existing Ahsay installation (It is illegal to currently have AhsayCBS installed in /home/cbs, and you upgrade into nested /home/cbs/cbs9).

AhsayCBS v9 uses OpenJDK 8 which requires GLIBC 2.14 to be installed.

OpenJDK 8 is bundled with installation of AhsayCBS for Linux.

To check your version, run “ldd --version” from shell.

If you have questions, contact Ahsay Technical Support, before proceeding with the upgrade.

  1. Download the AhsayCBS zipped tar file (cbs-nix.tar.gz) from our website. Note the path where it was downloaded.
  2. Logon with root privilege on your server.

  3. From shell terminal, Stop the AhsayCBS service.

    # cd /usr/local/cbs/bin
# sh shutdown.sh
  4. If branded, remove the folder /usr/local/cbs/system/cbs/Installers; to cleanup old branded client binaries.

  5. Verify that the service terminated.

    # ps -ef | grep java

  6. Rename the existing installation folder e.g. /usr/local/cbs85486 (rename the folder with its current version number appended; i.e. v8.5.4.86) so that you have a rollback copy in case of upgrade issue.

    # mv /usr/local/cbs /usr/local/cbs85486

  7. Create a new AhsayCBS folder to replace the folder your renamed in the previous step. Folder name must match, otherwise existing AhsayCBS service script will fail to start.

    # mkdir /usr/local/cbs

  8. Copy the installation file, cbs-nix.tar.gz to /usr/local/cbs and untar it.

    # cp cbs-nix.tar.gz /usr/local/cbs
# cd /usr/local/cbs
# gunzip cbs-nix.tar.gz
# tar -xf cbs-nix.tar

  9. Space permitting, copy the configuration folder, system settings folder, log folder and standard user home folder from the old AhsayCBS folder (e.g.: cbs85486) to the installation path. (If lack of space, you can Move instead of Copy).

    You may omit moving the “user” folder, if your User Home path is not a directory inside your AhsayCBS installation path.

    Example:

    # cd /usr/local/cbs
# cp -rp /usr/local/cbs85486/conf .
# cp -rp /usr/local/cbs85486/system .
# cp -rp /usr/local/cbs85486/logs .
# cp -rp /usr/local/cbs85486/user .

  10. Startup the AhsayCBS service by running the following commands:

    # cd /usr/local/cbs/bin
# sh startup.sh
  11. You may open the /usr/local/cbs/logs/obs_context_yyyy-mm-dd.log to check if there are any errors during the startup.

  12. Logon to the AhsayCBS web management console and do a post-upgrade check.

    For a list of suggested items to check after you started up your AhsayCBS, please refer to the previous section.

AhsayCBS (DIY)