ZIM TECHNOLOGIES DO BRASIL

COMO INSTALAR ZIM 8.50

HP-UX, AIX, LINUX E UNIXWARE

Próx

Antes de Iniciar

O objetivo deste documento é apresentar os passos necessários para instalar a versão mais recente do Zim 8.50 para Unix (HP-UX, AIX, Linux and UnixWare). Para maiores informações consulte: - Nosso website (http://www.zim.biz); - Help Online do Zim 8.50 sugerimos que você o adicione em seus Favoritos do

Browser de Internet (http://www.zimdatabase.com/helphtml8/Índice.html); - Suporte da Zim através do telefone 0800 724-0107 ou email suporte@zim.biz.

Próx

Índice

I. Considerações II. Pré-instalação Zim (Unix) III. Instalando Zim (Unix) IV. Notas

INSTALANDO ZIM 8.50 (Unix)

Próx Ante

Considerações

I) CONSIDERAÇÕES – Executando Aplicações Zim 8.50 Avisos importantes antes de executar aplicações Zim 8.50 Bancos de dados existentes: bancos de dados de versões anteriores à versão 8.50, não podem ser utilizados diretamente usando Zim 8.50, devendo ser convertido para esta versão. Versões anteriores do Zim podem conter menos informações em seus dicionários de dados e poderão corromper o bancos de dados. Para migrar para a versão Zim 8.50 consulte o tutorial “Migrando para Zim 8.50”.

Executáveis Zim: o Zim 8.50 não tem os programas ZimMU, ZimRT, ZimRTMU, ZimQRT, ZimQRTMU, ZimPRT e ZimPRTMU;

Arquitetura Zim: o Zim 8.50 possue arquitetura Cliente/Servidor, onde o ZimServer atua como servidor e os clientes Zim (Windows/Unix) e ZimTC (somente Windows) atuam como clientes;

Release Notes: os documentos chamados “Releases Notes” disponíveis no Help do Zim 8.50 devem ser lidos, pois reportam as várias alterações que foram introduzidas nesta versão. Independente dessas alterações e atualizações, todas as aplicações Zim continuam compatíveis com versões anteriores do produto.

Índice Próx Ante

Considerações

I) CONSIDERAÇÕES – Executando Aplicações Zim 8.50 Avisos importantes antes de executar aplicações Zim 8.50 Painter para Unix: o produto Zim 4.20 Painter Unix não está disponível no Zim 8.50, uma vez que a estrutura do Zim 8.50 é diferente das versões anteriores. O Novo Painter da versão 8.50 está em desenvolvimento e já existe uma versão “beta”, porém você pode usar uma das seguintes opções para desenhar forms na plataforma UNIX:

1. Use o Painter da versão 5.x/7.11. 2. Desenvolva sua interface (displays, forms e windows) em versões prévias do Zim, e quando completado, exporte

os objetos necessários (display, forms e windows) via ZOMEXPORT, e importe no Zim 8.50 via ZOMIMPORT. Arquivos de Configuração: os arquivos de configuração foram simplicificados significativamente. Para mais informações consulte o tutorial “Zim 8.50 – Arquivos de Configuração”;

Work Path: O Zim 8.50 altera o diretório de trabalho e o diretório do banco de dados para trabalhar de uma maneira mais simples (não existem mais config.zim). Para mais informações consulte o tutorial “Zim 8.50 – Arquivos de Configuração”;

Índice Próx Ante

Considerações

I) CONSIDERAÇÕES – Executando Aplicações Zim 8.50 Avisos importantes antes de executar aplicações Zim 8.50 O Zim 8.50 foi desenvolvido para se comportar exatamente da mesma maneira que as versões anteriores do Zim em termos de perspectiva de aplicativos Zim. No entanto, pequenas diferenças podem ocorrer nas seguintes circunstâncias: a) Janela Zim com atributo AutoSize não definido: podem apresentar barras de rolagem, se os FORMS que está

sendo exibido é maior do que o tamanho da janela. Normalmente, executáveis até Zim 7.11 não apresentaria as barras de rolagem. ZimTC (Zim Thin Client), por outro lado, segue os padrões do Microsoft Windows e apresenta as barras de rolagem.

