FAST/TOOLS Redundancy Debugging Tips

Xybernetics FAST/TOOLS RedundancyHAC processes
Here are check you can do to verify orderly working of the FAST/TOOLS HMI redundancy.

Below are the processes that needs to be running, in particularly “hacmirslv” process is running. The “hacmirslv” process stops mirroring/archiving the file if there is not enough disk space.

Xybernetics FAST/TOOLS Redundancy

If your “hacmirslv” process is not running, do the following steps.

1) In the “C:\Program Files (x86)\Yokogawa\FAST TOOLS\tls\com” folder, create a “aaa.cmd” file (any filename but must be a “.cmd” file)
2) Enter the following command

start /B /NORMAL %TLS_ROOT_PATH%\tls\exe\hacmirslv.exe -n hacmirslv > nul

3) Open command prompt and running the following command.

“C:\Program Files (x86)\Yokogawa\FAST TOOLS\tls\com\ft_service.cmd” aaa.cmd

This command will create a “fast_command.cmd” file and which will be executed every 2 seconds.
This execution of the file will start the hacmirslv from the service level.
This is the content of the “ft_service.cmd” file.

@echo off
echo exec %1 %2 %3 %4 %5 > %TLS_ALLUSERS_PATH%\fast_command.cmd
echo %1 submitted to FAST/TOOLS service

Check SAV, ITM and HIS directory

Check and ensure that files in the following folders are available.

DAT folder

– C:\Users\Public\Yokogawa\tls\dat
– Ensure that “*.d01”, “*.dat” and “*.k01” files are in the directory.
– If files are missing copy the whole directory from your backup or your active server and move it to the backup server.

HIS folder

– C:\Users\Public\Yokogawa\tls\his
– Ensure that all history files are there.
– If files are missing copy the whole directory from your backup or your active server and move it to the backup server.

SAV Folder

– C:\Users\Public\Yokogawa\tls\sav
– Ensure that “*.d01”, “*.dat” and “*.k01” files are in the directory.
– If files are missing copy the whole directory from your backup or your active server and move it to the backup server.

Third party database connection

As part of the redundancy function, the active server transfers the RDBM coupling file (“dbcd_out” found in “C:\Users\Public\Yokogawa\tls\sav” directory) to the backup server (as a renamed file). And upon completion of transferring, it deletes the existing file and renames the recently transferred file to “dbcd_out”

This is only done during the first synchronizing stages (when the backup server comes to existance).

If you have a third party database client (which accesses the “dbcd_out” file) for FAST/TOOLS data, this connection locks the RDBM coupling file for the duration when it is using it, which will prevent the database synchronizing to occur (transfer->delete old file->rename new file).

This can prevent the redundancy process to complete database synchronizing function and some times causes the servers to toggle between synchronized and unsynchronized state.

Xybernetics FAST/TOOLS Redundancy

This can be rectified by disabling/stopping the third party database connection client when the the active and standby server is synchronizing.

NOTE : How do you tell if the active-standby server is synchronizing

Look into the FAST/TOOL “lst” folder (in “C:\User\Public\Yokogawa\tls\lst”). When it is synchronizing, the following files should be copying.

– hacm_backup_dat.zip
– hacm_backup_hist.zip
– hacm_backup_hlp.zip
– hacm_backup_sav.zip
– hacm_backup_sup.zip

Also, note that in the same directory, there will be a file called “hacm_backup_####” indicating status of the transfer. If all goes well, you should end up with a “hacm_backup_ok” files.

Xybernetics FAST/TOOLS Redundancy