Você está na página 1de 32

WIS

Instalao e configurao

Sumrio
Requisitos mnimos de infra-estrutura..........................................4
Servidor de banco de dados...................................................................................4
Servidor de aplicao de coletores.........................................................................4
Pasta de binrios do sistema..................................................................................4
Estao de trabalho................................................................................................ 4
Coletores de dados.................................................................................................4
Rdio-Frequncia.................................................................................................... 5
Impressora de cdigos de barras............................................................................5
Acesso remoto........................................................................................................ 5
Administrao e segurana....................................................................................5

Topologia Sugerida.......................................................................6
Arquivos para instalao:.............................................................7
Servidor de banco de dados..........................................................8
Pr-requisitos.......................................................................................................... 8
Recomendaes de configurao...........................................................................8
Tablespace.............................................................................................................. 8
Usurios do banco de dados...................................................................................9
Scripts de criao do usurio WIS50.......................................................................9
Importao do dump inicial da base de dados........................................................9
Grants necessrios............................................................................................... 10
Compilao dos objetos........................................................................................ 10

Servidor de aplicao de coletores..............................................11


Sobre o mtodo de conexo dos coletores com o servidor...................................11
Compatibilidade 64 bits........................................................................................11
Partio (ou diretrio) /wis....................................................................................11
Criao e configurao de usurios......................................................................12
Os arquivos .bash_profile......................................................................................13
Instalao do Forms Runtime................................................................................15
Configurao de acesso ao banco de dados.........................................................15

Estaes de trabalho..................................................................16
Oracle Forms Runtime.......................................................................................... 16
Oracle Reports Runtime........................................................................................20
Oracle Forms & Reports - Patch 18.......................................................................23
Atalho para execuo do sistema.........................................................................26
Compatibilidade 64 bits........................................................................................26

Pasta ZPL.............................................................................................................. 27
O arquivo TNSNAMES.ORA....................................................................................27
Instalao da fonte 3 of 9 Barcode.......................................................................27

Ambiente de homologao..........................................................28
Banco de dados.................................................................................................... 28
Coletores.............................................................................................................. 29
Estaes de trabalho............................................................................................ 29

Atualizaes do sistema.............................................................30

Requisitos mnimos de infra-estrutura


Servidor de banco de dados

Processador Quad Core 3.0 GHZ ou superior


Memria 16 Gb ou maior
Dois Discos de 500Gb ou maior
Linux ou Windows Server (na verso que seja compatvel com a
verso do Oracle a ser utilizada)
Unidade de Backup
Oracle 11g ou superior

Servidor de aplicao de coletores

Processador Core2Duo 2.8 GHZ ou superior


Memria 4 Gb
Um Disco de 100Gb ou maior
Partio /wis com 5GB ou 5GB livres na partio / com diretrio /wis
2GB de espao livre na partio /opt
Linux (recomendamos a distribuio RedHat ou Fedora)
Servio Telnet ou SSH disponvel para conexo dos coletores de dados
(de acordo com a tecnologia disponvel nos coletores utilizados)

Pasta de binrios do sistema

Pasta compartilhada (SMB) com os arquivos binrios do sistema,


acessvel s estaes de trabalho WIS
Em caso de utilizao de Windows Terminal Server deve-se criar uma
pasta local com permisso de leitura aos usurios

Estao de trabalho

Pentium III ou superior


Memria 1 GB ou maior
Windows

Coletores de dados
Qualquer marca/modelo que emule Telnet
Marcas sugeridas:
Intermec
Motorola
Psion Technologies
Honeywell

Rdio-Frequncia
Cobertura de rede WI-FI para utilizao dos coletores de dados
Marcas sugeridas:
Cisco
Motorola

Impressora de cdigos de barras


Qualquer marca/modelo que interprete os padres ZPL ou IPL
Marcas sugeridas:
Intermec
Zebra

Acesso remoto
Acesso via VPN disponvel para as equipes de implantao e suporte
Banco de dados (SQLNet porta padro 1521 TCP)
Servidor de coletores (SSH porta padro 22 TCP)

Administrao e segurana

Responsvel de TI por atualizao de rotinas em ambiente de


