Zim 9.50 requires changes in the configuration of the client and/or the server machines for its proper execution after installation.

The required configuration changes for different versions of Unix are listed below:

Installing Zim 9.50 on a 64-bit Machine

If your system is installed on a 64-bit architecture, the 32-bit architecture libraries must be added to the system such that you system will be able to execute Zim 9.50.

The steps below were based on the Debian 7 version of Linux. You may need to adapt the instructions to your system.

1. Check whether your system is 64-bits (x86_64) or 32-bits (i686)

2. Update your system to ensure there are no missing libraries

3. Add the i386 architecture libraries and update your system again

Increased Shared Memory

The size of the shared memory needed will depend on the particular configuration used by Zim Server.

If not enough memory is available, Zim Server will return an error informing the amount of shared memory needed.

Check the current size of the shared memory [Based on Debian 7]

 ipcs -lm

In the example above, the system will be able to execute any application smaller than 32Mb (32768 Kb) without any adjustment.

It should be enough to run Zim Server.

If you need to increase the size of the shared memory, take the following steps according to your system.

Note: In all examples below, NNN represents the size (in bytes) of shared memory needed.

Linux

Add the NNN value to shmmax

echo NNN > /proc/sys/kernel/shmmax

Increase the Number of Message Queues

Each Zim session requires two message queues.

1. Check the number of existing queues

ipcs -lq

2. If you need to increase the number of queues, edit the file /etc/sysctl.conf and add the following line

kernel.msgmni=QQQ

where QQQ is the number of message queues needed (that is, 2 * number of users).

3. Force the operating system to accept this new setting

/sbin/sysctl -p

Increase the Number of Open Files

Zim 9.50 now keeps open as many files as possible, that is, whenever data from a Zim file is requested, this file is opened by Zim Server and kept open until Zim Server is terminated.

Therefore, the maximum number of files open simultaneously must be increased to the sum of all  Zim files in databases being controlled by Zim Server.

1. Check the current maximum number of open files that the operating system supports

ulimit -n

2. If you need to increase this number, edit the file /etc/security/limits.conf and add the following lines

*               soft    nofile  NNNN

*               hard    nofile  MMMM

Where:

NNNN is a reasonable number needed by your Zim applications

MMMM is some maximum number (> NNNN, to be used in case NNNN is too low).

Suggested Values

root            soft    nofile  32767

root            hard    nofile  32767

*               soft    nofile  32767

*               hard    nofile  32767

3. Force the operating system to accept this new setting

ulimit -n NNNN

Update the System Control File

Update the file /etc/security/sysctl.conf with the following values. They should be adequate for most Zim 9 applications

kernel.sem=250 3200 100 128

fs.file-max=32767

net.core.rmem_default=262144

net.core.rmem_max=4194304

net.core.wmem_default=262144

net.core.wmem_max=1048576

kernel.msgmnb=65536

kernel.msgmax=65536

kernel.shmmax=8192000000

kernel.sysrq=0

net.ipv4.conf.default.rp_filter=1

net.ipv4.tcp_syncookies=1

net.ipv4.ip_local_port_range = 1024 65000

net.ipv4.ip_forward=1

net.ipv4.tcp_timestamps=0

net.ipv4.conf.default.accept_source_route=0

kernel.shmall=268435456

kernel.core_uses_pid=1

✓You have finished the pre-installation procedure Zim 9.50 for Unix and you are now ready to install it