SafeKit 7 – Knowledge Base

Known Problems, Restrictions or Changes

List of Items for main SafeKit Releases

List of Items ordered by Id

Id : SK-0001
OS / Release : Linux / All (For SafeKit 7.0.8 see SK-0021 )
Problem : File replication doesn't work if there is a mount point under the replicated directory (error “JUKEBOX”)
Mars Id : 22041
Id : SK-0002
OS / Release : Windows / All
Problem : With SQL Server 2005, SafeKit sometimes stops on primary if “Boost SQL server priority” is used
(sqlserver process uses 100% cpu and safekit stops with IOS - ReleaseINK kernel->user error)
Solution : Disable “Boost SQL server priority” (SQL Management Studio => select your server =>Properties => Processors)
Mars Id : 21956
Id : SK-0003
OS / Release : Windows 2003 64-bit kernel/ 7.0.4
Problem : “safekit kill” command doesn't work with “exit” or “exception” option
Solution : use “safekit kill” command with “terminate” option
Mars Id : 20278
Id : SK-0004
OS / Release : Solaris 10 / All
Problem : Interface checker doesn't work with SK-98xx SysKonnect adapter on Solaris 10
Solution : set <vip check = “off”> in userconfig.xml file
Mars Id : 19395
Id : SK-0005
OS / Release : Linux / All
Problem : “safekit forcestop” doesn't complete on “nfsbox” death
Solution : Reboot your system
Mars Id : 19565
Id : SK-0006
OS / Release : Linux, Solaris, Aix / All
Problem : When Oracle 10.2 is started by SafeKit, the database startup fails with “ORA-00205: error in Identifying control file,
check alert log for more info” error.
Solution : set <rfs packetsize=”32768”> in userconfig.xml file and use SafeKit >= 7.0.1.15
Mars Id : 21552
Id : SK-0007
OS / Release : All / All
Problem : “quick configure” doesn't work for an application module built with SafeKit 6.2
Solution : Save the file “<SAFE>/modules/AM/web/htmllib.lua” (AM is your application module) and replace it with
“web/htmllib.lua” file from a SafeKit 7.0 application module. If “quick configure” doesn't still work, update the file “<SAFE>/modules/AM/web/index.lua”
according to the functions defined in “web/htmllib.lua”.
Mars Id : 22025
Id : SK-0008
OS / Release : All / 7.0.1
Problem : After a migration from SafeKit 6.2 to SafeKit 7.0 (< 7.0.1.21), SafeMonitor fails to add a new server to administer and returns the "received error: forbIdden" message. The problem is that SafeMonitor 7.0 tries to work with a “httpd.conf file” coming from SafeKit 6.2 installation and not compatible.
Solution : Replace “httpd.conf” file (under <SAFE>/web/conf) with “httpd.conf.default” file.
Other solution : Uninstall SafeKit 7.0. Remove the <SAFE>/web directory and re-install SafeKit 7.0.
Fix : Fixed in SafeKit >= 7.0.1.21
Id : SK-0009
OS / Release : Windows / All
Problem : File attributes replication : file encryption and file compression are not supported
Mars Id : 20912-20913
Id : SK-0010
OS / Release : Linux / from 7.0.4
Restriction : Replicated directory can not be a a root of a file system when mountover=”off” (mandatory on Linux)See SK-0030 for a workaround
Id : SK-0011
OS / Release : Aix / from 7.0.4
Problem : The name of the process monitored by the software error detector (errd) must be the one returned by the command “ps -e -o comm”. On Aix, when the command is a symbolic link, “ps -e -o comm” returns the value of the symbolic link. Thus, you must set this value into <errd> configuration, and not the symbolic link name.
Id : SK-0012
OS / Release : Linux / from 7.0.1
Restriction : NFS server on RedHat 4 Update 3 does not support ACL. Thus acl attribute for a replicated directory can not be set to “on”.
Id : SK-0013
OS / Release : Linux / All
Problem : Interface checker doesn't work with bonding interfaces.
Id : SK-0014
OS / Release : All / from 7.0.4
Restriction : Failover of NFS mounts of replicated directories from remote NFS clients are no more supported
Id : SK-0015
OS / Release : All / from 7.0.4
Changes : Since SafeKit 7.0.4.13 new attributes for rfs configuration
Configuration sample :
<rfs checktime=”30000” reitimeout=”50” async=”second” moutover=”off” packetsize=”16384” maxnbretrans=”50” reicommit=”1000”>
- reitimeout : Set reitimeout=”nb seconds” to set timeout for reintegration requests. This is needed to avoid reintegration retransmissions on heavy load. Default value is “25”.
- async : Set async=”second” to translate synchronous writes into asynchronous writes and delaying commits, on the secondary server only. This can enhance file replication performances on Linux. Default value is “none” (no optimization).
- reicommit : in addition to the commit at the end of the copy of the file (packetsize is an other rfs attribute that defines size of read/write blocks).
  This can help to succeed reintegration of big files but slow down reintegration time. Default value is “0”.
- checktime : The nfs checker triggers an action when nfsd does'nt respond within this timeout.If not set, the default value is “15000” (ms)
- maxnbretrans : Maximum number of retransmissions on the replication network before detecting a failure : The PRIM server becomes ALONE. If not set, the default value is dynamically calculated.
Id : SK-0016
OS / Release : Solaris / from 7.0.4.18
Changes and Restriction : The SafeKit 7.0.4.18 fixes the virtual interface support on recent Solaris 10 kernels.
This version needs the "IP stack multiple instances"API level in the Solaris Kernel. Those APIs are known to be available in
the Solaris 10 update 4 Kernel version.
From 7.0.4.18 on, the VIP feature will not be available on Solaris 10 kernels that do not export the above APIs<.
The incompatibility will be detected at SafeKit config time.
This message can be seen during Safekit installation : "devfsadm: driver failed to attach: vipdrv
Warning: Driver (vipdrv) successfully added to system but failed to attach"
There is no change for Solaris 9.
Id : SK-0017
OS / Release : All / All
Changes and Restriction : SafeKit start blocks into wait state when a heartbeat with ident=”flow” is configured while there is no replication configuration (<rfs> section).
Solution : Remove the ident attribute.
Id : SK-0018
OS / Release : Linux / from 7.0.8
Problem : Red Hat > 4 freezes with file replication on heavy write load.
In that case, the system hangs but the other server from the cluster does not detect the error since network communication is still working. You have then to reboot the broken server.
Solution : The kernel freeze is a Linux bug.
You can try to the change kernel parameters as follows:
- Insert into the file /etc/sysctl.conf:
  vm.dirty_ratio=5
  vm.dirty_background_ratio=5
- Run sysctl -p
Our tests show that these settings help to solve the problem is many cases.
Id : SK-0019
OS / Release : Windows / from 7.0.8.7
Changes and Restriction : SafeKit SNMP agent (safeagent service) does not work.
Mars Id : 27387
Solution : Use SafeKit >= 7.0.8.25
Id : SK-0020
OS / Release : Windows / from 7.0.8.17
Changes : Since SafeKit 7.0.8.17 the new attribute “roflags” for rfs configuration is used to configure the behavior of file replication when a process is accessing a replicated directory on secondary.Values :
Currently, upon notification, nfsbox logs a debug message in the log, containing the pid anf fisrt characters of the executable image name of the offending process,up to 10 messages.
Id : SK-0021
OS / Release : Linux/ 7.0.8
Problem : When a replicated directory ( eg. “/Tests/Repli”) contains a mounted file-system (e.g. “/Tests/Repli/MyFileSystem”), re-integration fails with “JUKEBOX” error.
Solution : Use SafeKit >= 7.0.8.26 and apply these changes :
- Start safekit
Id : SK-0022
OS / Release : Linux / All
Problem : Correctly exported NFS mounts sometimes fail to mount with a "Permission denied" error. This error prevents SafeKit module using file replication (with <rfs>) from starting. It fails with the following error into SafeKit log:
| 2009-06-09 08:35:23:080185 | nfsboxv3 | W | Mount error: 13.
Mars Id : 32204
Solution : This is a known Linux bug, reported in RedHat Bugzilla - Bug 452415. The reason is that there is no mount of nfsd on /proc/fs/nfsd while nfs service is running. Check it by running the mount command that lists all current mounts. If the line: nfsd on /proc/fs/nfsd type nfsd (rw) is not listed, your system is broken for NFS. Adding this mount manually (by running the command: /bin/mount -t nfsd nfsd /proc/fs/nfsd) produces the correct result and NFS mounts, and thus SafeKit, become available. If you encounter this problem on Linux SafeKit server, the workaround is to insert into the SafeKit prestart user script the following lines:
is_mounted=`/bin/mount | /usr/bin/awk "\\$1 ~ /^nfsd$/ { print \\$5 }"` if [ -z "$is_mounted" ] ; then /bin/mount -t nfsd nfsd /proc/fs/nfsd fi
If you prefer, you can try to run this at init time, after nfs start and before safeadmin start, but you must check that this workaround works at boot time.
Id : SK-0023
OS / Release : All / All
Problem : How to temporarily disconnect file mirroring from one SafeKit module ?
Solution : Stop the SafeKit module and edit its configuration (userconfig.xml) in order to :
- Remove the identification of the heartbeat on the replication flow if one. For this, suppress the attribute ident=”flow” in the following heartbeat configuration sample :
  <heart> <heartbeat> <server addr="192.168.1.16"/> <server addr="192.168.1.20"/> </heartbeat> <heartbeat ident="flow"> <server addr="10.0.0.1"/> <server addr="10.0.0.2"/> </heartbeat> </heart>
