====== AhsayOBM =====

Last modified: 2023/06/20 

AhsayOBM is the client agent for backing up servers, databases, and VMs, cloud files, and Microsoft 365 as admin.

{{public:ahsay_wiki_software_obm_requirement_00.png?640}}

----

===== System Architecture =====
Below is the system architecture diagram illustrating the major elements involved in the backup process among the backup machine, AhsayOBM and AhsayCBS.

{{public:ahsay_wiki_software_obm_requirement_01.png?650}}

----

===== Requirements =====

==== General ====
<WRAP indent>
=== Hardware Requirements === 
For details of the minimum and recommended requirements for installing AhsayOBM, refer to: [[public:version_9:start_here:9000_ahsay_hardware_requirement_list_hrl_for_version_9.1_or_above|Ahsay Hardware Requirement List (HRL)]]

=== Software Requirements ===
For the list of compatible operating systems, refer to: [[public:version_9:start_here:9005_ahsay_software_compatibility_list_scl_for_version_9.1_or_above|Ahsay Software Compatibility List (SCL)]]

For the list of compatible operating system for OpenDirect and Granular Restore, refer to: [[public:version_9:start_here:9006_ahsay_scl_for_granular_and_opendirect_restore_v9|Ahsay Software Compatibility List (SCL) for Granular and OpenDirect Restore]]

=== Antivirus Exclusion Requirement ===
To optimize performance of AhsayOBM on Windows, and to avoid conflict with your antivirus software, refer to this [[public:version_9:start_here:9023_suggestion_on_antivirus_exclusions|list of processes and directory paths that should be added to all antivirus software white-list / exclusion list]].
</WRAP>

==== Windows ====
The bJW.exe process is automatically added to Windows Defender exclusion list for Windows 10 and 2016, during installation / upgrade via installer or upgrade via AUA. 

==== Mac OS X ====
These are the limitations to AhsayOBM running on Mac OS X:

<WRAP indent>
=== Installation on Root Drive ===
AhsayOBM must be installed on the root drive of a volume (e.g. /Applications/...).

=== Resource Fork Files ===
Resource fork files cannot be restored with AhsayOBM installation on Mac OS X 10.8 above.

=== Case-Insensitive File System ===
For volume with a case-insensitive file system, target file of a symbolic link will be backed up twice (in both upper case and in lower case), hence, doubling the backup quota storage requirement.
</WRAP>

==== Linux (GUI and CLI) ====
<WRAP indent>
=== GUI Desktop Environment ===
The Linux machine must be installed with a GUI desktop environment, i.e. GNOME, KDE, Cinnamon etc.

=== Linux Packages ===
The following packages have to be present on the Linux machine in order for AhsayOBM version 9 to be installed.

