This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | |||
public:8132_faq:dsm7v85486 [2022/12/30 16:08] kirk.lim |
public:8132_faq:dsm7v85486 [2023/03/15 14:23] (current) clarence.lee |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ===== [V8][V9] FAQ: AhsayOBM v8.5.4.86+ workaround to support Synology DSM 7 ===== | ||
- | |||
<html> | <html> | ||
- | <b> | + | <script type="text/javascript"> |
- | Article ID: | + | window.location.replace("https://wiki.ahsay.com/doku.php?id=public:8132_faq:obm_workaround_dsm7"); |
- | </b> | + | </script> |
- | 8132 | + | |
- | <br/> | + | |
- | <b> | + | |
- | Posted: | + | |
- | </b> | + | |
- | 2021-10-11 | + | |
- | <br/> | + | |
- | <br/> | + | |
- | <b> | + | |
- | Product Version: | + | |
- | </b> | + | |
- | <br/> | + | |
- | AhsayCBS: 8.5.4.86+, v9.x | + | |
- | <br/> | + | |
- | OS: Synology DSM 7 | + | |
</html> | </html> | ||
- | |||
- | |||
- | ===== Description ===== | ||
- | <html> | ||
- | For customers currently running minimum v8.5.4.86 (base), we have a workaround that allows your users running Synology DSM 7 to install AhsayOBM. | ||
- | <br/><br/> | ||
- | 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 <A HREF=https://wiki.ahsay.com/doku.php?id=public:8009_faq:how_to_install_the_latest_patch_set_for_ahsaycbs>upgrade (v8)</A> or <A HREF=https://wiki.ahsay.com/doku.php?id=public:version_9:start_here:9010_how_to_install_the_latest_patch_set_for_ahsaycbs>(v9)</A>. CBS installer download available from <A HREF=https://www.ahsay.com>www.ahsay.com</A>. | ||
- | <br/> | ||
- | <br/> | ||
- | NOTE: For branded CBS or branded Sub Admin sites, you must first complete Rebuild Client before proceeding. | ||
- | <br/> | ||
- | <UL> | ||
- | <B>Q: How to tell if you have this base version? </B> | ||
- | <br/> | ||
- | A1: Login to your CBS Admin Web Console, click on <I>License</I>, then scroll down to read the <B>Product Version</B>. | ||
- | <BR/> | ||
- | A2: In your CBS Installation Directory, check the “<I>version.txt</I>”, should be v8.5.4.86 or greater. | ||
- | |||
- | <BR/> | ||
- | <BR/> | ||
- | <B>Q: If I upgrade my CBS to a newer release, do I need to redo these procedures? </B> | ||
- | <br/> | ||
- | A: Yes. If you upgrade v8.5.4.86, to a new CBS release, you will need to repeat these procedures for the latest SPK file version. | ||
- | |||
- | <BR/> | ||
- | <BR/> | ||
- | <B>Q: Do I need to redo these procedures if I upgrade to CBS v9? </B> | ||
- | <br/> | ||
- | 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. | ||
- | |||
- | <BR/> | ||
- | <BR/> | ||
- | <B>Q: My client agents are branded, do I need to repeat these procedures for each branding? </B> | ||
- | <br/> | ||
- | 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. | ||
- | |||
- | <BR/> | ||
- | </UL> | ||
- | <br/><U>Skill Level: </U> | ||
- | <UL> | ||
- | <br/><B>Novice</B>, does require manual effort to repackage the OBM Synology SPK installer file using a staging PC as instructed in below procedure. | ||
- | </UL> | ||
- | <br/> | ||
- | <br/><U>Task Time: </U> | ||
- | <UL> | ||
- | <br/>Average 7-10 minutes | ||
- | </UL> | ||
- | <br/> | ||
- | <br/><U>Pre-Requisites to prepare the workaround:</U> | ||
- | <br/><UL> | ||
- | <LI><FONT COLOR=black> CBS meets minimum base version</FONT> | ||
- | <br/><LI><FONT COLOR=black> Rebuild Client completed for branded sites</FONT> | ||
- | <br/><LI><FONT COLOR=black> Your PC, with:</FONT> | ||
- | <UL><FONT COLOR=black>• 7z / 7zip (<A HREF=https://www.7-zip.org>https://www.7-zip.org</A>)</FONT> | ||
- | <br/><FONT COLOR=black>• Text editor</FONT> | ||
- | </UL> | ||
- | </UL> | ||
- | <br/>Note: | ||
- | <br/><UL><LI><FONT COLOR=black> The “.SPK” file format is a Synology Package. | ||
- | <br/><LI><FONT COLOR=black> Modifications to the OBM SPK installer file at your own risk. We recommend you retain an unmodified copy of the SPK file before continuing.</FONT> | ||
- | <br/><LI><FONT COLOR=black> 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.</FONT> | ||
- | <br/><LI><FONT COLOR=black> 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.</FONT> | ||
- | <br/><LI><FONT COLOR=black><B> 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.</B></FONT> | ||
- | </UL> | ||
- | <br/> | ||
- | <br/><U>Workaround steps to be completed by CBS Admin:</U> | ||
- | <UL> | ||
- | <br/>1. Download and save the OBM Synology SPK file from your CBS, to your local PC. | ||
- | <br/> | ||
- | <br/>2. Open file using 7z application by "Open archive" function | ||
- | <br/> | ||
- | <br/>3. Copy <B>INFO</B> file from the SPK file, to local disk | ||
- | <br/> | ||
- | <br/>4. Delete <B>INFO</B> file from SPK file using 7z application | ||
- | <br/> | ||
- | <br/>5. Using text editor, open <B>INFO</B> file, | ||
- | <br><UL>a. At the end of file, add the following line: | ||
- | <UL><UL> | ||
- | <br/><I> os_min_ver="7.0-40000"</I> | ||
- | </UL></UL> | ||
- | <br/>b. Copy the text value of "<B><I>package</I></B>" and edit the line of "<B><I>dsmuidir</I></B>": | ||
- | <UL><UL> | ||
- | <TABLE BORDER=0> | ||
- | <TR><TD>find this line</TD><TD>package="AhsayOBM"</TD></TR> | ||
- | <TR><TD>copy text</TD><TD><I>AhsayOBM<I></TD></TR> | ||
- | <TR><TD>find this line</TD><TD><I> dsmuidir="ui"</I></TD></TR> | ||
- | <TR><TD>edit to</TD><TD>dsmuidir="<B>%package%</B><FONT SIZE=+1>:</FONT>obm/wui"</TD></TR> | ||
- | <TR><TD> </TD><TD> (where <B><I>%package%</I></B> is replaced with the text value from the <B>'package'</B> line)</TD></TR> | ||
- | <TR><TD> </TD><TD> Example: dsmuidir="AhsayOBM:obm/wui"</TD></TR> | ||
- | </TABLE> | ||
- | </UL></UL> | ||
- | <br/>c. Save file | ||
- | </UL> | ||
- | <br/>6. Drag updated <B>INFO</B> file, from local disk into the 7z window (SPK file) | ||
- | <br/> | ||
- | <br/>7. Download and unzip following files from <A HREF=https://download.ahsay.com/support/30215/AhsayCBS854DSM7privilege.zip>https://download.ahsay.com/support/30215/AhsayCBS854DSM7privilege.zip</A> | ||
- | <UL><UL> | ||
- | <br/><B>privilege</B> | ||
- | </UL></UL> | ||
- | <br/>8. Still in 7z window, open <B><I>conf</I></B> folder, then drag to add the <B>privilege</B> file from local disk into SPK file. | ||
- | <br/> | ||
- | <br/>9. Close the modified SPK file (Save changes if prompted) | ||
- | <br/> | ||
- | <br/>10. As the CBS Admin, you’ll need to distribute the modified SPK to your DSM 7 users. | ||
- | <UL> | ||
- | <br/>NOTE: Not recommend to overwrite either <I>%CBSHOME%</I>/download/ , or <I>%CBSHOME%</I>/system/cbs/Installers/{dir}/ | ||
- | <br/> | ||
- | <br/>(Optional Steps) | ||
- | <br/>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: | ||
- | <br/> | ||
- | <br/>1) Save the modified SPK (example filename: <I>obm854-dsm7.spk</I>) into your CBS’s path: <I>%CBSHOME%</I>\webapps\ROOT\obm854-dsm7.spk | ||
- | <UL> | ||
- | <TABLE BORDER=0> | ||
- | <TR><TD>Default Windows</TD><TD>C:\Program Files\AhsayCBS\webapps\ROOT\obm854-dsm7.spk</TD></TR> | ||
- | <TR><TD>Default Linux</TD><TD>/usr/local/cbs/webapps/ROOT/obm854-dsm7.spk</TD></TR> | ||
- | </TABLE> | ||
- | <FONT COLOR=red>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.</FONT> | ||
- | <br/><B>NOTE: For CBS sites with several branded Sub Admin, you need to save as unique filenames.</B> | ||
- | </UL> | ||
- | 2) Inform your users to download it from <I>https://yourCBS.domain.com/obm854-dsm7.spk</I> | ||
- | <br/> | ||
- | <br/>3) After download, they can follow normal installation procedures. | ||
- | </UL> | ||
- | </UL> | ||
- | |||
- | <br/><br/> | ||
- | <br/><U>DSM 7 User:</U> | ||
- | <UL> | ||
- | <br/>1. Transfer the modified SPK to your machine that will access the DSM Console. | ||
- | <UL> | ||
- | <br/>Example, download from <I>https://yourCBS.domain.com/obm854-dsm7.spk</I> | ||
- | </UL> | ||
- | <br/>2. Install the application with the updated SPK, follow normal installation procedures. | ||
- | <UL> | ||
- | <br/>NOTE: Modified SPK cannot be used on older DSM. Will fail install. | ||
- | </UL> | ||
- | <br/>3. Run application and perform desired actions, such as backup and restore | ||
- | </UL> | ||
- | |||
- | <br/> | ||
- | </html> | ||
- | ===== Addendum - Insufficient Permissions ===== | ||
- | <html> | ||
- | <br/><U>Addendum:</U> | ||
- | <br/>When performing Backup or Restore, <FONT SIZE=+1 COLOR=red><I>Insufficient Permissions</I></FONT> might be encountered. | ||
- | For share folders, grant <B>read</B> (for backup) and <B>write</B> (for restore) permission to application, read this <A HREF=https://download.ahsay.com/support/30215/DSM7-PermissionFix.pdf>Document</A> | ||
- | <br/> | ||
- | <br/> | ||
- | |||
- | |||
- | <br/><br/> | ||
- | </html> | ||
- | ===== Example simulation video ===== | ||
- | <html> | ||
- | <UL> | ||
- | <video width="800" height="480" controls> | ||
- | <source src="https://download.ahsay.com/support/30215/WorkaroundHowToDSM7v854.mp4" type="video/mp4"> | ||
- | Your browser does not support the video tag. | ||
- | </video> | ||
- | </UL> | ||
- | <BR/><BR/> | ||
- | |||
- | </html> | ||
- | |||
- | ===== Keywords ===== | ||
- | OBM, Update, Workaround, DSM, Synology, DSM7, CBS854, 8.5.4, 30215 |