- Disable file replication configuration
  For this, comment all the <rfs> tag section by inserting  (for ending comment) as shown below (warning: comments may not be nested) :
  
WARNING: when file mirroring is disabled, only one server must be running in alone state. The other server must not be started since it could run a failover with not uptodate data. You can uninstall the module on the server to ensure that is can not start (and reinstall it later).
Id : SK-0024
OS / Release : All / from 7.0.8.25
Changes : Since SafeKit 7.0.8.25, new degraded mode for rfs component
When nfsbox, the main rfs component, encounters a sever error, it now goes into degraded mode on the primary server instead of stopping. The secondary server, if one, then runs a stopstart and blocks until the other server comes back into default mode. This improve operational continuity since there is no restart or failover of the application. But in degraded mode, file mirroring and high availability is no more provided. The alone degraded server must be restarted as primary to come back into default mode. This is a manual operation that must be ran by the administrator (stop-prim or stopstart via SafeMonitor or safekit command) when it knows that stopping the application is not critical. The other server will then run data synchronization and become secondary.
You can read server state to get its mode (state via SafeMonitor or safekit command). For instance, the following shows the state of a server in degraded mode (ALONE state and up value for resource rfs.degraded):

--------------------- mirror State --------------------- Local (127.0.0.1) : ALONE (Service : Available) Resources Name State Since heartbeat.0 up 2009-07-23 08:22:32 heartbeat.flow up 2009-07-23 08:22:32 rfs.uptodate up 2009-07-23 08:22:37 rfs.lastprimstate down 2009-07-23 08:22:37 rfs.swapping down 2009-07-23 08:22:32 rfs.degraded up 2009-07-23
Id : SK-0025
OS / Release : All/from 7.0.8
Restriction : Rename of directory between replicated and not replicated trees are not supported
This restriction applies only when you configure not replicated directories into <rfs> tag. For instance:
<rfs> <replicated dir="/repdir" mode="read_only"> <notreplicated path="notrepdir" /> </replicated> </rfs>
Rename of files between replicated and not replicated trees are supported. For instance, the operations below are allowed:
mv /repdir/file /repdir/notrepdir mv /repdir/notrepdir/file /repdir

But, rename of directories between replicated and not replicated trees may lead to secondary stop-start and/or to degraded mode (cf Mars 34165, 63859 and 63864). For instance, the operations below are not supported:
mv /repdir/dir /repdir/notrepdir mv /repdir/notrepdir/dir /repdir
Id : SK-0026
OS / Release : All/Since 7.0.9.17
Change : Add user scripts argument
This argument can be used for instance to send an e-mail on module start and stop.
- While transiting from STOP to WAIT
  
  During this transition, the scripts transition and prestart are called in the following manner:
  
  transition STOP WAIT [ start | stopstart | stopwait ]
  prestart STOP WAIT [ start | stopstart ]
  
  STOP and WAIT arguments are for the current and next states.
  
  start argument is set on module start (with safekit start | prim | second).
  
  stopstart argument is set on module stop-start (with safekit stopstart either called by the user or a checker).
  
  stopwait argument is set on module stop-start for waiting a resource (wait rules of the failover machine). But only the transition user script is called in that case.
- transiting from WAIT to STOP
  
  During this transition, the scripts poststop and transition are called in the following manner:
  
  poststop WAIT STOP [ stop | stopstart ]
  transition WAIT STOP [ stop | stopstart | stopwait ]
  
  WAIT and STOP arguments are for the current and next states.
  
  stop argument is set on module stop. That is a stop that is not followed by an automatinc start.
  
  stopstart argument is set on module stop-start (with safekit stopstart either called by the user or a checker).
  
  stopwait argument is set on module stop-start for waiting a resource (wait rules of the failover machine). But only the transition user script is called in that case.
Id : SK-0027
OS / Release : Solaris 10/ releases < 7.0.4.18
Problem : The OS does not start after reboot
Solution : You have to remove the vip kernel module load so as to be able to start your system. For this, follow the procedure below:
- boot on Solaris CD-ROM
- remove in /etc/iu.ap all the lines like :bge -1 0 vipmode
- reboot from disk
This problem is fixed since SafeKit 7.0.4.18. If you can not upgrade to the last 7.0.4 or 7.0.9 release, call the Evidian Call Desk for getting a workaround.
Id : SK-0028
OS / Release : Solaris 10/ 7.0.4 and 7.0.9
Restriction : SafeKit must be installed into the "global" Solaris zone
SafeKit load-balancing and file mirroring features implies to install the package into the "global" zone.
The zonename command returns global when logged in the "global" zone.

When logged in a "non-global" zone, the SafeKit installation returns the following errors:
- Errors while intalling files in /usr such as: ERROR attribute verification of /sbin/dlstyle2ify failed Pathname does not exist
- Error on the file /etc/name_to_major: Egrep: can't open /etc/name_to_major
Id : SK-0029
OS / Release : SUSE SLES 11/ All
Problem : Modules in farm mode are unable to start because safekit vip kernel module is not allowed to load
Solution : You have to allow the loading of vip kernel module. For this, set allow_unsupported_modules to 1 in /etc/modprobe.d/unsupported-modules
Id : SK-0030
OS / Release : Linux/ From 7.0.9
Problem : The module configuration fails when a replicated directory is a mount point
Solution : Apply the following manual procedure as work around.
This article takes the example of PostgreSQL module that set as replicated directories /var/lib/pgsql/var and /var/lib/pgsql/data, which are mount points. The SafeKit module configuration fails with the error:
Error : Device or resource busy

It is the same procedure for all mounts points that must be replicated.
Detect mount points with a command line
On both nodes, check mount points with the command df -H that returns for instance:
df -H /dev/mapper/vg01-lv_pgs_var … /var/lib/pgsql/var /dev/mapper/vg02-lv_pgs_data … /var/lib/pgsql/data
/var/lib/pgsql/var and /var/lib/pgsql/data are mount points and they must be replicated for PostgreSQL. But the SafeKit module configuration command /opt/safekit/safekit config –m postgresql returns Error : Device or resource busy

What to do if a replicated directory is a mount point
- First, save the module with the two previous directories configured. You should have in /opt/safekit/modules/postgresql/userconfig.xml:
  <rfs … > <replicated dir="/var/lib/pgsql/var" mode="read_only" /> <replicated dir="/var/lib/pgsql/data" mode="read_only" /> </rfs>
- Umount /var/lib/pgsql/var and /var/lib/pgsql/data
- Run the command /opt/safekit/safekit config –m postgresql which should succeed (no errors)
- Check the symbolic links created by running the command ls -l /var/lib:
  ls -l /var/lib lrwxrwxrwx 1 root root var -> var_For_SafeKit_Replication lrwxrwxrwx 1 root root data -> data_For_SafeKit_Replication