Para resolver essa situação, você pode desenhar novamente o formulário, verificando o atributo AutoSize. b) Máscara de Entrada e Saída no formfields: se há uma entrada ou uma saída em máscaras no formfields, mas seu

comprimento é menor que o comprimento real do campo, então o FORM DISPLAY irá apresentar os caracteres de máscara ”?” preenchendo o restante do campo.

Índice Próx Ante

Pré-instalação Zim (Unix)

II) PRÉ-INSTALAÇÃO ZIM (UNIX)

a) Recomendações para executar o instalador no Unix Para uma instalação bem-sucedida, você deve ter privilégios de administrador completo na máquina local. Para confirmar esta informação contate o administrador do sistema para obter os privilégios necessários para a instalação..

b) Configurando Unix para executar Zim 8.50 1. HP-UX

1.1. Aplicar patches recentes Para executar o Zim 8.50, é preciso aplicar todos os patches mais recentes fornecidos pela HP para seu ambiente operacional.

1.2. Aumento de Memória Compartilhada (Shared Memory) O tamanho da memória compartilhada requerida dependerá da configuração particular usado por ZimServer. Se não há memória suficiente disponível, Zim Server irá produzir um erro indicando que é a memória compartilhada requerida. Se for necessário aumentá-lo, use o System Administrator Manager (SAM) para definir o valor adequado do parâmetro "shmmax".

INSTALANDO ZIM 8.50 (Unix)

Índice Próx Ante Etapa: Instalando Zim (Unix)

Pré-instalação Zim (Unix)

2. LINUX 2.1. Aumento da Memória Compartilhada (Shared Memory) O tamanho da memória compartilhada requerida dependerá da configuração particular usado por ZimServer. Se não há memória suficiente disponível, Zim Server irá produzir um erro indicando que é a memória compartilhada requerida. Para verificar a memória atual compartilhada , digite o comando : # ipcs –lm Se for necessário aumentá-lo , escreva o seguinte comando: echo " NNN “ > /proc/sys/kernel/shmmax, onde " NNN “ é a memória requerida em bytes. 2.1. Aumento das filas de Mensagem Cada sessão Zim requer duas filas de mensagens. Para verificar as filas existentes , digite o comando : # ipcs –lq Se for necessário aumentá-lo , edite o /etc/sysctl.conf e adicione a seguinte linha: kernel.msgmni=QQQ, onde "QQQ“ é o número de filas de mensagens necessário ( ou seja, 2 * número de usuários ). Em seguida, execute o seguinte comando para forçar o sistema operacional a aceitar esta nova configuração: # /sbin/sysctl -p

INSTALANDO ZIM 8.50 (Unix)

Índice Próx Ante Etapa: Instalando Zim (Unix)

Pré-instalação Zim (Unix)

2.3. Aumentar o número de arquivos abertos O Zim 8.50 agora tenta abertos ,tantos arquivos quanto possível, isto é, sempre que os dados de um arquivo de Zim é solicitado, este arquivo é aberto pelo processo ZimServer e mantido aberto até sessão do processo ZimServer ser encerrada. Portanto, o número máximo de arquivos abertos ao mesmo tempo deve ser aumentado para a soma de todos os arquivos em bases de dados Zim sendo controlado pelo processo ZimServer. Para verificar o número de arquivos abertos suportados pelo sistema operacional, no prompt do sistema operacional digite: # ulimit -n Isto irá exibir o número máximo de arquivos abertos. Se você precisa aumentar esse número, edite o arquivo /etc/security/limits.conf e digite as seguintes linhas: * soft nofile NNNN * hard nofile MMMM Onde NNNN é um número necessário e suficiente para suas aplicações ZIM e MMMM é um número máximo (maior que NNNN) para ser utilizado em caso NNNN ser muito baixo. Em seguida, execute o seguinte comando para forçar o sistema operacional a aceitar esta nova configuração: # ulimit -n NNNN

INSTALANDO ZIM 8.50 (Unix)

Índice Próx Ante Etapa: Instalando Zim (Unix)

Pré-instalação Zim (Unix)