produo
Poltica de backup de responsabilidade do cliente e deve ser
definida prevendo a maior disponibilidade possvel do sistema, pois
trata-se de uma aplicao crtica. Backup da aplicao e banco
preferencialmente on-line com start automtico em caso de queda do
servidor principal.

Topologia Sugerida

Arquivos para instalao:


Os arquivos abaixo so necessrios para as instalaes descritas neste
manual.
Dados para download
Usurio: sythex
Senha: sydeco
Oracle Developer 6i - Windows:
http://clientes.sythex.com.br/arquivos/dev6i/Dev6i.zip
Oracle Developer 6i Patch 18 - Windows:
http://clientes.sythex.com.br/arquivos/dev6i/Dev6i_Patch18.zip
Oracle Developer 6i Patch 64 bit - Windows:
http://clientes.sythex.com.br/arquivos/dev6i/forms6i_64bit-dll.zip
Fonte 3of9barcode:
http://clientes.sythex.com.br/arquivos/dev6i/3of9barcode.ttf
Arquivos para a pasta C:\ZPL:
http://clientes.sythex.com.br/arquivos/dev6i/ZPL.zip
Oracle Developer 6i - Linux:
http://clientes.sythex.com.br/arquivos/dev6i/dev6i-linux.tar.gz

Servidor de banco de dados


Pr-requisitos

A instncia Oracle deve ter character set WE8MSWIN1252 ou


WE8ISO8859P1.
O parmetro sec_case_sensitive_logon precisa ser configurado
como FALSE.
No banco de dados Oracle 12c ou superior o arquivo sqlnet.ora deve
ter a seguinte linha:
SQLNET.ALLOWED_LOGON_VERSION_SERVER=8

Recomendaes de configurao

O software do banco de dados e os arquivos de dados (datafiles)


devem estar em discos diferentes, fisicamente.
O ideal que os ndices tenham um tablespace nico, diferente do
que hospeda as tabelas.
Utilizao do gerenciamento automtico de memria (AMM), com a
configurao do parmetro memory_target para 40% da memria
disponvel no servidor.
Para uma base de at 300 usurios recomendamos os seguintes
parmetros na instncia:
processes = 300
sessions = 500
transactions = 600
open_cursors = 300

Tablespace
No dump inicial do sistema os objetos esto nos tablespaces
TBS_WIS_DATA e TBS_WIS_INDX.
Como sugesto, est abaixo o script para criao deste tablespace:
CREATE TABLESPACE "TBS_WIS_DATA" DATAFILE
'<caminho_do_arquivo>\tbs_wis_data-01.dbf' SIZE 2G
AUTOEXTEND ON NEXT 200M MAXSIZE 32767M
LOGGING ONLINE PERMANENT BLOCKSIZE 8192
EXTENT MANAGEMENT LOCAL AUTOALLOCATE DEFAULT
NOCOMPRESS SEGMENT SPACE MANAGEMENT AUTO;
CREATE TABLESPACE "TBS_WIS_INDX" DATAFILE
'<caminho_do_arquivo>\tbs_wis_indx-01.dbf' SIZE 500M
AUTOEXTEND ON NEXT 200M MAXSIZE 32767M
LOGGING ONLINE PERMANENT BLOCKSIZE 8192
EXTENT MANAGEMENT LOCAL AUTOALLOCATE DEFAULT
NOCOMPRESS SEGMENT SPACE MANAGEMENT AUTO;
8

Usurios do banco de dados

WIS50 Usurio core, onde esto os objetos e tabelas do sistema.

Scripts de criao do usurio WIS50


Os comandos abaixo devem ser executados no banco de dados Oracle com
o usurio SYS.
Alguns parmetros como a senha do usurio e o nome da tablespace podem
ser alterados de acordo com a necessidade.
create user WIS50 identified by senha
default tablespace TBS_WIS_DATA;

Importao do dump inicial da base de dados


Ser fornecido um dump inicial para cada usurio do sistema.
Os dumps so gerados via export datapump verso 11.
Dump do usurio WIS50:
O schema contido no dump WIS_STANDARD e deve ser importado
no banco de dados com o nome de WIS50.
A tablespace dos objetos contidos no dump
TBDS_WIS_STANDARD.
O arquivo do dump deve ser copiado para o diretrio de datapump do seu
servidor.
O diretrio padro fica em admin\nome_da_instncia\dpdump dentro do
diretrio ORACLE_HOME.
Abaixo o comando para importao do dump:
impdp userid=\"/ as sysdba\" SCHEMAS=WIS_STANDARD
DUMPFILE=wis_standard_5_3_08_000.dmp
LOGFILE=wis_standard_5_3_08_000-imp.log
REMAP_SCHEMA=WIS_STANDARD:WIS50

