HP-UX, AIX, LINUX AND UNIXWARE - zim.biz 8 - Installation...Installing Zim under Unix (HP-UX, AIX, Linux and UnixWare) For a successful installation, you must have full administrator

ZIM CORPORATION

HOW TO INSTALL

ZIM 8.50

HP-UX, AIX, LINUX AND UNIXWARE

Next

Before Starting

NextPrev

This document details the steps required to install the latest version of Zim 8.50 on a Unix platform. You should also consult the latest updates posted on our website (http://www.zim.biz) for the latest details of Zim 8.50.

First, you are advised to add the Zim 8.50 Online Help to the Favorites of your Internet browser's (http://www.zim.biz/WebHelp/index.htm) . Here you will find important information regarding Zim 8.50 as well the critical steps that must be followed for installation.

Additional support is available to help you through the installation process of Zim 8.50 by calling +1 613-727-1397 or by emailing [email protected].

http://www.zim.biz/

http://www.zimdatabase.com/helphtml8/index.html

mailto:[email protected]

Index

I. ConsiderationsII. Pre-installation of Zim (Unix)III. Installing Zim (Unix)IV. Notes

INSTALLING ZIM 8.50 (Unix)

NextPrev

CONSIDERATIONS

Index NextPrev

I) CONSIDERATIONS – Running Zim 8.50 Applications

Important notes before running Zim 8.50 Applications!

Existing databases: Existing Zim databases (pre-version 8.50) cannot be run directly in Zim 8.50. The databases must be first converted to Zim 8.50 (pre-Zim 8.50 databases contain less information in their data dictionary and will not be properly understood by Zim 8.50 and may result in corruption). You must follow the conversion steps described in Migrating to Zim 8.50 tutorial;

Zim executables: Zim 8.50 no longer has ZimMU, ZimRT, ZimRTMU, ZimQRT, ZimQRTMU, ZimPRT and ZimPRTMU;

Zim architecture: Zim 8.50 has a Client/Server architecture, with Zim Server being the server and the clients being Zim (for Windows and Unix) or ZimTC (for Windows only);

Release Notes: All Release Notes for Zim 8.50 must be read in the Zim help file as many changes were introduced in Zim 8.50. However, all existing applications remain compatible.

CONSIDERATIONS



Unix Painter: The Zim 4.20 Painter for Unix is not available in Zim 8.50. The file structure in Zim 8.50 is different than previous versions of Zim. A new cross-platform Painter is being developed and will be available soon. Until this new painter is released, you can use one of the following options for painting forms on UNIX;

1. Use the 5.x/7.11 screen painter.2. Develop your user interface from your previous version of Zim, and when completed, export the object

definitions (forms, displays and windows) to Zim 8.50, using the ZOMEXPORT/ZOMIMPORT utility.

Configuration Files: configuration files have significantly changed for simplification (there are no more config.zim, config.db, config.srv and config.def) but rather zimconfig.zim (for the database) and zimconfig.srv (for the server). Refer to the section Configuration Files for more information;

Work Path: Work paths and database paths are handled in a much simpler way in Zim 8.50 (there is no config.zim anymore). Refer to the documentation of zimdb.zim, Work Path and User Name Directory.

Index NextPrev

CONSIDERATIONS

Index NextPrev



Zim 8.50 was built to behave exactly the same way as previous versions from Zim applications perspective. However, small differences may occur in the following circumstances:

1. Zim Windows with AutoSize attribute set to off may display scroll bars if the forms being displayed are larger than the size of the window. Normally, Zim executables up to Zim 7.11 wouldn't display the scroll bars. ZimTC, on the other hand, follows the Microsoft Windows standards and displays the scroll bars. To solve this situation, you can re-paint the form, this time selecting the AutoSize attribute.

2. Input and Output Masks in FormFields: if there is either an input or an output mask in the FormFields but its length is smaller than the actual length of the field, then a FORM DISPLAY will display the masking characters "?" filling the remainder of the field.

Pre-installation of Zim (Unix)

