This document details what is needed in your operating system in order to run Zim 8.
The only requirement needed is to increase the virtual memory in case Zim Server raises an error message, when starting, that there was not enough memory. Follow these steps to increase the virtual memory:
a) Open the Windows Control Panel and select the “System” component.
b) Select the “Advanced” tab.
c) Select the “Performance Settings” button.
d) Select the “Advanced” tab.
e) Select the virtual memory “Change” button.
f) Select the drive which you installed on from the drive box.
g) Choose “Custom Size”.
h) Set the “Initial Size” and “Maximum Size” to the recommended values.
i) Select the “Set” button to apply the changes.
j) Select the “OK” button. You may have to reboot your machine.
The only requirement needed is to increase the virtual memory in case Zim Server raises an error message, when starting, that there was not enough memory. Follow these steps to increase the virtual memory:
a) Open the Windows Control Panel.
b) Select the “System” component.
c) Select the “Advanced” tab.
d) Select the “Performance Options” button.
e) Select the virtual memory “Change” button.
f) Select the drive which you installed on from the drive box.
g) Choose “Custom Size”.
h) Set the “Initial Size” and “Maximum Size” to the recommended values.
i) Select the “Set” button to apply the changes.
j) Select the “OK” button. You may have to reboot your machine.
If Zim Server, when starting, raises an error message saying that there was not enough memory, the following steps must be performed in order to increase the virtual memory needed:
a) Open the Windows Control Panel and select the “System” component.
b) Select the “Performance” link.
c) Select the “Advanced Tools” link.
d) Select the “Adjust Appearance and performance of Windows” link.
e) Select the “Advanced” tab.
f) Select the drive which you installed on from the drive box.
g) Choose “Custom Size”.
h) Set the “Initial Size” and “Maximum Size” to the recommended values.
i) Select the “Set” button to apply the changes.
j) Select the “OK” button. You may have to reboot your machine.
Windows Vista has special requirements in order to allow programs to be run. Follow these steps to provide the correct information to Vista:
a) Go to the directory where Zim 8.20 is installed (Example: c:\program files\zim\8.20);
b) Right click in the file named zimserver.exe (the same is valid for zim.exe, zimtc.exe, etc.);
c) Select the “Compatibility” tab;
d) Check “Run this program in compatibility mode for:”;
e) Select “Windows XP (Service Pack 2);
f) Check “Run this program as an administrator”;
g) Select “Apply” button;
h) Select “Ok” button;
You should also install the gcc package to run Zim. If you already have this package installed in our machine, disregard the following instructions.
To install gcc, go to www.bullfreeware.com and choose your operating system version. There, select the most recent gcc package (usually gcc-3.3.x) and download it. Next, follow the instructions in the item "install" found in the same page.
In order to run Zim 8, you need to apply all the most recent patches supplied by HP to your running environment.
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 produce an error telling what is the shared memory needed.
To increase the shared memory, use the System Administrator Manager (SAM) to set the appropriate value of the parameter "shmmax".
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 produce an error telling what is the shared memory needed.
To check the current shared memory, type the command:
ipcs -lm
If it is needed to increase it, type the following command:
echo "NNN" > /proc/sys/kernel/shmmax
where "NNN" is the memory needed in bytes.
Each Zim session requires two message queues. To check the existing queues, type the command:
ipcs -lq
If it is needed to increase it, 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).
Then, run the following command to force the operating system to accept this new setting:
/sbin/sysctl -p
Zim 8 now keeps open as many files as possible, that is, whenever data from a Zim file is requested, this file is open by Zim Server and kept open until Zim Server is ended. Therefore, the maximum number of files open at same time must be increased to the sum of all Zim files in databases being controlled by Zim Server.
To check the number of files that the operating system supports, type, from the operating system promtp:
ulimit -n
This will print the current maximum open files. If you need to increase this number, edit the file /etc/security/limits.conf and type the following lines:
*
soft
nofile NNNN
*
hard
nofile MMMM
Where NNNN is a reasonable number needed by your Zim applications and MMMM is some maximum number (greater than NNNN) to be used in case NNNN is too low.
Then, run the following command to force the operating system to accept this new setting:
ulimit -n NNNN
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 produce an error telling what is the shared memory needed.
If it is needed to increase it, edit the file /etc/system and add the following line:
set msgsys:shminfo_shmmax=NNN
where "NNN" is the memory needed in bytes.
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 produce an error telling what is the shared memory needed.
If it is needed to increase it, edit the file /etc/conf/cf.d/mtune and add the following line:
SHMMAX NNN
where "NNN" is the memory needed in bytes.
Next, you need to rebuild the kernel:
/etc/config/bin/idbuild
and reboot your machine.