3. AIX 4.xe 5.x 3.1. Confira o pacote GCC Instale o pacote gcc para executar o Zim 8.50. Se você já tem este pacote instalado em sua servidor, ignore as instruções a seguir. Para instalar o gcc, vá para www.bullfreeware.com e escolha a sua versão do sistema operacional. Neste site, selecione o pacote mais recente do gcc (geralmente gcc -3.3.x) e faça o download. Em seguida, siga as instruções no item "install", encontrado na mesma página.

4. Solaris 4.1. Aumento de Memória Compartilhada O tamanho da memória compartilhada requerida dependerá da configuração particular usado por ZimServer. Se não há memória suficiente disponível, Zim Server irá produzir um erro indicando que é a memória compartilhada requerida. Se for necessário aumentá-lo, edite o arquivo /etc/system e adicione a seguinte linha: set msgsys:shminfo_shmmax=NNN, onde “NNN“ é a memória requerida em bytes.

INSTALANDO ZIM 8.50 (Unix)

Índice Próx Ante Etapa: Instalando Zim (Unix)

Pré-instalação Zim (Unix)

5. Unixware 5.1. Aumento de Memória Compartilhada O tamanho da memória compartilhada requerida dependerá da configuração particular usado por ZimServer. Se não há memória suficiente disponível, Zim Server irá produzir um erro indicando que é a memória compartilhada requerida. Se for necessário aumentá-lo, edite o arquivo /etc/conf/cf.d/mTune e adicione a seguinte linha: SHMMAX NNN onde “NNN“ é a memória requerida em bytes. Em seguida, você precisa recompilar o kernel: /etc/config/bin/idbuild E reiniciar a máquina.

INSTALANDO ZIM 8.50 (Unix)

Índice Próx Ante

Instalando Zim (Unix)

III) INSTALANDO ZIM (UNIX) 1. Instalando o Zim sob Unix (Linux, HP-UX, AIX e UnixWare) Para uma instalação bem-sucedida, você deve ter privilégios de administrador completo na máquina local. Se você não tiver certeza , entre em contato com o administrador do sistema. 1. Abrir seu navegador de internet e ir para a página da Zim em http://www.zim.biz/ 2. Na página principal, selecionar a opção “DOWNLOADS” e então selecionar a opção conforme segue:

a) Full Version: se você já tem uma chave de ativação válida para a versão 8.50; b) 30-Day Trail: se você não tem uma chave de ativação, uma chave será enviada para você via email;

3. Você irá receber um email sobre o download do arquivo de instalação relacionado com sua escolha; 4. Criar um novo diretório no servidor com o nome /opt/zim/802install; 5. Efetuar o download e cópia do arquivo de instalação para o servidor no diretório /opt/zim/850install; 6. No diretório 850install, executar o comando “tar” para preparar os arquivos para o processo de instalação: Linux# tar xvf 850_linux_XXXX.tar HP-UX# tar xvf 850_hp11_XXXX.tar AIX# tar xvf 850_aix_XXXX.tar 7. Executar a shell script "./Zim-8.50.sh”. 8. Seguir as instruções exibidas na tela.

INSTALANDO ZIM 8.50 (Unix)

Índice Próx Ante Etapa Anterior: Configurando Unix

Instalando Zim (Unix)

2. Configurar variáveis do ambiente UNIX (Linux, HP-UX and AIX). Para executar o software Zim , primeiro você deve configurar as variáveis de ambiente do UNIX. Os comandos usados para definir essas variáveis variam de acordo com o shell a ser utilizado. Sob a Korn Shell, Bourne Shell, ou qualquer POSIX Shell. NOTA: Para que as configurações por usuário fiquem coerentes, inserir estes comandos no arquivo "$HOME/.profile”, ou se você precisa que estas configurações sejam para todos os usuários do sistema, você deve inserí-los no arquivo /etc/profile. 1. Defina a variável de ambiente ZIM para indicar o caminho onde o Zim foi instalado (exemplo: /opt/zim/8.50): ZIM = /opt/zim/8.50 export ZIM

INSTALANDO ZIM 8.50 (Unix)

Índice Próx Ante Etapa Anterior: Configurando Unix

Instalando Zim (Unix)