II) Pre-Installation of Zim (Unix)

a) Recomendations to run the Unix SetupFor a sucessful installation, you must have full administrator privileges on the local machine. If you are not sure, please contact your System Administrator.

b) Configuring Unix to run Zim 8.50

1. HP-UX

1.1. Applying the latest patchesTo run the Zim 8.50, you need to apply all latest patches supplied by HP to its operational environment.

1.2. Increasing the Shared MemoryThe 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 indicating the shared memory required. To increase the shared memory, use the System Administrator Manager (SAM) to set the appropriate value of the parameter "shmmax“.

Step: Installing Zim (Unix)Index


NextPrev


2. LINUX

2.1. Increasing the Shared MemoryThe size of the Shared Memory required will depend on the particular configuration used by Zim Server. If insufficient memory is available, Zim Server will produce an error indicating the among of shared memory required. To check the current shared memory, type the command:# ipcs –lm

If additional shared memory is required, type the following command:echo " NNN “ > /proc/sys/kernel/shmmax, where " NNN “ is the memory required in bytes.

2.2. Increase Message QueuesEach Zim session requires two message queues. To check the existing queues, type the command:# ipcs -lq

If an increase is required, edit the file /etc/sysctl.conf and add the following line:

kernel.msgmni=QQQ, where "QQQ" is the number of message queues required (that is, 2 * number of users).

Then, run the following command to force the operating system to accept this new setting:/sbin/sysctl -p

Index


Step: Installing Zim (Unix)NextPrev


2.3. Increase the Number of Open FilesZim 8.50 keeps as many files open as possible, that is, whenever data from a Zim file is requested, the file is opened by ZimServer and remains open until ZimServer has ended. Therefore, the maximum number of files open at the same time must be increased to the sum of all Zim files in databases being controlled by ZimServer.

To check the number of files that the operating system supports, type, from the operating system prompt:# 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

Index




3. AIX 4.x e 5.x3.1. Check the GCC package

The gcc package should also be installed to run Zim. If you already have this package installed in your machine, disregard the following instructions.

To install gcc, go to www.bullfreeware.com and choose your operating system version. Select the most recent gcc package (usually gcc-3.3.x) and download it. Next, follow the “install” instructions item found on the same page.

4. Solaris4.1. Increase Shared Memory

The size of the Shared Memory needed will depend on the particular configuration used by Zim Server. If insufficient memory is available, ZimServer will produce an error indicating the shared memory required.

If additional memory is required, edit the file /etc/system and add the following line:

set msgsys:shminfo_shmmax=NNN, where "NNN" is the memory required in bytes.

Index



http://www.bullfreeware.com/


5. Unixware5.1. Increase Shared Memory

The size of the Shared Memory needed will depend on the particular configuration used by Zim Server. If insufficient memory is available, ZimServer will produce an error indicating the shared memory required.

If additional memory is required, edit the file /etc/conf/cf.d/mtune and add the following line:

SHMMAX NNN where "NNN" is the memory required in bytes.

Next, you need to rebuild the kernel:

/etc/config/bin/idbuild

and reboot your machine.

Index



Installing Zim (Unix)

III) INSTALLING ZIM (UNIX)

1. Installing Zim under Unix (HP-UX, AIX, Linux and UnixWare)

For a successful installation, you must have full administrator privileges on the local machine. If you are not sure, contact your system administrator.

1. Open your favourite web browser and go to the Zim’s webpage http://www.zim.biz/2. In the main page select the menu option “DOWNLOADS” and then select the appropriate option as follow:

a) Full Version: if you already have a valid activation key to install; b) 30-Day Trail: if you do not have valid activation key to install a valid activation key will be sent to your email;

3. You will receive an email with the information to download the installation file related with your selection;4. Create a new directory with the name /opt/zim/850install in the server;5. Download and copy the setup file to the server into the directory /opt/zim/850install;6. In the directory 850install execute the “tar” program to prepare the installation process:

Linux# tar xvf 850_linux_XXXX.tarHP-UX# tar xvf 850_hp11_XXXX.tarAIX# tar xvf 850_aix_XXXX.tar

7. Run the shell script "./Zim-8.50.sh”.8. Follow the instructions provided on the screen.

Index


Previous step: Pre-Installation of Zim (Unix)NextPrev

http://www.zim.biz/


2. Setting the UNIX Environment Variables

To execute the Zim software, you first must set the UNIX environment variables. The commands used to set these variables vary depending on the shell being used.

Under the Korn Shell, Bourne Shell, or any POSIX Shell:

Note: To make the settings consistent on a per-user basis, place the following command in the file “$HOME/.profile”. You can also make the settings available for all the users using the file /etc/profile.

1. Set the ZIM environment variable to indicate where Zim was installed (for example, /opt/zim/8.50):

ZIM=/opt/zim8export ZIM

Index


NextPrev Previous step: Pre-Installation of Zim (Unix)


2. Set the ZIMTERM environment variable to indicate the name of your terminal. (The example “build.ztcap” is installed with the software to give a starting point for configuring this file using the name ZIMTCAP):

ZIMTERM=buildexport ZIMTERM

3. Add the directory where the Zim files are located to your default search PATH:PATH=$PATH:$ZIMexport PATHUnder the C ShellNote: To make the settings consistent on a per-user basis, place the following command in the file “$HOME/.cshrc”.

4. Set the ZIM environment variable to indicate where Zim was installed (for example, /opt/zim/8.50):setenv ZIM /opt/zim8

5. Set the ZIMTERM environment variable to indicate the name of your terminal (The example named “build.ztcap” is installed with the software to give a starting point for configuring this file using the name ZIMTCAP):

setenv ZIMTERM build

6. Add the directory where the Zim files are located to your default search PATH:setenv PATH $PATH:$ZIM

Index




3. Setting permissions for working directories

Under Zim 8.50, working directories (directories used by logged in users) are usually the same for many users, that is, when a user logs in, ZimServer creates a working directory with the default name 00001 (the first user) unless the options change this name (see Physical Structure of a Zim Database in the Zim 8.50 Help Online for more information).

When this user logs off, the next user to log in might use the same working directory name.

ZimServer needs to clean this directory for the next user, but it cannot as it contains permissions from the previous user. As a result, the umask option has to be set appropriately by issuing:

umask 000

Index



http://www.zimdatabase.com/helphtml8/physical_structure_of_a_zim_database.htm


4. Configuring the TerminalTo configure the terminal parameter file (xterm.ztcap, vt100.ztcap, etc.)I. At the operating system prompt, run the command $ZIM/zimtcap.II. Follow the instructions on the screen or follow the steps below.On Linux prompt, run the utility ZIMTCAP in the same directory where Zim is installed (/opt/zim/8.50, for example).ATT: To navigate and manipulate the menu zimtcap use keys:

- Spacebar - back previous option- Letter Upper “M” - back to main menu- Letter Upper “C” - clears the contents of the field

# cd /opt/zim/8.50#. /zimtcapChoose the terminal that is most like your own:1 - PC like terminals;2 - ANSI type terminals;3 - VT series terminals;4 - WYSE terminals5 - None of the aboveEnter your selection [1, 5] : 1

For further information about how to configure the ZTCAP for your terminal, see on “Configuring ZimTCap (Unix)”.

Index


NextPrev

Installing Zim (Unix) - End

IV) NOTES:

This document described the following subject: Installing Zim 8.50 (Unix)

END

Additional tutorials available:• Installing Zim 8.50 (Windows)• Configuration Files Zim 8.50 (Unix/Windows)• Configuring ZimTcap (Unix)• Zim 8.50 – First Steps (Unix/Windows)• Migrating to Zim 8.50 (Unix/Windows)

Documents

HP-UX, AIX, LINUX AND UNIXWARE - zim.biz 8 - Installation...Installing Zim under Unix (HP-UX, AIX, Linux and UnixWare) For a successful installation, you must have full administrator