10

Grants necessrios
As seguintes permisses so necessrias para que o WIS tenha todas suas
funcionalidades ativas e devem ser concedidas pelo usurio SYS:
GRANT
GRANT
GRANT
GRANT
GRANT
GRANT
GRANT
GRANT
GRANT
GRANT

CONNECT, RESOURCE TO WIS50;


CREATE JOB TO WIS50;
SELECT ON GV_$SESSION TO WIS50;
SELECT ON GV_$LOCK TO WIS50;
SELECT ON V_$SESSION TO WIS50;
SELECT ON V_$LOCK TO WIS50;
SELECT ON DBA_BLOCKERS TO WIS50;
SELECT ON DBA_CONSTRAINTS TO WIS50;
SELECT ON DBA_CONS_COLUMNS TO WIS50;
SELECT ON DBA_JOBS_RUNNING TO WIS50;

Compilao dos objetos


Aps a importao do dump alguns objetos do banco de dados ficam
invlidos.
Execute o seguinte comando para compil-los:
exec dbms_utility.compile_schema('WIS50');
Em seguida execute o comando abaixo com o usurio WIS50 e entre em
contato com a Sythex caso retorne alguma linha:
select *
from user_objects
where status <> 'VALID';

11

Servidor de aplicao de coletores


Sobre o mtodo de conexo dos coletores com o servidor
Os coletores executam as rotinas do WIS em modo texto atravs de
conexes Telnet ou SSH com o servidor. Para tanto, necessrio que o
servio de Telnet ou SSH esteja habilitado e configurado no servidor Linux.

Compatibilidade 64 bits
O runtime Oracle Forms um software de 32 bits e para que seja executado
em sistemas operacionais de 64 bits necessrio que no servidor Linux
estejam instalados os pacotes de compatibilidade 32 bits (LibX11.i386).

Partio (ou diretrio) /wis


Dentro de /wis devem ser criadas dois diretrios: coletores e fontes:
[root@wis ~]# mkdir /wis/coletores
[root@wis ~]# mkdir /wis/fontes
As propriedades destas pastas devem ser alteradas para que o usurio
dev6i tenha permisso de escrita e o grupo wis tenha permisses de leitura
e execuo dos arquivos:
[root@wis ~]# chown dev6i:wis /wis -R
[root@wis ~]# chmod 750 /wis -R

12

Criao e configurao de usurios


Crie um grupo no Linux chamado wis:
[root@wis ~]# groupadd wis
Crie um usurio chamado dev6i, integrante do recm criado grupo wis.
Este usurio necessrio para que nossos tcnicos possam atualizar e
compilar as rotinas do sistema.
[root@wis ~]# useradd dev6i -m -G wis
Crie quantos usurios de coletor forem necessrios.
Recomendamos que os usurios de coletor tenham como nome col01,
col02, col03 e assim por diante.
O ideal que cada coletor esteja identificado e configurado com um usurio
Linux especfico, com isso possvel identificar, por exemplo, um
determinado erro ou travamento no sistema.
[root@wis ~]# useradd col01 -m -G wis
[root@wis ~]# useradd col02 -m -G wis
OBS.: muito importante que se cadastre uma senha segura para cada
usurio Linux.

13

