HOW TO INSTALL ZIM 8.50 HP-UX, AIX, LINUX AND UNIXWARE

Transcription

1 ZIM CORPORATION HOW TO INSTALL ZIM 8.50 HP-UX, AIX, LINUX AND UNIXWARE

2 Before Starting 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 ( for the latest details of Zim First, you are advised to add the Zim 8.50 Online Help to the Favorites of your Internet browser's ( 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 or by ing support@zim.biz.

3 Index I. Considerations II. Pre-installation of Zim (Unix) III. Installing Zim (Unix) IV. Notes

4 CONSIDERATIONS 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 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 However, all existing applications remain compatible. Index

5 CONSIDERATIONS I) CONSIDERATIONS Running Zim 8.50 Applications Important notes before running Zim 8.50 Applications! Unix Painter: The Zim 4.20 Painter for Unix is not available in Zim 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

6 CONSIDERATIONS I) CONSIDERATIONS Running Zim 8.50 Applications Important notes before running Zim 8.50 Applications! 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. Index

7 Pre-installation of Zim (Unix) II) Pre-Installation of Zim (Unix) a) Recomendations to run the Unix Setup For 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 HP-UX 1.1. Applying the latest patches To run the Zim 8.50, you need to apply all latest patches supplied by HP to its operational environment Increasing the 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 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. Index Step: Installing Zim (Unix)

8 Pre-installation of Zim (Unix) 2. LINUX INSTALLING ZIM 8.50 (Unix) 2.1. Increasing the Shared Memory The 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 Increase Message Queues Each 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)

9 Pre-installation of Zim (Unix) 2.3. Increase the Number of Open Files Zim 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 Step: Installing Zim (Unix)

10 Pre-installation of Zim (Unix) 3. AIX 4.x e 5.x 3.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 and choose your operating system version. Select the most recent gcc package (usually gcc-3.3.x) and download it., follow the install instructions item found on the same page. 4. Solaris 4.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 Step: Installing Zim (Unix)

11 Pre-installation of Zim (Unix) 5. Unixware 5.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., you need to rebuild the kernel: /etc/config/bin/idbuild and reboot your machine. Index Step: Installing Zim (Unix)

12 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 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 ; 3. You will receive an 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.tar HP-UX# tar xvf 850_hp11_XXXX.tar AIX# tar xvf 850_aix_XXXX.tar 7. Run the shell script "./Zim-8.50.sh. 8. Follow the instructions provided on the screen. Index ious step: Pre-Installation of Zim (Unix)

13 Installing Zim (Unix) 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/zim8 export ZIM Index ious step: Pre-Installation of Zim (Unix)

14 Installing 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=build export ZIMTERM 3. Add the directory where the Zim files are located to your default search PATH: PATH=$PATH:$ZIM export PATH Under the C Shell Note: 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 ious step: Pre-Installation of Zim (Unix)

15 Installing Zim (Unix) 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 (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 ious step: Pre-Installation of Zim (Unix)

16 Installing Zim (Unix) 4. Configuring the Terminal To 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 #. /zimtcap Choose the terminal that is most like your own: 1 - PC like terminals; 2 - ANSI type terminals; 3 - VT series terminals; 4 - WYSE terminals 5 - None of the above Enter your selection [1, 5] : 1 For further information about how to configure the ZTCAP for your terminal, see on Configuring ZimTCap (Unix). Index

17 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)