Update existing AhsayOBS v6 instance to AhsayCBS v7 instance

July 29, 2025

To upgrade your existing v6 instances to v7, make sure you read through Upgrade and Upgrade AhsayOBS to AhsayCBS in the AhsayCBS guide, prepare the license, API changes, user storage rebuild and CRC check, and the AhsayCBS compatibility. If you need to update your existing AhsayOBS v6 instance to AhsayCBS v7, you will need to have a new version of template ready. Please refer to Prepare the AhsayCBS Template for your Resellers to prepare a new template of AhsayCBS v7 and update your AhsayPRD to the latest version.

  • Limitation

    The bandwidth setting is not available in the latest version of AhsayPRD.

  • Assumption

    In the following example, we are going to upgrade the reseller called “MyReseller” from their v6 instance to v7.

  • Steps

    In the following example, we are going to upgrade the reseller called “MyReseller” from their v6 instance to v7.

    1. Run the following command from the command prompt to remove the previous v6 instance from startup service.

      D:\Applications\MyReseller\bin\Aobservice –r "AhsayOBS (MyReseller)"
    2. Rename the v6 instance directory to for example D:\Applications\MyReseller_62700\. The naming is based on the version of the v6 instance.
    3. Make a copy of D:\Applications\Template as D:\Applications\MyReseller, you are suggested to apply a full folder permission to D:\Applications\MyReseller. The permission settings should be the same as your previous folder settings which is now named as MyReseller_62700 in the previous step.

    4. Run the following command from the command prompt to install the AhsayCBS service as a startup service for your reseller.

      D:\Applications\MyReseller\util\bin\service –I "AhsayCBS (MyReseller)" "AhsayCBS (MyReseller)" "D:\Applications\MyReseller\bin\cbssvcX64.exe" "AhsayCBS (MyReseller)"

      After you installed the AhsayCBS service, the service is started by default, you can stop the service in Control Panel > Administrative Tools > Services.

    5. Right click the properties of the created service. Go to the Log On tab, change the logon of the service to This account, then click Browse.

      Change the log on to the original owner, for example, MyReseller.

      You need to apply a password after you click OK.

    6. Open D:\Applications\MyReseller\bin\startup.bat.bak and change the TC_HOME environment variable to E:\MyReseller where E:\ is the drive letter of drive to be used exclusively for this AhsayCBS instance. 

      @echo off 
 
SET "TC_HOME=E:\MyReseller " 
 
@REM ************** Please leave JAVA_HOME empty as it is 
SET "JAVA_HOME=" 
  
@REM ************** Please set the correct values for 
CBS_HOME,  
 
: 
: 
:

    7. Open D:\Applications\CBS1\bin\shutdown.bat.bak and change the TC_HOME as in the previous step. 

      @echo off 
 
SET "TC_HOME=E:\MyReseller " 
 
@REM ************** Please leave JAVA_HOME empty as it is 
SET JAVA_HOME= 
  
@REM ************** Please set the correct values for 
CBS_HOME,  
 
: 
: 
:

    8. Open D:\Applications\MyReseller\conf\server.xml and change the Tomcat management interface port to the original defined TCP port, for example, 60008 and the AhsayCBS server port to the original TCP port, for example, 60007 which is used for this AhsayCBS instance exclusively. 

      <Server port="60008" shutdown="SHUTDOWN"> 
 
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />

<Listener className="org.apache.catalina.core.JasperListener" /> 
 
<Listener className="org.apache.catalina.core.JreMemoryLeakPrevention
 Listener" /> 
 
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecy
 cleListener" /> 
 
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventi
 onListener" /> 
 
<Service name="Catalina"> 
 