Os arquivos .bash_profile
Os arquivos .bash_profile esto localizados no diretrio home de cada
usurio (geralmente /home/nome_do_usurio/) e contm as variveis de
ambiente e usurio/senha necessrios para execuo do sistema e conexo
ao banco de dados.
Os itens em vermelho devem ser alterados de acordo com as necessidades.
OBS.: Em algumas distribuies Linux este arquivo tem o nome de .profile
O arquivo .bash_profile do usurio dev6i (/home/dev6i/.bash_profile) deve
ter o seguinte contedo:
# .bash_profile
# Arquivo .bash_profile para usurio dev6i WIS Sythex
# Get the aliases and functions
if [ -f ~/.bashrc ]; then
. ~/.bashrc
fi
# Oracle DEV6i
ORACLE_BASE=/opt/oracle
ORACLE_HOME=$ORACLE_BASE/product/dev6i
TNS_ADMIN=$ORACLE_HOME/network/admin
LD_LIBRARY_PATH=$ORACLE_HOME/lib:/usr/X11R6/lib:/usr/lib:
$ORACLE_HOME/network/jre11/lib/linux/native_threads
export ORACLE_BASE ORACLE_HOME TNS_ADMIN LD_LIBRARY_PATH
## setting for all products
ORACLE_TERM=vt220
TK60_ICON=$ORACLE_HOME/tools/devdem60/bin/icon
UI_ICON=$TK60_ICON
DEMO60=$ORACLE_HOME/tools/devdem60
export ORACLE_TERM TK60_ICON UI_ICON DEMO60
## setting for Forms Runtime
FORMS60_PATH=$ORACLE_HOME/tools/devdem60/demo/forms
FORMS60_TERMINAL=$ORACLE_HOME/forms60/admin/terminal/US
export FORMS60_PATH FORMS60_TERMINAL
# User specific environment and startup programs
PATH=$PATH:$ORACLE_HOME/bin:$HOME/Bin
export PATH

14

O arquivos .bash_profile dos usurios de coletor (/home/colXX/.bash_profile)


devem ser iguais e ter o seguinte contedo:
# .bash_profile
# Arquivo .bash_profile para usurios de coletor WIS Sythex
# Get the aliases and functions
if [ -f ~/.bashrc ]; then
. ~/.bashrc
fi
# Oracle DEV6i
ORACLE_BASE=/opt/oracle
ORACLE_HOME=$ORACLE_BASE/product/dev6i
TNS_ADMIN=$ORACLE_HOME/network/admin
LD_LIBRARY_PATH=$ORACLE_HOME/lib:/usr/X11R6/lib:/usr/lib:
$ORACLE_HOME/network/jre11/lib/linux/native_threads
export ORACLE_BASE ORACLE_HOME TNS_ADMIN LD_LIBRARY_PATH
# setting for all products
ORACLE_TERM=vt100
TK60_ICON=$ORACLE_HOME/tools/devdem60/bin/icon
UI_ICON=$TK60_ICON
DEMO60=$ORACLE_HOME/tools/devdem60
export TERM=xterm
export ORACLE_TERM TK60_ICON UI_ICON DEMO60
## setting for Forms Runtime
FORMS60_PATH=$ORACLE_HOME/tools/devdem60/demo/forms
PATH=$PATH:$ORACLE_HOME/bin:$HOME/bin
export PATH
unset USERNAME
## Executa aplicacao WMS
cd /wis/coletores
f60run wis_mcol.fmx wis/wis@wms
exit

15

Instalao do Forms Runtime


A Sythex fornece um pacote pr-configurado do Developer 6i para Linux,
com os arquivos necessrios para execuo do WIS.
O arquivo dev6i-linux.tar.gz deve ser extrado na raiz do servidor ( / ):
[root@wis ~]# cd /
[root@wis ~]# tar zxvf dev6i-linux.tar.gz
Este comando ir extrair os arquivos no diretrio /opt/oracle/product/dev6i
A seguir, devemos alterar as propriedades deste diretrio para que apenas
os usurios dev6i e root tenham permisso de gravao, e o grupo wis (ao
qual pertencem os coletores) tenha permisso de leitura e execuo:
[root@wis ~]# chown dev6i:wis /opt/product/oracle/dev6i -R
[root@wis ~]# chmod 750 /opt/product/oracle/dev6i -R

Configurao de acesso ao banco de dados

Edite os arquivos tnsnames.ora e sqlnet.ora em


/opt/oracle/product/dev6/network/admin/ com as informaes necessrias
para conexo ao banco de dados do WIS:
TNSNAMES.ORA:
WMS =
(DESCRIPTION =
(ADDRESS=(PROTOCOL=TCP)(host=nome_ou_endereo_IP)
(port=1521))
(CONNECT_DATA=(SID= ))
)

SQLNET.ORA:
NAMES.DIRECTORY_PATH=(TNSNAMES)

16