<WRAP indent>
== curl ==
[[https://curl.haxx.se]] \\ The ‘curl’ command is used by both the AhsayOBM sh script and rpm installer to download components from AhsayCBS server during the installation process.

== tar == 
[[https://www.gnu.org/software/tar]] \\ The ‘tar’ command is used by both the AhsayOBM sh script, gz, and rpm installer to uncompress and extract installation files or components downloaded from the AhayCBS backup server onto the Linux machine.

== rpm == 
[[http://rpm.org]] \\ The ‘rpm’ package must be installed to use the AhsayOBM rpm installation method.

== dpkg == 
[[https://packages.ubuntu.com/kinetic/dpkg]] \\ The ‘dpkg’ package must be installed to use the AhsayOBM deb installation method on Ubuntu LTS Linux platforms supported from version 7.15.0.0 or above.

== psmisc ==  
[[http://psmisc.sourceforge.net/]] \\ The ‘psmisc’ package which contains the ‘fuser’ components must be installed for AhsayOBM on CentOS / Red Hat Enterprise Linux (RHEL), for the auto update agent (AUA) process to work properly.

== OpenJDK Version 1.8 == 
[[https://www.freebsd.org/java/]] \\ The installed Java Development Kit version must at least be 8.

== GNU LIBC 2.14 ==
[[https://www.gnu.org/software/libc/]] \\ The installed ‘GNU LIBC’ version must at least be 2.14 for OpenJDK 8 to work.
</WRAP>
</WRAP>

==== FreeBSD ====
The following packages have to be present in the FreeBSD machine to enable installation and normal operations of AhsayOBM version 9.
<WRAP indent>
=== Packages ===
<WRAP indent>
== curl ==
[[https://www.freshports.org/ftp/curl/]]  \\ The ‘curl’ command is used by the AhsayOBM sh script installer to download components from AhsayCBS server during the installation process.

== tar ==
[[https://www.gnu.org/software/tar]]  \\ The ‘tar’ command is used by the AhsayOBM gz installer to uncompress and extract installation files or components downloaded from the AhayCBS backup server onto the FreeBSD machine.

== psmisc ==
[[http://psmisc.sourceforge.net/]] \\ The ‘psmisc’ package which contains the ‘fuser’ components must be installed for AhsayOBM on FreeBSD, for the auto update agent (AUA) process to work properly.

== Openjdk8 ==
[[https://www.freebsd.org/java/]]   \\ The ‘openjdk8’ package must be installed for AhsayOBM on FreeBSD since this is the reference implementation of Java SE.

== GNU LIBC 2.14 ==
[[https://www.gnu.org/software/libc/]]  \\ The installed ‘GNU LIBC’ version must at least be 2.14 for OpenJDK 8 to work.
</WRAP>

</WRAP>

----

===== Documentation =====
  * [[https://www.ahsay.com/jsp/en/downloads/ahsay-downloads_documentation_guides-obm.jsp|AhsayOBM and AhsayACB guides]]

<HTML>
<!--
  * [[https://www.ahsay.com/jsp/en/downloads/ahsay-downloads_documentation_guides|AhsayOBM and AhsayACB guides]]

===== FAQs =====
  * [[public:5003_faq:how_do_i_modify_the_java_heap_size_setting_of_ahsayobm_or_ahsayacb|How do I modify the Java heap size setting of AhsayOBM or AhsayACB?]]
  * [[public:5012_faq:how_to_create_a_ms_windows_system_backup_set_with_ahsayobm|How to create a MS Windows system backup set with AhsayOBM?]]
  * [[public:5034_best_practices_for_managing_encryption_key|Best practices for managing encryption key on AhsayOBM or AhsayACB version 7?]]
  * [[public:5038_faq:factors_affecting_backup_performance_on_ahsayobm_or_ahsayacb_version_7|Factors affecting backup performance on AhsayOBM / AhsayACB version 7?]]
  * [[public:5146_faq:how_to_install_the_latest_patch_set_for_ahsayobm_ahsayacb|How to install the latest patch set for AhsayOBM / AhsayACB?]]
  * [[public:5163_how_to_run_a_data_integrity_check_linux_cli|How to run a Data Integrity Check on AhsayOBM version 7 on Linux (CLI) machine]]
  * [[public:5229_faq:is_there_any_script_for_silent_installation_of_ahsayobm_ahsayacb_on_windows_platform_so_that_the_client_application_is_installed_without_the_end_user_interaction|Is there any script for silent installation of AhsayOBM or AhsayACB on Windows platform (so that the client application is installed without the end user interaction)?]]
  * [[public:5258_faq:how_to_install_ahsayobm_on_windows_server_core|How To Install AhsayOBM On Windows Server Core]]

===== Issues =====
  * [[public:5097_issue:the_specified_backup_type_is_invalid_cannot_start_backup_job_via_the_ahsayobm_ahsayacb_system_tray_icon|The specified BACKUP TYPE is invalid (Cannot start backup job via the AhsayOBM / AhsayACB system tray icon)]]
  * [[public:5112_issue:strange_characters_displayed_when_installing_ahsayobm_acb_with_branded_client_installer_on_a_windows_computer_with_chinese_locale|Strange characters displayed when installing AhsayOBM / ACB with branded client installer on a Windows computer with Chinese locale]]
  * [[public:5183_issue:cannot_access_backup_set_in_ahsayobm_for_backup_set_created_using_the_addbackupset.do_api_with_default_encryption_setting|Cannot access backup set in AhsayOBM for backup set created using the AddBackupSet.do API (with DEFAULT encryption setting)]]
  * [[public:5200_issue:network_drives_are_not_displayed_by_ahsayobm_as_a_selectable_destination_for_the_image_spool_path_when_creating_a_windows_system_backup_set|Network drives are not displayed by AhsayOBM as a selectable destination for the image spool path when creating a Windows System Backup Set ]]
  * [[public:5207_no_appenders_warning_when_running_script_on_linux|No appenders could be found for logger (warning in debug log during a scheduled backup / when running AhsayOBM scripts on Linux platforms)]]
  * [[public:5230_issue:curl:not_found_file_does_not_exist_error_when_installing_ahsayobm_v7_on_linux_freebsd_using_cli|‘curl: not found File does not exist’ error when installing AhsayOBM v7 on Linux or FreeBSD using CLI ]]
  * [[public:5231_issue:when_performing_a_backup_job_on_ahsayobm_ahsayacb_the_following_error_is_shown_chunkedoutputstream.flushdata.execute_failed_to_flush_buffer_to_this_destination_error_com.ahsay.afc.cloud.d_failed_to_get_outputstream_of_file|When performing a backup job on AhsayOBM/AhsayACB the following error is shown [ChunkedOutputStream.FlushData.execute Failed to flush buffer to this destination Error=com.ahsay.afc.cloud.d Failed to get OutputStream of file"]]
  * [[public:5235_issue:throwable_direct_buffer_memory_caused_by_outofmemoryerror_direct_buffer_memory_error_when_running_backup_on_ahsayobm_ahsayacb|Throwable=Direct buffer memory, caused by [OutOfMemoryError] Direct buffer memory error when running backup on AhsayOBM/AhsayACB]]

-->
</HTML>