2. Defina a variável de ambiente ZIMTERM para indicar o nome do seu terminal. (o arquivo exemplo “build.ztcap“ está instalado com o ZIM, e serve como ponto de partida para configurar este arquivo usando o ZIMTCAP ): ZIMTERM=build export ZIMTERM 3. Adicione no PATH o diretório Zim, para indicar o caminho onde os arquivos do Zim estão localizados: PATH=$PATH:$ZIM Export PATH - Sob a Shell C Nota: Para fazer que as configurações sejam consistentes em uma base por usuário , coloque esses comandos no arquivo “$HOME/.cshrc”. 4. Defina a variável de ambiente ZIM para indicar onde Zim foi instalado ( por exemplo, /opt/zim/8.50): setenv ZIM /opt/zim/8.50 5. Defina a variável de ambiente ZIMTERM para indicar o nome do seu terminal (existe o arquivo "build.ztcap" que

é instalado com o Zim, usado como um ponto de partida para configurar o arquivo TERM usando o ZIMTCAP ): setenv ZIMTERM build 6. Acrescente a variável $ZIM a variável PATH para determinar o caminho de busca padrão dos arquivos do ZIM: setenv PATH $PATH:$ZIM

INSTALANDO ZIM 8.50 (Unix)

Índice Próx Ante Etapa Anterior: Configurando Unix

Instalando Zim (Unix)

3. Definir as permissões para os diretórios de trabalho Sob o Zim 8.50, trabalhando com pastas (pastas usadas por usuários logados), são geralmente as mesmas pastas usadas por muitos usuários, ou seja, quando um usuário se loga, o processo Zimserver cria um diretório de trabalho com o nome padrão 00001 (para o primeiro usuário), 00002 para o segundo e assim por diante, a menos que outras opções mudem este nome (ver Estrutura Física de um banco de dados Zim para mais informações). Quando este usuário faz logoff, e outro usuário se loga, ele pode usar o mesmo pasta de trabalho do usuário que se desconectou. Se o comando de permissão a seguir não estiver devidamente setada, ocorrerá o seguinte erro: O processo ZimServer tentará inicializar um diretório (pasta de trabalho), por exemplo 00005, para que para o próximo usuário utilize, mas não pode, porque está sem permissões de usuário dando erro de permissão a pasta. Como solução para este impasse, a opção umask tem que ser definida adequadamente através da emissão: umask 000

INSTALANDO ZIM 8.50 (Unix)

Índice Próx Ante Etapa Anterior: Configurando Unix

Instalando Zim (Unix)

4. Configurando o Terminal Para configurar o arquivo de parâmetros de terminal (xterm.ztcap, vt100.ztcap ,etc) I. No prompt do sistema operacional, executar o comando $ZIM/zimtcap. II. Siga as instruções fornecidas na tela ou siga os passos abaixo. No prompt do LINUX ou Linux, executar o utilitário ZIMTCAP no mesmo diretório onde o Zim está instalado (/opt/zim/8.50, por exemplo). Para navegar e manipular o menu do zimtcap utilize as teclas: - Barra de espaço - volta opção anterior - Letra “M” maiúsculo - volta para menu principal - Letra “C” maiúsculo - limpa o conteúdo do campo # cd /opt/zim/8.50 # ./zimtcap Choose the terminal that is most like your own: (Escolha o terminal que mais se parece com o seu:) 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 ( 1 é para PC, Se for ANSI a opção é 2, se for VT??? a opção é 3, etc.) Para maiores informações sobre como configurar o ZTCAP para seu terminal, consulte Configurando ZTCAP (Unix)

INSTALANDO ZIM 8.50 (Unix)

Índice Próx Ante

Instalando Zim (Unix) - Final

IV) NOTAS: Este documento descreve o seguinte assunto: Instalando Zim 8.50 (UNIX)

FIM Consulte também os tutoriais disponíveis: • Instalando Zim 8.50 (Windows) • Arquivos de Configuração Zim 8.50 (Unix/Windows) • Configurando ZimTcap (Unix) • Zim 8.50 – Primeiros Passos (Unix/Windows) • Migrando para Zim 8.50 (Unix/Windows)