AhsayOBM workaround to support Synology DSM 7
Article ID
Product Version
Operating System
Description
This Know-How article will discuss the steps to perform to support 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 AhsayCBS is lower than this base version, you will need to first upgrade to v8 or v9. The AhsayCBS installer is available for download from the Ahsay Free trial/download page.
Login to your AhsayCBS Admin Web Console, click on License, then scroll down to check the Product Version.
You can also check in your AhsayCBS Installation Directory, check the "version.txt" file, should be v8.7.0.0 or above.
Pre-Requisites to prepare the workaround:
-
AhsayCBS meets minimum base version
- Rebuild Client completed for branded sites
-
Your PC has:
- 7z / 7zip
- Text editor
- The ".SPK" file format is a Synology Package.
- Modify the AhsayOBM SPK installer file at your own risk. We recommend you retain an unmodified copy of the SPK file before continuing.
- Modification to the AhsayOBM SPK file will only apply to Synology running DSM 7. For older DSM, continue to download SPK from the AhsayCBS Download page.
- Modified AhsayOBM SPK for DSM 7 is not a replacement for your AhsayCBS'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 (reseller) with custom branding, these steps will need to be repeated using the AhsayOBM SPK download from each Sub Admin's AhsayCBS Download page.
Solution
Workaround steps to be completed by AhsayCBS Admin:
- Download and save the AhsayOBM Synology SPK file from your AhsayCBS to your local PC.
- Open the file using 7z application by "Open archive" function.
- Copy the INFO file from the SPK file to your local disk.
- Delete the INFO file from the SPK file using the 7z application.
-
Using a text editor, open the INFO file.
-
At the end of the file, add the following line:
os_min_ver="7.0-40000"
-
Copy the text value of "package" and edit the line "dsmuidir".
Find the line package="AhsayOBM" and copy the text which is AhsayOBM
Find the line dsmuidir="ui" and edit to dsmuidir="%package%:obm/wui" (where %package% is replaced with the text value from the package line)
Example: dsmuidir="AhsayOBM:obm/wui"
- Save the file.
-
- Drag the updated INFO file from the local disk to the 7z window (SPK file).
-
Download and unzip the privilege file from https://download.ahsay.com/support/30215/AhsayCBS9DSM7privilege.zip.
- Still in the 7z window, open the conf folder then drag to add the privilege fie from the local disk to the SPK file.
- Close the modified SPK file. (Save changes if prompted)
- As the AhsayCBS Admin, you will need to distribute the modified SPK to your DSM 7 users.
Not recommended to overwrite either %AhsayCBSHOME%/download/ or %AhsayCBSHOME%/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:
-
Save the modified SPK (example filename: obm9-dsm7.spk) to your AhsayCBS path: %AhsayCBSHOME%\webapps\ROOT\obm9-dsm7.spk
Default path in Windows is C:\Program Files\AhsayCBS\webapps\ROOT\obm9-dsm7.spk
Default path in Linux is /usr/local/cbs/webapps\ROOT\obm9-dsm7.spk
When upgrading to future AhsayCBS 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.
For CBS sites with several branded Sub Admin, you need to save as unique filenames.
- Inform your users to download it from https://yourAhsayCBS.domain.com/obm9-dsm7.spk.
- After download, they can follow normal installation procedures.
-
DSM 7 User:
-
Transfer the modified SPK to your machine that will access the DSM console.
Example download from https://yourAhsayCBS.domain.com/obm9-dsm7.spk
-
Install the application with the updated SPK, follow normal installation procedures.
Modified SPK cannot be used on older DSM. Install will fail. - Run application and perform desired actions, such as backup and restore.
Addendum - Insufficient Permissions
When performing Backup or Restore, "Insufficient Permissions" might be encountered. For share folders, grant read (for backup) and write (for restore) permission to application. For more information, please refer to AhsayOBM v8.5.4.x on Synology DSM 7 - Insufficient Permission
.