To update to BILLmanager 6


To update BILLmanager 5 to BILLmanager 6:

  1. Purchase a license for BILLmanager 6.
  2. To update BILLmanager 5 to BILLmanager 6:

    • Update your platform to the latest version:

      1. In the platform interface:

      2. In the left-side menu, click Update to BILLmanager 6.

      3. Specify the license key.

      4. Click Check license.

      5. Wait until the installation is complete.

    • Or update the platform through the terminal.

      1. Download the installation script:

        wget http://cdn.ispsystem.com/install.sh
        CODE


        1. Delete the license file:

          rm /usr/local/mgr5/etc/billmgr.lic -rf
          CODE
        2. Generate a new license key.
        3. Activate the new license:

          /usr/local/mgr5/sbin/licctl fetch billmgr <key>
          CODE

          <key> — license key

        4. Download the file:

          wget http://download.ispsystem.com/upgrade.billmgr5.sh
          CODE
        5. Run:

          sh upgrade.billmgr5.sh
          CODE
      2. Check the license information: 
      /usr/local/mgr5/sbin/licctl info billmgr
      CODE

Note

If non-working third-party repositories are connected to the server with BILLmanager, the control panel will not be able to update. To determine which repositories are blocking the update, run the command:

/usr/local/mgr5/sbin/pkgupgrade.sh coremanager
BASH

The reply will contain information about the repositories:

Example of reply

Reading package lists...
W: GPG error: http://dl.google.com/linux/mod-pagespeed/deb stable Release: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 1234567890ABCDEF
E: The repository 'http://dl.google.com/linux/mod-pagespeed/deb stable Release' is not signed.
CODE

If you are using the BILLmanager 6 license and the control panel is blocked, you can update BILLmanager via the console. To do this:

  1. Connect to the server with BILLmanager via SSH.
  2. Download the script for updating:

    wget http://cdn.ispsystem.com/install.sh
    CODE
  3. Run the script:

    sh install.sh
    CODE

If there is no Update to BILLmanager 6 button in the platform interface:

  1. Connect to the server with the platform via SSH.
  2. Upgrade the platform to the latest version. To do this, change the repository to beta:

    echo 'beta' > /usr/local/mgr5/etc/repo.version
    CODE
  3. Run the command to update COREmanager:

    /usr/local/mgr5/sbin/pkgupgrade.sh coremanager
    CODE

Updating to BILLmanager 6 from versions below 5.368.0

The current version of BILLmanager 6 has received a large number of updates and fixes. Updating BILLmanager versions lower than 5.368.0 to the current version must be performed step by step in manual mode. Otherwise, the update may fail or end with an error. To update BILLmanager to version 6, you must first update the platform to the current version of BILLmanager 5 - 5.368.0 or higher.

To update BILLmanager to the current version:

  1. Connect to the server with BILLmanager via SSH.
  2. Edit the file repo.version. Specify the platform version according to the formula: version of your BILLmanager platform + 20.

    vi /usr/local/mgr5/etc/repo.version
    CODE

    For example, you have BILLmanager version 5.305 installed. Specify version 5.325 in the file.

    cat /usr/local/mgr5/etc/repo.version
    5.325
    CODE
  3.  Depending on your operating system, edit the files. Specify the version of BILLmanager, as in repo.version.

    Ubuntu 20.04:

    /etc/apt/sources.list.d/ispsystem.list
    CODE

    Replace beta or version number with the BILLmanager version number from repo.version.

    For example, BILLmanager version 5.305 is installed. The file displays the version to which the platform can be updated. Replace version 5.377 with 5.325.

    cat /etc/apt/sources.list.d/ispsystem.list
    deb http://download.ispsystem.com/repo/ubuntu 5.377-focal main
    CODE
    cat /etc/apt/sources.list.d/ispsystem.list
    deb http://download.ispsystem.com/repo/ubuntu 5.325-focal main
    CODE

    CentOS 7, AlmaLinux 9:

    /etc/yum.repos.d/ispsystem.repo
    CODE

    Replace beta or version number with the BILLmanager version number from repo.version.

    For example, if BILLmanager version 5.305 is installed, then in the file you should specify version 5.325 instead of beta.

    cat /etc/yum.repos.d/ispsystem.repo
    [ispsystem-beta]
    name=ispsystem-beta
    #failovermethod=priority
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ISPsystem
    enabled=1
    #baseurl=http://download.ispsystem.com/repo/centos/beta/$releasever/$basearch
    mirrorlist=http://download.ispsystem.com/repo/centos/beta/mirrorlist.txt
    gpgcheck=1
    CODE
    cat /etc/yum.repos.d/ispsystem.repo
    [ispsystem-beta]
    name=ispsystem-beta
    #failovermethod=priority
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ISPsystem
    enabled=1
    #baseurl=http://download.ispsystem.com/repo/centos/beta/$releasever/$basearch
    mirrorlist=http://download.ispsystem.com/repo/centos/6.325/mirrorlist.txt
    gpgcheck=1
    CODE
  4. Run the update with the command:

    /usr/local/mgr5/sbin/pkgupgrade.sh coremanager
    CODE


  5. Repeat steps 2 through 4 until the BILLmanager version reaches 5.368.0.
  6. Run the BILLmanager update following the instructions.

Repositories


When you change the repository from stable to beta the control panel packages are updated to the version available in the beta repository. Switching from beta to stable will update the packages provided that the version in the stable repository is higher than the installed version. If the installed version is higher than the available one you cannot install modules in Integration → Modules. 

To avoid issues with the installation of modules:

  1. Navigate to Settings  System configuration  Update software automatically and select "do not update".  The current repository in the format  <version>-<repository>, e.g. "6.42-beta" will be added to /usr/local/mgr5/etc/repo.version.
  2. When the installed version of the control panel is available in the stable repository, change the repository from beta to stable:

echo 'stable' > /usr/local/mgr5/etc/repo.version
/usr/local/mgr5/sbin/licctl fetch billmgr --update license
BASH