- Edit /etc/fstab and change the two lines:
  /dev/mapper/vg01-lv_pgs_var /var/lib/pgsql/var ext4… /dev/mapper/vg02-lv_pgs_data /var/lib/pgsql/data ext4… with
  /dev/mapper/vg01-lv_pgs_var /var/lib/pgsql/var_For_SafeKit_Replication ext4… /dev/mapper/vg02-lv_pgs_data /var/lib/pgsql/data_For_SafeKit_Replication ext4..
- Mount the file systems by running the commands mount /var/lib/pgsql/var_For_SafeKit_Replication and mount /var/lib/pgsql/data_For_SafeKit_Replication
Apply this procedure on both nodes if replicated directories are mount point on both nodes.
After this procedure, you can use SafeKit as usual: ie safekit start stop etc ...
Note
To protect the start of SafeKit on a non-mounted and empty directory, you can insert in userconfig.xml the checking of a file inside the replicated directory. Example for var/ (do the same for data/ with a file inside this directory which is always present):
```
	
<replicated dir="/var/lib/pgsql/var" mode="read_only">
    <tocheck path="postgresql.conf" />
</replicated>
```
What to do for de-configuring the module (or uninstall whole SafeKit)
If you want to deconfigure the module (or uninstall whole safekit), you must reverse this procedure by:
- Umount the file systems with umount /var/lib/pgsql/var_For_SafeKit_Replication and umount /var/lib/pgsql/data_For_SafeKit_Replication
- De-configure the module with /opt/safekit/safekit deconfig -m postgresql
- Edit /etc/fstab to undo previous editing
- Mount the file systems with mount /var/lib/pgsql/var and mount /var/lib/pgsql/data
Id : SK-0031
OS / Release : Aix / Since 7.0.9.31
Change : Enable setting of environment variables prior to nfsbox startup

For this, add the nfsboxenv file into /opt/safekit/AM/bin (where AM is the name of your application module) and apply the new configuration. This file contains one line for each environment variable to be exported. For instance, add the following line if your system is running out of paging space because of nfsbox virtual memory requirements:
MALLOCOPTIONS=disclaim
This permit to return to the operating system, the part of the pages in nfsbox virtual address space that are no longer needed.
Id : SK-0032
OS / Release : Windows 2003 / Since 7.0.10.8
Problem : Module using <virtual_interface> (such as farm), does not start
The module is configured with a virtual IP address on a <virtual_interface> and the configuration succeeded. But, the module start fails and the log contains a line saying vipplug loading failed.
Solution : In Windows 2003, after the module configuration, you have to access the corresponding network interface's property sheet (the one onto which the new virtual IP address will be added) and click OK to validate the vip driver binding. Then, the module should start. On further references to the same network interface (by the same module or others modules), the above procedure is not needed.
In previous releases, vip driver binding was done during SafeKit install on all network interfaces. Since 7.0.10, vip driver binding are activated on demand at configuration time only on network interfaces that needs vip driver. This avoid configuration problems on platforms using software vlans on other network interfaces.
In Windows 2008, the above procedure is not needed.
Id : SK-0033
OS / Release : All / All
Problem : SafeKit servers can not communicate when the firewall is on

When firewall is turned on, you have to configure the firewall to allow connections on SafeKit module ports. The list of used ports is returned by the command: safekit module getports –m AM
Id : SK-0034
OS / Release : Red Hat Enterprise Linux 6 / Since 7.0.10.23
Problem : If NetworkManager is used to manage network interfaces, SafeKit , can't work properly in case of network failure :
When a network cable is unplugged the network interface is unconfigured , and a module using <virtual_interface>, fails with error : “vipplug config error: Can't get interface for address ...Error: environment modification need re-configuration” When the cable is plugged again, SafeKit module start fails, and we have to run “safekit config” again.
Problems can occur too with a module using <real_interface>.

OS / Release : Red Hat Enterprise Linux 6 / 7.1.3
Problem : If NetworkManager is used to manage network interfaces :
When a network cable is unplugged the network interface is unconfigured , and a module mirror using <real_interface>, loops with errors : "nfsboxv3 Internal error: bind failed (99) and heart bind error 99"

Solution : Stop NetworkManager and use system-config-network to configure network interfaces :
On your server run :
And run : system-config-network to manage your network interfaces.
Id : SK-0035
OS / Release : Red Hat Enterprise Linux / Since 7.0.11
How to : Enable Oracle Direct NFS with SafeKit file mirroring

Since SafeKit 7.0.11, you can configure SafeKit file mirroring with Oracle 11g Direct NFS.
You have first to configure oracle for Direct NFS while SafeKit and Oracle are stopped. For this refer to the Oracle documentation . It consists in changing the ODM library by running:
cd $ORACLE_HOME/lib cp libodm11.so libodm11.so_stub ln –s libnfsodm11.so libodm11.so
Then you can start Oracle and check that Direct NFS is enabled. Oracle records the use of Direct NFS in alert.log and also in internal catalog v$dnfs tables. For instance, you can check the table of servers accessed using Direct NFS by running:
su - oracle sqlplus system (login) system (password) select * from v$dnfs_servers;
When Oracle is properly configured for Direct NFS, you can configure SafeKit file mirroring for enabling Oracle NFS connections with SafeKit nfsbox process. Edit the module configuration file userconfig.xml and insert into the <rfs> tag the attribute: pmapset="on". This option can be applied only on one module. Then apply the new configuration and start the module. You can check that Oracle uses Direct NFS and connects to the nfsbox port instead of the default standard nfsd port 2049. The nfsbox port is the nfs_port listed by the command safekit module getports -m AM. For checking connections, read the alert.log and v$dnfs tables. You can also run the command lsof -Pnl +M -i4 (for IPv4) or lsof -Pnl +M -i6 (for IPv6) that lists all processes connections. You should have oracle processes that connects to nfs_port.
To roll back to the standard Oracle configuration, stops the module, reconfigure it with the attribute: pmapset="on" removed and revert Oracle configuration for Direct NFS.
Id : SK-0036
OS / Release : All / 7.0.11
Problem : Problems in WebConsole with I9 updates.
Mars Id : 46316,46365
Id : SK-0037
OS / Release : All / 7.0.11
Problem : Unable to configure virtual_addr in mirror mode
Solution : Add the following section to the configuration file (userconfig.xml) :
<farm> <lan> <node name="node" addr="127.0.0.1"/> </lan> </farm>
Id : SK-0038
OS / Release : All / Since 7.1
Change : mailsend binary no more delivered with the SafeKit package

Since 7.1 release, mailsend is no more delivered with the SafeKit package.
For Windows, you can download windows binary from the mailsend download area.
For Unix, you can use the mail command instead of mailsend. For instance, the following line, inserted in poststop script of a module, notifies about the stop of the module:
echo "Running poststop" | mail -s "Stop module $SAFEMODULE on `hostname`" admin@mydomain.com
where "Running poststop" is the mail's body and "Stop module $SAFEMODULE on `hostname`" is the mail's subject.
Id : SK-0039
OS / Release : All / Since 7.0.9
How to : Disable SSL 2 protocol into the SafeKit web server configuration

To disable insecure protocols like SSL 2.0 and weak ciphers:
- Edit the file SAFE/web/conf/httpd.ssl.conf
  - comment the line:
    SSLCipherSuite ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP:+eNULL
  - add lines:
    SSLProtocol -ALL +SSLv3 +TLSv1 SSLCipherSuite ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:!LOW:!SSLv2:!EXPORT
- Restart the SafeKit web server with:
  safekit webserver stop sync safekit webserver start sync
