Skip to main content

Post-Installation Check for macOS


AhsayOBM Services Check

The AhsayOBM Services is a key component which regulates and controls several important functions on AhsayOBM.

FunctionDescription
Schedule BackupsEnsures that backup jobs which are setup to run at a certain date and/or time are started.
Continuous Backups (Windows platform only)Ensures that Continuous backups are run according to the backup interval.
Mobile Backup Server (MBS)

Ensures that registered mobile devices can perform backups to AhsayOBM. The MBS will be activated when a mobile device is registered for mobile backup on AhsayOBM.

The MBS will be deactivated when all mobile devices have been deregistered from the mobile backup settings and the AhsayOBM services is restarted.

Therefore, it is very important to ensure the AhsayOBM Services are running after:

  • a new AhsayOBM installation
  • an AhsayOBM software update
  • the machine was rebooted
  • the machine is powered on
  • the machine wakes up from hibernation or standby mode

Otherwise, all the functions above will stop working.

To check if the AhsayOBM Scheduler Service is running properly on the local machine click Go at the top menu bar and click Utilities

utilities

Open the Terminal application.

terminal

Use the command highlighted in red to enter the AhsayOBM folder.

admin@admins-Mac ~ % cd /Applications/AhsayOBM.app/bin
  admin@admins-Mac bin %

To check if the scheduler services is running, use the ps command. You will see that the scheduler service is running, highlighted in red.

admin@admins-Mac bin % ps -ef|grep java
0 10376 1 0 24Mar23 ?? 2:01.03 /Applications/AhsayOBM.app/jvm
/bin/java/ -Xms128m -Xmx768m -Djava.class.path=/Applications/AhsayOBM.app
/bin:/Applications/AhsayOBM.app/bin/cbs.jar -Djava.library.path=/
Applications/AhsayOBM.app/bin:/Applications/AhsayOBM.app/bin/MacX84:/
Applications/AhsayOBM.app/mbs/ bin/MacX84 cbs /Applications/AhsayOBM.app
501 13283 13268 0 10:59AM ttys000 0:00.00 grep java
admin@admins-Mac bin %

There are two (2) options to stop and start the AhsayOBM scheduler service.

Option 1:

To stop the scheduler service, use the command highlighted in red. If you run this command for the first time, you will need to enter the login password of your local machine. To check if the scheduler service has stopped running, use the ps command.

admin@admins-Mac ~ % sudo /Applications/AhsayOBM.app/bin/StopScheduler.sh
Password:
admin@admins-Mac ~ % ps -ef|grep java
501 13451 13443 0 11:13AM ttys000 0:00.00 grep java

Use the command highlighted in red to start the scheduler service then use the ps command. You will see that the scheduler service is running, highlighted in red.

admin@admins-Mac ~ % sudo /Applications/AhsayOBM.app/bin/Scheduler.sh
Create Scheduler Service JVM, Path: /Applications/AhsayOBM.app/jvm/bin/
bschJW
admin@admins-Mac ~ % ps -ef|grep java
0 13469 1 0 11:16AM ttys000 0:02.16 /Applications/AhsayOBM.app/jvm
/bin/java/ -Xms128m -Xmx2048m -Djava.library.path=/.:./MacX84:./../mbs/bin/
MacX84 – cp .:./cbs.jar cbs /Applications/AhsayOBM.app
501 13479 13443 0 11:16AM ttys000 0:00.00 grep java

Option 2:

To stop the scheduler service, use the command highlighted in red. Use the ps command to check if the scheduler service has stopped running.

admin@admins-Mac ~ % sudo launchctl unload -F /Applications/AhsayOBM.app/
bin/com.cb.scheduler.plist
admin@admins-Mac ~ % ps -ef|grep java
501 13520 13443 0 11:30AM ttys000 0:00.00 grep java

Use the command highlighted in red to start the scheduler service then use the ps command. You will see that the scheduler service is running, highlighted in red.

admin@admins-Mac ~ % sudo launchctl load -F /Applications/AhsayOBM.app/
bin/com.cb.scheduler.plist
admin@admins-Mac ~ % ps -ef|grep java
0 13469 1 0 11:16AM ttys000 0:08.54 /Applications/AhsayOBM.app/jvm
/bin/java/ -Xms128m -Xmx2048m -Djava.library.path=/.:./MacX84:./../mbs/bin/
MacX84 – cp .:./cbs.jar cbs /Applications/AhsayOBM.app
501 13542 13443 0 11:13AM ttys000 0:00.00 grep java

Runlevel Symlink Check

During installation, the following symlinks will be created to the scheduler startup script:

/Applications/AhsayOBM.app/bin/com.cb.scheduler.plist

This will allow the AhsayOBM Scheduler Service to automatically start each time the machine is rebooted or restarted.

To verify if the symlinks have been created correctly, use the ls command. You will see the symlink highlighted in red.

admin@admins-Mac ~ % la -la /Library/LaunchDaemons/
total 16
drwxr-xr-x 64 root wheel 2048 Mar 17 15:13 ..
lrwxr-xr-x 1 root wheel 53 Mar 24 11:42 com.AhsayOBM.scheduler.plist
-> /Applications/AhsayOBM.app/bin/com.cb.scheduler.plist
admin@admins-Mac ~ %

Mobile Backup Server (MBS) Status Check

The Mobile Backup Server (MBS) will be activated automatically when a mobile device installed with the Ahsay Mobile app is successfully registered for mobile backup with AhsayOBM.

Before starting a backup on your mobile device, check the following first:

  1. Check HTTP port, IP address and UDP port in the "running.txt" file. Go to the mbs folder.

    Example: /Applications/AhsayOBM.app/mbs.

    mbs

    If the "running.txt" file does not exist, then the MBS is not running. Restart the AhsayOBM services.

    After opening the file, it will show the HTTP port, IP address and UDP port which are in actual use by the MBS.

    actual

  2. Open the Terminal and check if the IP address captured in the running.txt file is the correct IP address of the machine where AhsayOBM is installed.

    running

  3. To verify the actual HTTP port used by MBS, type in this command:

    netstat -vanp tcp \| grep 5400

    netstat

  4. To perform a status check on the MBS. Open a browser on the AhsayOBM machine and type the IP address, followed by the TCP port.

    For example: If the HTTP port used is 54000, http://10.16.50.33:54000, you should get the following result which shows "Running" status. This means the MBS is running.

    status

  5. To run a connection test between the mobile device and machine open a browser in your mobile device and type the IP address followed by the TCP port.

    For example: IF the HTTP port used is 54000, http://10.16.50.33:54000, you should get the following result showing "Running" status. This means the Ahsay Mobile app can successfully connect to the MBS and both backup and restore can proceed on the mobile device.

    device