<Connector address="0.0.0.0"  
	port="60007"  
	protocol="AJP/1.3"  
	maxHttpHeaderSize="8192"  
	socketBuffer="16384"  
	maxThreads="2000"  
	minSpareThreads="50"  
	maxKeepAliveRequests="1000" 
	enableLookups="false"  
	redirectPort="443"  
	acceptCount="200"  
	connectionTimeout="120000"  
	disableUploadTimeout="true"  
	URIEncoding="utf-8"/> 
    
: 
: 
:

    9. Open D:\Applications\MyReseller\conf\autoDiscovery.xml and change the Auto Discovery server port to the original TCP port, for example, 10011 and the client port to the original TCP port, for example, 10012.

      <Root><AutoDiscovery server-port="10011" client-port="10012" /></Root>

    10. Open D:\Applications\Ahsay Proxy Redirector\conf\httpd.conf and check on the VHOST settings. 

      : 
: 
:
Use VHOST myreseller.ahsay.com 123.123.123.123 
reseller@ahsay.com 60007

"D:/Applications/MyReseller/webapps" 
conf/wildcard.NOT_SECURE.com.crt.signed-by-ahsayca2 
conf/wildcard.NOT_SECURE.com.key.signed-by-ahsayca2 
conf/ca.crt 2048000

      Make sure the bandwidth setting is removed. This should be handled when you upgrade the AhsayPRD.

    11. Restart Ahsay Proxy Redirector service in Control Panel > Administrative Tools > Services.
    12. Rename the bin\startup.bat.bak to startup.bat; shutdown.bat.bak to shutdown.bat, respectively.

    13. Migrate the v6 instance to the new AhsayCBS by the migrate script, Migratev6.bat in D:\Applications\MyReseller\bin.

      MigrateV6.bat <CBS_HOME> <RDR_HOME> <OBS_HOME> <obsoleted variable> <RPS_HOME>

      Where:

      • <CBS_HOME> is the directory of the AhsayCBS.
      • <RDR_HOME> is the directory of the AhsayRDR.
      • <OBS_HOME> is the directory of the AhsayOBS.
      • <Obsoleted variable> is obsoleted, please enter a null value "".
      • <RPS_HOME>, is the directory of the AhsayRPS.

      For example, we should run the following command for migrating the configuration and the user backup files of AhsayOBS to AhsayCBS, where <RDR_HOME>, <Obsoleted variable> and <RPS_HOME> are null. 

      cd D:\Applications\MyReseller\bin 
				
MigrateV6.bat "D:\Applications\MyReseller" "" 
"D:\Applications\MyReseller_62700" "" ""
    14. Startup the AhsayCBS (MyReseller) service.
    15. The service is now starting up, it should take a while when the migration starts to migrate user’s profile and user group policies to AhsayCBS. Since it is required to scan through each user profile to extract these information, more users could result in longer migration process.
    16. You may open the E:\MyReseller\logs\obs_context_yyyy-mm-dd.log to check if there are any errors during the startup, yyyy-mm-dd refers to the upgrade/migration date.
    17. Logon to the AhsayCBS web management console to check on your upgrade.

    18. Here is a list of suggested items to check after you started up your AhsayCBS.

      • Check SMTP settings in AhsayCBS web console System Settings > Basic > Email.
      • Check all users’ profile, backup and policy group settings in AhsayCBS web console Backup/Restore > Users, Groups & Policies.
      • Check https connection to the AhsayCBS on different browsers (IE, Firefox and Chrome).
      • Connect AhsayOBM/AhsayACB (v6) to AhsayCBS with both http and https connection.
      • You can also check on the differences between v6 and v7 in our appendix section, so that you can be more familiar with the new version.
      In the future, if you define any resellers or subadmin in your AhsayCBS, please make sure to add the VHOST definition in D:\Applications\Ahsay Proxy Redirector\conf\httpd.conf. 
      : 
: 
: 
Use VHOST reseller.backup.com 123.123.123.123 
reseller@backup.com 60009 
"D:/Applications/Reseller/webapps" conf/backup.com.crt 
conf/backup.com.key conf/ca1.crt
Documentation