Id : SK-0040
OS / Release : Linux / Since 7.1.0.8
Problem : Address IP conflict loadbalancing problems can occur if the virtual IP address is an IPv6 address (restriction).
Solution : fixed in SafeKit > 7.1.1.0
Mars Id : 48110
Id : SK-0041
OS / Release : All / Since 7.1.2
Problem : SafeKit Web console and Internet Explorer 8
The SafeKit web console may not be correctly displayed in IE 8 and returns "xml parse" errors.
Solution : Set the checkbox "Enable (not secure)" for "Initialize and script ActiveX controls not marked as safe for scripting (not secure)" into the "Security Settings" panel of the Internet Zone
Warning: IE8 is no more supported since SafeKit 7.1.3
Id : SK-0042
OS / Release : All / Since 7.1
How to : Configure a farm module with the spread communication protocol that it is replaced since SafeKit 7.1 by a proprietary protocol.
Solution :The following is an extract of a farm configuration file userconfig.xml, set to use the spread protocol. Beware that in this case, the type for the virtual interface must be set to "vmac_invisible".
<farm spread="on"> <lan> <node name="node1" addr="192.168.208.5"/> <node name="node2" addr="192.168.208.6"/> </lan> </farm> <vip> <interface_list> <interface arpreroute="off" check="off"> <virtual_interface type="vmac_invisible"> <virtual_addr addr="192.168.208.56" where="alias"/> </virtual_interface> </interface> </interface_list> <loadbalancing_list> <group name="FarmProto">  <rule filter="on_port" proto="tcp" port="9000"/> </group> </loadbalancing_list> </vip>
Id : SK-0043
OS / Release : All / Since 7.1
How to : Configure a mirror module with a virtual IP address mapped on a virtual MAC address.
Solution :The following is an extract of a mirror configuration file userconfig.xml, set to user a virtual IP address mapped on a virtual MAC address. Beware that in this case, the type for the virtual interface must be set to "vmac_invisible". The loadbalancing rule is a mandatory configuration option when defining a virtual MAC address but all the trafic goes to the primary server.
<vip> <interface_list> <interface check="on"> <virtual_interface type="vmac_invisible"> <virtual_addr addr="192.168.208.56" check="off" where="one_side_alias"/> </virtual_interface> </interface> </interface_list> <loadbalancing_list> <group name="mirrorgrp"> <rule filter="on_addr" proto="tcp" port="*"/> </group> </loadbalancing_list> </vip> <farm> <lan> <node name="node1" addr="127.0.0.1"/> </lan> </farm>
Id : SK-0044
OS / Release : All / 7.1.1
Errata : Use a third machine as spare for a mirror module (User's guide section 5.10))
- The module deployement on the three machines will result in a configuration error on the spare machine (The one that will not have a localy defined address). This error will be fixed in future SafeKit version. However the deployement on the three machines is still necessary.
- Before starting the spare machine, the safekit config command must be issued on this machine.
Id : SK-0045
OS / Release : Aix / 7.1.1.7
Problem : Replication and reintegration performance
Solution : To improve write file performance during replication and reintegration, edit the configuration file userconfig.xml and insert the attribute mountopt="hard,combehind" for each <replicated> tags. See AIX documentation.
Id : SK-0046
OS / Release : All / Since 7.1.1
Problem : Web console problems after SafeKit upgrade
Solution : You have to clear your browser's cache so as to get the new web console pages. A quick way to do this is a keyboard shortcut that works on IE, Firefox, and Chrome. Open the browser to any web page and hold CTRL and SHIFT while tapping the DELETE key. (This is NOT CTRL, ALT, DEL). The dialog box will open to clear the browser. Set it to clear everything and click Clear Now or Delete at the bottom. Close the browser, stop the process still running in the background if necessary, and re-open it fresh to test what wasn't working for you previously.
Id : SK-0047
OS / Release : All / Since 7.1.2
Problem : Interface checker "intf" attribute and "-I" parameter are deprecated
Solution : If the "intf" attribute is specified in the configuration file userconfig.xml, it is ignored and a message of level "D" "Deprecated argument -I" is emitted at runtime. If the interface checker process intfcheck.exe is started at the command line with the extra argument "-I", eg : safekit -r intfcheck <module> <resourcename> -A none -l <ipaddress> -I <interfacename>, the -I argument is ignored and a message of level "D" "Deprecated argument -I" is emitted at runtime.
Id : SK-0048
OS / Release : All / Since 7.1.3 and < 7.1.3.5
How to : How to administer with the web console modules installed before securing SafeKit servers (with https)
You have secured the SafeKit Web Console with https (see SafeKit User's Guide).
If modules have been installed before securing SafeKit servers, you have to deploy them again to change the administration network URL to protocol https and port 9453 :
Warning : If you connect the web console to an another secured server https://anotherservername:9453, you have to repeat the procedure described in (3).
If you prefer, you can instead modify the "servers.xml" file under Application_Modules/webconsole folder and reload the web console.

From SafeKit 7.1.3.5 when connecting to "https://servername:9453", the web console automatically switches to secured url.
Id : SK-0049
OS / Release : All / Since 7.0
Problem : Web Console secured with https: Problem using literal IPv6 address
If you use https://[lIPV6]:9453/ or http://[IPV6]:9010/ where IPV6 is a literal IPv6 address, the connection fails "Internet Explorer cannot display the webpage"
See : Apache-Bugzilla-Bug 52831
Solution : connect with https://[lIPV6]:9453/deploy.html, https://[lIPV6]:9453/monitor.html ... will work. Or don't use literal addresses for IPv6.
Mars Id : 44424
Id : SK-0050
OS / Release : Windows / Since 7.1.2.18
Problem : Process monitoring fails when the process name contains uppercase letters
The User's Guide recommends to use the command safekit -r errdpoll_running to get the name of running processes. The displayed name can be used to configure the process monitoring into the <errd> section of the configuration file userconfig.xml. Since SafeKit 7.1.2.18, the displayed name is case sensitive while it should be in lower case. The reason is that the process name comparison for the process monitoring is not case sensitive.
Solution : When defining a process monitoring into the <errd> section of userconfig.xml, the value of the attribute name for <proc> must in lower case. If not, the process name matching will fail.
Mars Id : 53612
Fix : In SafeKit > 7.1.3.6:
Id : SK-0051
OS / Release : All / Since 7.1
Problem : The animated progress bar is not diplayed into the web console with IE11
Solution : Follow the options below and check:
Id : SK-0052
OS / Release : All / Since 7.1
Problem : safekit modules fail to start at boot when safeagent is set to automatic start
Solution : Follow the procedure below
Id : SK-0053
OS / Release : Windows / 7.1
Problem : LPR server : connections on Virtual IP don't work
Mars Id : 54939
Fix : From SafeKit 7.1.3.15 : Follow the procedure below
Id : SK-0054
OS / Release : All/7.1.3
Problem : When setting the resource state in a custom checker, it logs a message in the module log even if the resource state did not changed
Mars Id : 56903
Solution : Edit your custom checker for running the command setting the resource state only if the state has changed

Id : SK-0055
OS / Release : All / 7.1.3
How to : force a not up-to-date server to automatically start as primary when the up-to-date server is not running ?

Default behaviour: if a secondary server looses contact with the primary server, it is considered as not up-to-date and it will never be able to start as primary except on administrator command.

Wanted behaviour: the data does not need to be strongly synchronized, and a secondary server can become primary if the up-to-date server is not responding. The data may be not up-to-date, but consistent.

Restriction: starting as primary is forbidden if the module was stopped during reintegration since data may not be consistent.

Solution: When all the heartbeats from the up-to-date server are lost and the up-to-date server is not responding to ping requests, the not up-to-date server can failover or start as primary.
Warning: You may use this solution only if you don't care loosing some modifications of the replicated data.

Edit the configuration file SAFE/modules/AM/conf/userconfig.xml to insert a new failover rule and custom checkers
<check>  <custom ident="pingremote" when="pre" exec="ping_remote" arg="10"/>   <custom ident="synced" when="pre" exec="syncedcheck" arg="30 10"/> </check> <failover> <![CDATA[ force_uptodate: if (heartbeat.* == down && custom.pingremote == down && custom.synced == up && rfs.uptodate == down) then rfs.uptodate=up; ]]> </failover>

Add the ping_remote checker into SAFE/modules/AM/bin/
This checker checks that the remote server is responding. It sets the resource custom.pingremote to up if responding, to down if not responding.
[Show Unix script] [Hide Unix script]
File SAFE/modules/AM/bin/ping_remote

#!/bin/sh
# This script is a UNIX script
# Make an infinite loop with periodic wake up
# $1 = module name (AM)
# $2 = custom checker name
# $3 = sleep interval between 2 checks
module_name=$1
custom_name=$2
sleep_period=$3

#Get list of remote server heartbeats
addr_list=
nbfl=(`$SAFE/safekit -r saferpc_send heart GETINTF`)
fl=0
while [ $fl -lt ${nbfl[1]} ]
 do
  remote_addr=`$SAFE/safekit -r saferpc_send heart GETNAME 1 $fl`
  if [ -z "$addr_list" ] ; then
        addr_list="-r $remote_addr"
  else
        addr_list="$addr_list -r $remote_addr"
  fi
  ((fl+=2))
done

#Ping remote server
testRemote()
{
 res=1
 if [ -z "$addr_list" ] ; then
	res=0
 else
   pingres=`$SAFEBIN/pingcheck $module_name custom.test -A none $addr_list`
   if [ "$pingres" = "up" ] ; then
	res=0
   else
	res=1
   fi
 fi
 return $res
}

status=2
while true
do
  testRemote
  res=$?
  if [ $res -ne $status ] ; then
    status=$res
    if [ $status -eq 0 ] ; then
    	$SAFE/safekit set -r $custom_name -v up -i ping_remote
    else
    	$SAFE/safekit set -r $custom_name -v down -i ping_remote
    fi
  fi
  sleep $sleep_period
done

[Show Windows script] [Hide Windows script]
File SAFE/modules/AM/bin/ping_remote.vbs

'==================================================
' VBScript source code
'==================================================
'
' $1 = module name (AM)
' $2 = custom checker name
' $3 = sleep period
'==================================================

On Error Resume Next

Dim arguments,res, cmdres
Dim WshShell, objEnv,FSO, status, module_name, custom_name, sleep_period
Dim SAFE, SAFEBIN,SAFEUSERVAR

Const ForReading = 1
Const AsAscii = 0

Set FSO    = CreateObject("Scripting.FileSystemObject")

' Get the WshShell object.
Set WshShell = CreateObject("WScript.Shell")

' Get the Environment.
Set objEnv = WshShell.Environment("Process")
SAFEUSERVAR = objEnv("SAFEUSERVAR")
If (len(SAFEUSERVAR) = 0) Then
  WScript.Echo("Miss SAFEUSERVAR")
  WScript.quit(1)
End if

SAFE = objEnv("SAFE")
If (len(SAFE) = 0) Then
  WScript.echo("Miss SAFE")
  WScript.quit(-1)
End if

SAFEBIN = objEnv("SAFEBIN")
If (len(SAFEBIN) = 0) Then
  WScript.echo("Miss SAFEBIN")
  WScript.quit(-1)
End if

' Get argument

Set arguments=WScript.Arguments

If arguments.count < 3 Then 
  WScript.Echo("Miss arguments")
  WScript.quit(-1)
End If

module_name=arguments(0)
custom_name=arguments(1)
sleep_period=CInt(arguments(2))*1000 'in ms

status=2
Do while True
	' Test remote server 
	res=testRemote()
	If res <> status Then
	  If res = 0 Then
  		' remote is responding
        setPingremote("UP")
	  Else
  		' remote is not responding
        setPingremote("DOWN")   
	  End If
      status=res
    End If
	WScript.Sleep(sleep_period)    
Loop

WScript.quit(0)

Sub setPingremote(status)
  Dim cmdres, command
  If status = "UP" Then
    command=SAFE & "\safekit set -r " & custom_name & " -v up -i ping_remote"
    cmdres=RunCommand(command,False)
  Else
    command=SAFE & "\safekit set -r " & custom_name & " -v down -i ping_remote"
    cmdres=RunCommand(command,False)
  End If 
End Sub

'==================================================
Function safekitheartrpc(argExp) 
	Dim execstr 
	execstr = SAFE & "\safekit -r saferpc_send heart " & argExp
	safekitheartrpc = RunCommand(execstr, True)
End Function


' Test if remote server defined into heartbeat configuration reply to ping
' return 0 if one reply
' return 1 if none reply
Function testRemote()
  Dim res,pingres
  Dim resintf,nbflux,remote_addr,i
  res=1
  resintf=safekitheartrpc("GETINTF")
  If resintf <> "" Then
	nbflux=split(resintf," ",-1,1)
    If (nbflux(1)>=1) Then
      For i=0 to nbflux(1)-1 step 2
      ' Get addr for the remote server
	   remote_addr=safekitheartrpc("GETNAME 1 " & i)
	   If remote_addr <> "" Then
       ' Ping the remote server
	        pingres=ping(remote_addr)
	        If pingres = 0 Then
		       res=0
		       Exit For
	        End If
	   End If
      Next
    End If
  End If
  
  testRemote=res
End Function

'==================================================
' Ping addr. Change nbpings and timeout if necessary
'
' return 0 on success
' return 1 on error
Function ping(addr)
  Dim res,command

  command=SAFEBIN & "\pingcheck.exe " & module_name & " custom.test -A none -r " & addr
  res=RunCommand(command,False)
  ping=res
End Function

Function RunCommand(ExecString,Output)
	Dim stdstream,RunCommandOutput,Content,return

	if (Output=True) Then
	  RunCommandOutput = SAFEUSERVAR & "\pingremote.tmp"
	  return = WshShell.Run("cmd.exe /C " & ExecString & " >" & RunCommandOutput , 0 , True)
	  CheckError(ExecString)	  
	  Set stdstream = FSO.OpenTextFile(RunCommandOutput,ForReading,AsAscii)
	  While not stdstream.AtEndOfStream
	    if (len(Content) <> 0) Then
   		  Content=Content & VbCrLf	    
	    End if 
   		Content=Content & stdstream.ReadLine
   	  Wend
	  stdstream.Close
	  FSO.DeleteFile(RunCommandOutput)
	  RunCommand = Content
	Else
	  return = WshShell.Run(ExecString , 0 , True)
	  CheckError(ExecString)	  
	  RunCommand = return
	End If
End Function

Sub CheckError(str)
	Dim message
	if Err <> 0 Then
		message = str & " " & Err.Source & " " & Hex(Err) & ": " & Err.Description
		WScript.echo(message)
'		WScript.quit(3)
	end if
End Sub

Sub logMesg(mesg)
   command=SAFE & "\safekit printi " & mesg
   cmdres=RunCommand(command,False)
End Sub

Add the syncedcheck checker into SAFE/modules/AM/bin/
This checker checks the elapsed time since the replicated data has been synchronised on both servers. It sets the resource custom.synced to up if the data is up-to-date or not up-to-date but it was synchronised elpasedtime minutes ago. The value for elpasedtime is the 2nd value of the attribute arg in the custom checker configuration: <custom ident="synced" when="pre" exec="syncedcheck" arg="30 10">
Ask to Evidian support for getting the syncedcheck binary.

Id : SK-0056
OS / Release : All/7.1.3
Problem : Incompatible configuration options <interface arpreroute="on" and <virtual_interface type="vmac_invisible"
Mars Id : 57173
Solution :
Id : SK-0057
OS / Release : Linux RH5 and RH6 / 7.1
How to : Use of RedHat httpd server instead of the SafeKit httpd server
Solution :
- Install RedHat httpd server 2.2 package. If you intend to use the secured web console with HTTPS, you must have the mod_ssl and openssl packages installed in addition to the httpd package.
- Stop safewebserver : /opt/safekit/safekit webserver stop
- cd /opt/safekit/web
- mv -f lib/libcrypto* ../private/bin
- mv -f lib/libssl* ../private/bin
- mv -f lib lib.safekit
- mv -f modules modules.safekit
- ln -s /usr/lib64/httpd/modules/ modules
- Edit the /opt/safekit/web/bin/safeapachectl script : change the HTTPD variable to /usr/sbin/httpd
- Edit the /opt/safekit/web/bin/envvars file : subsitute path /opt/safekit/web/lib to /opt/safekit/private/bin everywhere it appears
- Start safewebserver : /opt/safekit/safekit webserver start

Id : SK-0058
OS / Release : All/ >= 7.1.3.16
Problem : In a farm module, how to start load-balancing once the application is started and stop load-balancing before stopping the application

Default behaviour: the load-balancing is enabled before running the user script start_both ; the load-balancing is disabled after running the user script stop_both.

Wanted behaviour: when the application start/stop takes a long time, it may be necessary to enable the load-balancing only once the application is started and to disable it before stopping the application so as to reduce the failover time.

Solution : Enable/disable the load_balancing with special commands ran into the user scripts start_both and stop_both. Find below the scripts templates.

Edit the user script SAFE/modules/AM/bin/start_both
[Show Unix script] [Hide Unix script]
File SAFE/modules/AM/bin/start_both

#!/bin/sh
# Script called on all servers for starting application


# For logging into SafeKit log use:
# $SAFE/safekit printi | printe "message" 

# stdout goes into Application log
echo "Running start_both $*" 

res=0

# must wait for vipd ready before stopping load-balancing
sleep 2
echo "Stop the load-balancing"
$SAFE/safekit -r saferpc_send -m $SAFEMODULE vipd SETGROUPS donothing donothing none

# Fill with your application start call

echo "Start the load-balancing"
$SAFE/safekit -r saferpc_send -m $SAFEMODULE vipd SETGROUPS donothing donothing all


if [ $res -ne 0 ] ; then
  $SAFE/safekit printi "start_both failed"
  
  # uncomment to stop SafeKit when critical
  # $SAFE/safekit stop -i "start_both"
fi

[Show Windows script] [Hide Windows script]
File SAFE/modules/AM/bin/start_both.cmd

@echo off

rem Script called on all servers for starting applications

rem For logging into SafeKit log use:
rem "%SAFE%\safekit" printi | printe "message"

rem stdout goes into Application log
echo "Running start_both %*" 

set res=0

rem must wait for vipd ready before stopping load-balancing 
"%SAFEBIN%\sleep" 2
echo "Stop the load-balancing"
"%SAFE%\safekit" -r saferpc_send -m %SAFEMODULE% vipd SETGROUPS donothing donothing none

rem Fill with your services start call


echo "Start the load-balancing"
%SAFE%\safekit -r saferpc_send -m %SAFEMODULE% vipd SETGROUPS donothing donothing all

if %res% == 0 goto end

:stop
set res=%errorlevel%
"%SAFE%\safekit" printe "start_both failed"
  
rem uncomment to stop SafeKit when critical
rem "%SAFE%\safekit" stop -i "start_both"

:end

Edit the user script SAFE/modules/AM/bin/stop_both
[Show Unix script] [Hide Unix script]
File SAFE/modules/AM/bin/stop_both

#!/bin/sh
# Script called on all servers for stopping application

# For logging into SafeKit log use:
# $SAFE/safekit printi | printe "message" 

#----------------------------------------------------------
#
# 2 stop modes:
#
# - graceful stop
#   call standard application stop
#
# - force stop ($1=force)
#   kill application's processes
#
#----------------------------------------------------------

# stdout goes into Application log
echo "Running stop_both $*" 

res=0

if [ $# -gt 1 ] ; then
	# stop_both not called by prestart
	echo "Stop the load-balancing"
	$SAFE/safekit -r saferpc_send -m $SAFEMODULE vipd SETGROUPS donothing donothing none
fi

# Fill with your application stop call

# default: no action on forcestop
[ "$1" = "force" ] && exit 0

[ $res -ne 0 ] && $SAFE/safekit printe "stop_both failed"

[Show Windows script] [Hide Windows script]
File SAFE/modules/AM/bin/stop_both.cmd

@echo off

rem Script called on all servers for stopping application

rem For logging into SafeKit log use:
rem "%SAFE%\safekit" printi | printe "message"

rem ----------------------------------------------------------
rem
rem 2 stop modes:
rem
rem - graceful stop
rem   call standard application stop with net stop
rem
rem - force stop (%1=force)
rem   kill application's processes
rem
rem ----------------------------------------------------------

rem stdout goes into Application log
echo "Running stop_both %*" 

set res=0

set argC=0
for %%x in (%*) do Set /A argC+=1

if %argC% gtr 1 (
	rem stop_both not called by prestart
	echo "Stop the load-balancing"
	"%SAFE%\safekit" -r saferpc_send -m %SAFEMODULE% vipd SETGROUPS donothing donothing none
) 

rem Fill with your services stop call

rem default: no action on forcestop
if "%1" == "force" goto end

rem If necessary, uncomment to wait for the stop of the services
rem "%SAFEBIN%\sleep" 10

if %res% == 0 goto end

"%SAFE%\safekit" printe "stop_both failed"

:end

Id : SK-0059
OS / Release : Windows / 7.1
How to : Use of externally built httpd server instead of the SafeKit built-in httpd server
Solution :
- Download the appropriate version of the httpd server 2.2 package x64 binaries from a source you trust, or build it yourself. For example, http://www.apachelounge.com provide x64 binaries for Windows. If you intend to use the secured web console with HTTPS, ensure that the mod_ssl and openssl packages are also delivered.
- Download and install the associated Microsoft C Runtime redistributable package
- Stop safewebserver : safekit webserver stop
- Take a copy of the SAFE/web/bin and SAFE/web/modules directories
- Copy the content of the "bin" directory from the httpd server package to the SAFE/web/bin directory
- Copy the content of the "modules" directory from the httpd server package to the SAFE/web/modules directory
- Start safewebserver : safekit webserver start
Id : SK-0060
OS / Release : Windows / 7.1.3
Problem : Checkers start failure on module start after a crash of the server
Mars Id : 57364
Solution : Apply the following manual procedure as work around.
Id : SK-0061
OS / Release : Windows 2008 and Windows 2008 R2/ All
Problem : File replication errors that may occur when an application extends a file (most notably, in write_through mode)
This problem is a part due to a misbehaviour of the Microsoft NTFS.sys filesystem driver described on the Microsoft support site at http://support.microsoft.com/kb/976538/en-us/
Fix :When using file replication, it is mandatory to update the windows OS at least at the level indicated http://support.microsoft.com/kb/976538/en-us/. The update procedure is also described in this knowledge base entry.
Id : SK-0062
OS / Release : All / 7.2
Problem : Web console: do not use literal IPv6 addresses (e.g. 3ffe:2a00:100:7031::1)
In the SafeKit 7.2 web console, you have to fill the address of the SafeKit servers for configuring the web console inventory and the SafeKit clusters. These addresses are used by the web console for connecting to servers (but IPv6 URL must be be surrounded in square brackets). The web console does not yet manage both format.
Mars Id : 59106
Solution : The work around is to use DNS names instead of literal IPv6 addresses.
Id : SK-0063
OS / Release : Windows 2008 R2/ 7.2
Problem : 3 nodes replication (3nodesrepli.safe) configuration fails
Mars Id : 59141
3nodesrepli.safe configuration relies on PowerShell scripts that require for a correct execution the change of the execution policy and the 4.0 version.
Solution :
Id : SK-0064
OS / Release : Windows 2008 R2 / 7.2
Problem : SafeKit drivers load fails when Windows 2008 R2 release does not include the support for SHA-2 signing and verification functionality
Fix : You have to update your system for including the support for SHA-2. Refer to the Microsoft Security Advisory at https://technet.microsoft.com/en-us/library/security/2949927.aspx
Id : SK-0065
OS / Release : All / 7.2
Problem : With IE11, "connection error" can occur after a time when the Webconsole is secured with https. stop and start the browser are necessary.
Solution : "Internet Options"/"Advanced"; unselect "TLS 1.0" and "TLS 1.2", select only "TLS 1.1".

Id : SK-0066
OS / Release : Windows / 7.1 and 7.2
Problem : How to configure the USN journal in Windows when namespacepolicy="3" in <rfs> tag
Solution : In Windows, to enable zone reintegration after reboot when the module has been properly stopped, rfs component use the NTFS USN change journal to check that saved information on zones are still valid after reboot. When the check succeeds, zone reintegration can be applied on the file; otherwise, full reintegration must be used. To enable the use of USN change journal, set namespacepolicy="3" in <rfs> tag.

By default, an NTFS volume will have its USN journal active only the system drive. If the replicated directories are located on a drive different from the system drive, you have to explicitly activate the journal.
Run the following command, as an administrator, to check that the USN journal is enabled on your drive:
fsutil usn queryjournal D: (replace D: with the desired drive).
If the command returns "Error: The volume change journal is not active", run the following command, as an administrator, to create the USN journal:
fsutil usn createjournal m=536870912 a=67108864 D: (replace D: with the desired drive) ; where m, for maximum size, specifies the maximum size, in bytes, that NTFS allocates for the change journal and a, for allocation delta, specifies the size, in bytes, of memory allocation that is added to the end and removed from the beginning of the change journal.
See SK-0067 before starting the module after the USN journal creation.

The default USN journal maximum size is 512 MB. If your volume contains 400,000 files or fewer, no additional configuration is required. For every 100,000 additional files on a volume containing replicated directories, increase the USN journal size by 128 MB. If files on the volume are changed or renamed frequently (regardless of whether they are part of the replica set), consider sizing the USN journal larger than these recommendations to prevent USN journal wraps, which can occur when large numbers of files change so quickly that the USN journal must discard the oldest changes to stay within the specified size limit.

The table below includes the various figures needed to create the USN journal to different amounts.

Number of files

m
maximum size in bytes

a
allocation delta in bytes

m
in MB

400 000 536 870 912 67 108 864 512

600 000 805 306 368 100 663 296 768

800 000 1 073 741 824 134 217 728 1 024

1 000 000 1 342 177 280 167 772 160 1 280

1 200 000 1 610 612 736 201 326 592 1 536

1 400 000 1 879 048 192 234 881 024 1 792

1 600 000 2 147 483 648 268 435 456 2 048

1 800 000 2 415 919 104 301 989 888 2 304

2 000 000 2 684 354 560 335 544 320 2 560

2 200 000 2 952 790 016 369 098 752 2 816

2 400 000 3 221 225 472 402 653 184 3 072

2 600 000 3 489 660 928 436 207 616 3 328

2 800 000 3 758 096 384 469 762 048 3 584

3 000 000 4 026 531 840 503 316 480 3 840

3 200 000 4 294 967 296 536 870 912 4 096

Id : SK-0067
OS / Release : Windows / 7.1 and 7.2
Problem : The start of the module hangs into the WAIT(magenta) state after creating the USN journal on the drive containing the replicated directories
The start of the module hangs into the WAIT(magenta) state with the following messages into the log of the module: | 2017-02-23 09:05:58:454000 | nfsboxv3 | D | Directory D:\: Filesystem=NTFS (flags 3e700ff), Volume=Data | 2017-02-23 09:06:00:302000 | rfsplug | D | Retrying nfsbox port lookup | 2017-02-23 09:06:00:302000 | rfsplug | D | Waiting for nfsbox ready | 2017-02-23 09:06:00:303000 | log | D | Last message repeated 2 times | 2017-02-23 09:06:00:333000 | nfsadmin | D | Retrying nfsbox port lookup | 2017-02-23 09:06:00:333000 | nfsadmin | D | Waiting for nfsbox initialization
This occurs when the USN journal has just been created on the drive containing the replicated directories and no access has yet be done on the drive.
Solution :After creating the USN journal and before starting the module, run any modification on the drive so as to fill the USN journal. For instance, you can create then delete a file.
Id : SK-0068
OS / Release : Windows / 7.2
How to : Use of externally built httpd server instead of the SafeKit built-in httpd server
Solution :
- Download the appropriate version of the httpd server 2.4 package x64 binaries from a source you trust, or build it yourself. For example, http://www.apachelounge.com provide x64 binaries for Windows. If you intend to use the secured web console with HTTPS, ensure that the mod_ssl and openssl packages are also delivered.
- Download and install the associated Microsoft C Runtime redistributable package
- Stop safewebserver : safekit webserver stop
- Take a copy of the SAFE/web/bin and SAFE/web/modules directories
- Copy the content of the "bin" directory from the httpd server package to the SAFE/web/bin directory
- Copy the content of the "modules" directory from the httpd server package to the SAFE/web/modules directory
- Start safewebserver : safekit webserver start
Id : SK-0069
OS / Release : Linux / > 7.2.0.29
How to : Use of Linux httpd server instead of the SafeKit httpd server
Solution :
- Install httpd server 2.4 package. If you intend to use the secured web console with HTTPS, you must have the mod_ssl and openssl packages installed in addition to the httpd package.
- Stop safewebserver : /opt/safekit/safekit webserver stop
- Edit the /opt/safekit/web/bin/safeapachectl script according to the inline comments
- Start safewebserver : /opt/safekit/safekit webserver start
Id : SK-0070
OS / Release : Linux / 7.3
How to : Use mySQL with Safekit when SELinux is "Enforcing"
Problem : The start of the module mySQL.safe fails with mysql errors:
Solution : Generate SELinux policy allow rules from logs of denied operations (tested with safekit 7.3 on RedHat 7.2):
- First deploy mySQL.safe module
- Set SELinux in Permissive mode : setenforce 0
- Execute: /sbin/service auditd rotate, to rotate the SELinux log file "/var/log/audit/audit.log"
- Execute : semodule -DB, to remove "dontaudits from policy" (log becomes more verbose)
- Start and Stop mySQL in command line : systemctl start mariadb and systemctl stop mariadb
- Start and stop mySQL.safe module (command line or safekit web console)
- Now, use "audit2allow" to build a policy module "NewMySQL.pp" from denial and the associated system call logged to /var/log/audit/audit.log:
- Set audit in initial mode: semodule -B
- Load the new policy module: semodule -i NewMySQL.pp
- Set SELinux in Enforcing mode: setenforce 1
- Start mySQL.safe module : it works !
File NewMySQL.te sample :
Remarks :

If the ".te" file is manually modified, the ".pp" file must be build again
checkmodule -M -m -o NewMySQL.mod NewMySQL.te semodule_package -o NewMySQL.pp -m NewMySQL.mod
Then reload the policy module semodule -i NewMySQL.pp .
Id : SK-0071
OS / Release : Linux / 7.3
Problem : Command "create" or "drop" on Mysql replicated database fails when SELinux is "Enforcing"
drop database MaBase; ERROR 1010 (HY000): Error dropping database (can't rmdir './MaBase', errno: 13)
or create database MaBase; ERROR ...(HY000): Error creating database (can't mkdir './MaBase', errno: 13)

Solution :

Edit your policy rules for MySQL (".te" file see SK-0070) and add rules for "create" and "rmdir" directory :

Replace the line : class dir { write remove_name getattr add_name } with : class dir { create rmdir write remove_name getattr add_name }

Replace the line : allow mysqld_t nfs_t:dir { write remove_name add_name }
with : allow mysqld_t nfs_t:dir { create rmdir write remove_name add_name }

Then compile and load the policy module :
checkmodule -M -m -o NewMySQL.mod NewMySQL.te semodule_package -o NewMySQL.pp -m NewMySQL.mod semodule -i NewMySQL.pp
Id : SK-0072
OS / Release : Linux / 7.3
How to : Set SELinux to "Permissive" mode OR set only enforcement mode for MySQL to "Permissive"
Solution :
To set SELinux in "Permissive" mode execute : setenforce 0 , to see the current mode : getenforce
To set enforcement mode to "Permissive" only for MySQL execute : semanage permissive -a mysqld_t
Id : SK-0073
OS / Release : Windows / 7.2 and < 7.3.0.14
Mars Id : 62147
Fix : Fixed in SafeKit >= 7.3.0.14
Problem : 3nodesrepli / SafeKit upgrade : After upgrade procedure, the module does not start and DR node indicator does not appear.
Workaround :
- Start the webconsole
- In the web console, go to "Configuration" tab
- Click on the module toplevel menu (the "wheel"), then on Set DR node
- Execute the steps of the "Set DR node" wizard procedure
- Start the 3nodesrepli module as usual
Id : SK-0074
OS / Release : All / All
Mars Id : 63124
Problem : With IE, the file may be truncated when loaded into the SafeKit Web console editor
Text files created on DOS/Windows machines have different line endings than files created on Unix/Linux. DOS uses carriage return and line feed ("\r\n") as a line ending, which Unix uses just line feed ("\n").
In IE, the editor of the SafeKit web console may truncate files using DOS line ending format.
Solution : A workaround consists in converting end of lines in the file from Windows format to Unix format. For this either use :
- the dos2unix command
- the vim editor, apply the command :set ff=unix ; then save the file
- the Notepad++ editor, in the "Edit" menu, select "EOL Conversion" -> "UNIX/OSX Format" ; then save the file
Id : SK-0075
OS / Release : Linux / > 7.3.0.10
How to : Configure safewebserver on SLES12
- Install httpd server 2.4 package.
- Edit the /opt/safekit/web/bin/safeapachectl script according to the inline comments
- Copy /opt/safekit/web/conf/httpd.conf.sles12 to /opt/safekit/web/conf/httpd.conf
- Start safewebserver : /opt/safekit/safekit webserver start
Id : SK-0076
OS / Release : Linux / > 7.1
Problem : Could not configure cluster : got Error:incoherent local name ...

check the sysctl option net.ipv4.ip_nonlocal_bind , it must be 0.
if not, set it with command sysctl net.ipv4.ip_nonlocal_bind=0 and retry cluster configuration.
check /etc/sysctl and /etc/sysctl.d to be sure that this option is not set at boot time.
Id : SK-0077
OS / Release : Linux / 7.3
Problem : Messages : Error: INVALID_SERVICE: 'safeagent' not among existing services at safekitinstall

Remove obsolete safeagent firewalld service : firewall-cmd --remove-service=safeagent
Id : SK-0078
OS / Release : All / < 7.3.0.24
Problem : Mirror module stays into WAIT-magenta state on both nodes or failover rules do not apply

Check the configuration file of the module userconfig.xml. Having 2 CDATA sections under <failover> leads to these behavior. For instance:
<failover> <![CDATA[ is_alone: if(custom.checkaround == down) then restart(); ]]> <![CDATA[ is_isolated: if(custom.checkisolated == down) then stopstart(); ]]> </failover>
Solution : This configuration must be replaced by:
<failover> <![CDATA[ is_alone: if(custom.checkaround == down) then restart(); is_isolated: if(custom.checkisolated == down) then stopstart(); ]]> </failover>
Id : SK-0079
OS / Release : Windows / >= 7.4.0.16
Problem : Module not starting correctly if cluster configuration contains DNS names
Mars Id : 69307
On Windows, if:
- Addresses of nodes are specified as DNS names (FQDN) in cluter.xml
- On one or several nodes, the FQDN specified in cluster.xml corresponds to a local name (e.g. the first part of the FQDN is the hostname and the rest of the FQDN is the DNS suffix specified in the Windows network configuration)
- The node(s) is/are multihomed
Then it is possible that the Windows resolver returns an IP address that is NOT the first address returned by the DNS server for the specified FQDN, and the module(s) may not start correctly (heartbeat lost, reintegration timeout …)
Solution :
If you are using DNS names in cluster.xml, please check on all nodes that the address displayed by the “ping” command for the local DNS address is the same as the address displayed by the “nslookup” command. If it is not the case, you need to alter the node’s Windows network configuration interface and route metric so that the above condition is fulfilled.
Id : SK-0080
OS / Release : All / < 7.4.0.16
Problem : Module communication failures if cluster configuration contains DNS names

Some bugs in the DNS name resolution leads to module internal communication failures if the cluster configuration contains DNS names.
Workaround :
A work-around consists in setting only IP addresses. But if you require DNS names for accessing the SafeKit web console, the work-around consists in setting 2 lan sections into into the cluster configuration. One lan definition with DNS names used only by the SafeKit web console ; one lan definition with IP addresses used for the framework communications. For instance, the cluster configuration may look like the following one : <cluster> <lans> <lan name="default" connect="on" console="on" framework="off"> <node name="node1" addr="node1.safe"/> <node name="node2" addr="node2.safe"/> </lan> <lan name="private" connect="off" console="off" framework="on"> <node name="node1" addr="172.23.188.101"/> <node name="node2" addr="172.23.188.102"/> </lan> </lans> </cluster>

Id : SK-0081
OS / Release : Windows 10 Pro / 7.4
Problem : Hyper-V module (hyperv.safe) start fails with plugwait error

hyperv.safe relies on PowerShell scripts that require, for a correct execution, the change of the execution policy.

Solution :
Change the execution policy as follow:

start a Windows PowerShell session
run Set-ExecutionPolicy RemoteSigned
reply yes when prompt

Id : SK-0082
OS / Release : Windows / 7.4
Problem : Hyper-V module (hyperv.safe) failover fails with VM import failure

The failover on node2 fails and into the user script output file SAFEVAR/modules/AM/userlog.ulog (where SAFEVAR=c:\safekit and AM is your module name), you have the following message:


		Import-VM: Unable to import the virtual machine due to configuration errors. Use Compare-VM to to repair the virtual machine.

The VM import during the failover is equivalent to the virtual machine (VM) migration that consists in moving the VM from physical server node1 to node2. The import may fail when the migration requirements are not met.

Solution :
Check the common requirements for HyperV VM migration depending on you Windows release number. This requirements applies on the physical server settings (processor, Active Directory domain, ...) and the VM settings (virtual hard disks, virtual networks, ...). For checking incompatilities, you can try to manually import the VM on node2 while SafeKit is stopped. It will logs incompatibility error messages. One common error is because the host hardware isn't compatible. This occurs when a virtual machine has one or more snapshots, and hosts have different processor versions. To fix this problem, shut down the virtual machine on node1 and turn on the processor compatibility setting as follow:

From Hyper-V Manager, in the Virtual Machines pane, right-click the virtual machine and click Settings.
In the navigation pane, expand Processors and click Compatibility.
Check Migrate to a computer with a different processor version.
Click OK.

Be aware that it is anyway recommanded to have the same physical servers when using hyperv.safe since you may have other incompatibilities issues.

Id : SK-0083
OS / Release : Windows 10 Pro / 7.4
Problem : Some SafeKit components and modules fails on Windows 10 Pro

SafeKit relies on PowerShell scripts, that require for a correct execution, the change of the execution policy.

Solution :
Change the execution policy as follow:

start a Windows PowerShell session
run Set-ExecutionPolicy RemoteSigned
reply yes when prompt

Id : SK-0084
OS / Release : All />= 7.2
Mars Id : 71535
Problem : In mirror modules, data reintegration fails on expiration of cryptogtraphic keys

SafeKit relies on a certificate for securing module internal communications. With SafeKit <= 7.4.0.31, the validity period for this certificate is 1 year.

When the certificate expires, the module goes to ALONE/STOP with the application still running on the ALONE. The secondary fails to reintegrate with the following message:

reintegre | D | XXX clnttcp_create: socket=7 TLS handshake failed

For checking that your module is using encrypted communication, check that the file named modulekey.p12 is present in SAFE/modules/AM/conf/ (where AM is the module name). The certificate expiration date is most of the time, 1 year after the creation date of this file. For more precise date, please contact the support.

Solution :
The solution consists in generating a new certificate (but this new one will still expire in 1 year). It can be done either with:

the web console
- Stop the module on both nodes
- Launch the Configuration wizard of the module
- Go to "Edit the Configuration" tab
- Check the "Generate Keys" checkbox
- Click ont the "Validate" button
- Then "Apply the configuration" on both nodes

the command lines (where AM is the module name)
- Stop the module on both nodes
- Login as administrator/root on one node and open a command shell window
- Generate keys with the command safekit module genkey -m AM
- Then apply the configuration on both nodes with the command safekit –H "*" -E AM

If you prefer to run with a certificate that has a longer validity period, upgrade to the SafeKit release > 7.4.0.31 that fixes it to 20 years.

Number of files	m maximum size in bytes	a allocation delta in bytes	m in MB
400 000	536 870 912	67 108 864	512
600 000	805 306 368	100 663 296	768
800 000	1 073 741 824	134 217 728	1 024
1 000 000	1 342 177 280	167 772 160	1 280
1 200 000	1 610 612 736	201 326 592	1 536
1 400 000	1 879 048 192	234 881 024	1 792
1 600 000	2 147 483 648	268 435 456	2 048
1 800 000	2 415 919 104	301 989 888	2 304
2 000 000	2 684 354 560	335 544 320	2 560
2 200 000	2 952 790 016	369 098 752	2 816
2 400 000	3 221 225 472	402 653 184	3 072
2 600 000	3 489 660 928	436 207 616	3 328
2 800 000	3 758 096 384	469 762 048	3 584
3 000 000	4 026 531 840	503 316 480	3 840
3 200 000	4 294 967 296	536 870 912	4 096

List of Items for main SafeKit Releases

All Releases

SafeKit 7.4

SafeKit 7.3

SafeKit 7.2

SafeKit 7.1

SafeKit 7.0.11

SafeKit 7.0.10

SafeKit 7.0.9

SafeKit 7.0.8

SafeKit 7.0.4

SafeKit 7.0.1

List of Items ordered by Id