Estaes de trabalho
Oracle Forms Runtime
Navegue at o diretrio onde se encontra a instalao do Developer 6i e
execute o arquivo setup.exe.

Insira o nome da empresa e altere o campo Idioma para English.


Clique em OK.

Preencha novamente o nome da empresa e clique em OK.

17

Selecione a primeira opo: Oracle Forms Developer e clique em


OK.

Selecione Custom e clique em OK.

18

Selecione as opes Forms Runtime e Graphics Runtime e clique


em Install.

Clique em OK.

19

Clique em OK novamente.

Clique em OK.

Clique em Exit.

Clique em Yes.
Aps o trmino da instalao, feche todas as janelas do Windows Explorer
que o instalador abriu.
20

Oracle Reports Runtime


Execute novamente o arquivo setup.exe

Preencha o nome da empresa e clique em OK.

Selecione a terceira opo: Oracle Reports Developer e clique em


OK.

21

Selecione Custom e clique em OK.

Selecione a opo Reports Runtime e clique em Install.

Clique em OK.

22

Clique em Exit.

Clique em Yes.
Aps o trmino da instalao, feche todas as janelas do Windows Explorer
que o instalador abriu.

23

Oracle Forms & Reports - Patch 18


Navegue at o diretrio onde se encontra a instalao do Patch
correspondente sua verso de Windows.
Execute o arquivo setup.exe.

Preencha o nome da empresa e clique em OK.

Selecione Custom e clique em OK.

24

Selecione as opes Forms Runtime, Graphics Runtime e Reports


Runtime. Clique em Install.

Clique em OK.

25

Clique em Exit.

Clique em Yes.

26

Atalho para execuo do sistema


Crie um atalho apontando para C:\ORANT\BIN\IFRUN60.EXE.
Edite as propriedades do atalho conforme a figura abaixo:

No campo Destino, insira ao final da linha as informaes em negrito:


C:\orant\BIN\ifrun60.EXE dmenuwis.fmx wis50/wis50@wms
(Substitua wis50/wis50@wms pela string de conexo ao banco de dados
Oracle)
O campo Iniciar em deve conter o caminho para a pasta onde esto os
arquivos fonte do sistema, fornecidos pela Sythex.

Compatibilidade 64 bits
Em instalaes feitas em mquinas com Windows 64 bits o contedo do
arquivo
deve ser extrado na pasta C:\ORANT\BIN.

27

Pasta ZPL
A pasta C:\ZPL deve ser criada com direito de gravao pelo usurio, com os
arquivos IMP_LOC.BAT e IMP_REM.BAT, fornecidos pela Sythex.
Nesta pasta sero gerados os arquivos necessrios para impreso das
etiquetas.

O arquivo TNSNAMES.ORA
Edite o arquivo C:\ORANT\NET80\ADMIN\TNSNAMES.ORA com a configurao
necessria para conexo ao seu banco de dados Oracle.
Consulte o responsvel pelo banco de dados para a configurao correta.

Instalao da fonte 3 of 9 Barcode


A fonte 3 of 9 Barcode necessria para execuo do sistema.
Para instalar a fonte, copie o arquivo 3of9barcode.ttf para a pasta
C:\Windows\Fonts do computador, (caso seja necessrio, substitua
C:\Windows pelo diretrio de instalao do Windows).

28

Ambiente de homologao
muito importante que tenhamos um ambiente de homologao o mais
prximo possvel ao ambiente de produo tanto em hardware como em
software para que possamos atuar em desenvolvimentos e suporte sem
colocar o sistema de produo em risco.
Este captulo descreve a criao de um ambiente de homologao
recomendado.

