Article ID: 8132
Posted: 2023-03-20

Product Version:
AhsayCBS: 8.7, 9.1 - 9.5.2.x
OS: Synology DSM 7

For customers currently running minimum v8.7.0.0 (base), we have a workaround that allows your users running Synology DSM 7 to install AhsayOBM.

This workaround applies to base release (with or without newer hotfix). If your CBS is lower than this base version you will need to first upgrade (v8) or (v9). CBS installer download available from www.ahsay.com.

NOTE: For branded CBS or branded Sub Admin sites, you must first complete Rebuild Client before proceeding.

Q: How to tell if you have this base version?
A1: Login to your CBS Admin Web Console, click on License, then scroll down to read the Product Version.
A2: In your CBS Installation Directory, check the “version.txt”, should be v8.7.0.0 or greater.

Q: If I upgrade my CBS to a newer release, do I need to redo these procedures?
A: Yes. If you upgrade v8.7.0.0, to a new CBS release, you will need to repeat these procedures for the latest SPK file version.

Q: Do I need to redo these procedures if I upgrade to CBS v9?
A: Yes. And repeat the same anytime you upgrade CBS again. You cannot reuse an older custom SPK, after you upgrade to higher CBS version.

Q: My client agents are branded, do I need to repeat these procedures for each branding?
A: Yes. After you Rebuild Client per sub-admin, you'll need to repeat these steps. If you later re-Rebuild again, the SPK will again need to be modified according to below instructions.

Skill Level:

Novice, does require manual effort to repackage the OBM Synology SPK installer file using a staging PC as instructed in below procedure.

Task Time:

Average 7-10 minutes

Pre-Requisites to prepare the workaround:

• CBS meets minimum base version
  
• Rebuild Client completed for branded sites
  
• Your PC, with:
  • 7z / 7zip (https://www.7-zip.org)
  • Text editor

Note:

• The “.SPK” file format is a Synology Package.
  
• Modifications to the OBM SPK installer file at your own risk. We recommend you retain an unmodified copy of the SPK file before continuing.
  
• Modification to the OBM SPK file will only apply to Synology running DSM 7. For older DSM, continue to download SPK from CBS Download page.
  
• Modified OBM SPK for DSM 7 is not a replacement for your CBS’s standard Synology download when you must be compatible with older DSM. If older DSM runs the modified SPK, they will fail installation.
  
• If you have Sub Admin (resellers) with custom branding, these steps will need to be repeated using the OBM SPK download from each Sub Admin’s CBS Download page.

Workaround steps to be completed by CBS Admin:

1. Download and save the OBM Synology SPK file from your CBS, to your local PC.

2. Open file using 7z application by "Open archive" function

3. Copy INFO file from the SPK file, to local disk

4. Delete INFO file from SPK file using 7z application

5. Using text editor, open INFO file,

a. At the end of file, add the following line:

os_min_ver="7.0-40000"

b. Copy the text value of "package" and edit the line of "dsmuidir":

find this line	package="AhsayOBM"
copy text	AhsayOBM
find this line	dsmuidir="ui"
edit to	dsmuidir="%package%:obm/wui"
	(where %package% is replaced with the text value from the 'package' line)
	Example: dsmuidir="AhsayOBM:obm/wui"


c. Save file

6. Drag updated INFO file, from local disk into the 7z window (SPK file)

7. Download and unzip following files from https://download.ahsay.com/support/30215/AhsayCBS9DSM7privilege.zip

privilege

8. Still in 7z window, open conf folder, then drag to add the privilege file from local disk into SPK file.

9. Close the modified SPK file (Save changes if prompted)

10. As the CBS Admin, you’ll need to distribute the modified SPK to your DSM 7 users.

NOTE: Not recommend to overwrite either %CBSHOME%/download/ , or %CBSHOME%/system/cbs/Installers/{dir}/

(Optional Steps)
If you will redistribute the modified SPK and need a way for your users to manually download the modified SPK, you can consider the following:

1) Save the modified SPK (example filename: obm9-dsm7.spk) into your CBS’s path: %CBSHOME%\webapps\ROOT\obm9-dsm7.spk

Default Windows	C:\Program Files\AhsayCBS\webapps\ROOT\obm9-dsm7.spk
Default Linux	/usr/local/cbs/webapps/ROOT/obm9-dsm7.spk

NOTE: When upgrading to future CBS base version, you need to remove this file from circulation as it would be deemed outdated. Generate a new SPK with the newer base version.
NOTE: For CBS sites with several branded Sub Admin, you need to save as unique filenames.
2) Inform your users to download it from https://yourCBS.domain.com/obm9-dsm7.spk

3) After download, they can follow normal installation procedures.

DSM 7 User:

1. Transfer the modified SPK to your machine that will access the DSM Console.

Example, download from https://yourCBS.domain.com/obm9-dsm7.spk

2. Install the application with the updated SPK, follow normal installation procedures.

NOTE: Modified SPK cannot be used on older DSM. Will fail install.

3. Run application and perform desired actions, such as backup and restore