Banco de dados
Deve-se criar uma instncia separada para homologao.
Esta base deve ser constantemente atualizada com um dump gerado no
ambiente de produo.
Gerao do dump de produo
Execute o comando abaixo para gerar um dump atualizado da base de
produo do schema WIS50:
expdp userid=\"/ as sysdba\" schemas=WIS50 DUMPFILE=wis50-prodanomesdia.dmp LOGFILE=wis50-prod-anomesdia.log
O arquivo ser gerado no servidor dentro de
ORACLE_HOME\admin\nome_da_instncia_de_produo\dpdump.
Copie este arquivo para
ORACLE_HOME\admin\nome_da_instncia_de_homologao\dpdump.
ATENO!!! CERTIFIQUE-SE DE QUE EST CONECTADO INSTNCIA
DE HOMOLOGAO ANTES DE PROSSEGUIR!!!
select instance_name from v$instance;
Conectado instncia de homologao execute os seguintes comandos:
drop user WIS50 cascade;
create user WIS50 identified by senha
default tablespace TBS_WIS_DATA;
No sistema operacional, faa o import da base de dados:
impdp userid=\"/ as sysdba\" SCHEMAS=WIS50 DUMPFILE=wis50-prodanomesdia.dmp LOGFILE=wis50-prod-anomesdia-imp.log
Recompile os objetos:
exec dbms_utility.compile_schema('WIS50');

29

Coletores
Sempre que houver atualizao da base de dados de homologao a
pasta /wis/coletoreshml deve ser atualizada com uma cpia da pasta
/wis/coletores.
[root@wis ~]# rm -rf /wis/coletoreshml
[root@wis ~]# cp -r /wis/coletores /wis/coletoreshml

Estaes de trabalho
Pasta de binrios de homologao
Deve ser criada uma pasta de binrios do sistema, cpia da pasta utilizada
em produo no momento da gerao do ltimo dump de produo.
Assim como a pasta de coletores, esta pasta deve ser atualizada com cpia
da pasta de produo sempre que houver atualizao do banco de dados de
homologao.
O arquivo TNSNAMES.ORA
O arquivo C:\ORANT\NET80\ADMIN\TNSNAMES.ORA deve ser atualizado com
o TNS de acesso ao ambiente de homologao.
Atalho de acesso a homologao
Deve ser criada uma cpia do atalho de acesso ao sistema de produo,
onde sero alterados os seguintes itens:
No campo Destino, insira ao final da linha as informaes em negrito:
C:\orant\BIN\ifrun60.EXE dmenuwis.fmx wis50/wis50@wmshml
(Substitua wis50/wis50@wmshml pela string de conexo ao banco de
dados Oracle de homologao)
O campo Iniciar em deve conter o caminho para a pasta onde esto os
arquivos fonte do de homologao.

30

Atualizaes do sistema
Quando houver customizao ou correo de bugs no sistema ser
necessrio fazer a atualizao de programas.
Os arquivos sero enviados pelo tcnico responsvel e alguns passos
devero ser executados.
Os procedimentos esto descritos abaixo:

Ambiente Desktop Windows


-Localize a pasta com os binrios do sistema:
O caminho para a pasta encontra-se no campo Iniciar em: do atalho
(devem haver pastas diferentes para produo e homologao).
-Certifique-se de que nenhum usurio desktop est utilizando o sistema WIS
no momento.
-Faa backup dos arquivos a serem substitudos.
-Copie os arquivos enviados para a pasta de binrios do sistema WIS,
substituindo os antigos se necessrio.

31

Ambiente de coletores Linux


No Linux de coletores necessrio compilar o novo arquivo.
No servidor de coletores, por padro as pastas de binrios ficam em:
/wis/coletores Produo
/wis/coletoreshml Homologao
-Faa backup dos arquivos a serem substitudos.
-Copie os arquivos enviados para a pasta de binrios do sistema WIS,
substituindo os antigos se necessrio.
-Execute os comando abaixo dependendo do tipo do arquivo, com o usurio
dev6i:
Para arquivos .FMB:
[root@wis ~]# cd /wis/coletores
[root@wis ~]# f60gen arquivo.fmb wis50/wis50@wms
Substitua arquivo.fmb pelo nome do arquivo enviado e wis50/wis50@wms
pela string de conexo ao banco de dados Oracle.
A ltima linha de retorno do comando deve ser Created form file
arquivo.fmx.
Caso o resultado seja diferente entre em contato com a Sythex, enviando o
erro retornado.
Para arquivos .PLL:
[root@wis ~]# cd /wis/coletores
[root@wis ~]# f60gen arquivo.pll wis50/wis50@wms
module_type=library
Substitua arquivo.pll pelo nome do arquivo enviado e wis50/wis50@wms
pela string de conexo ao banco de dados Oracle.
A ltima linha de retorno do comando deve ser Done.
Caso o resultado seja diferente entre em contato com a Sythex, enviando o
erro retornado.

32