Instalação do Gnet em Linux e Unix

Instalação do Gnet em Linux e Unix

Visão Geral Instalar o Gnet Configurar o Gnet Inserir o Logotipo nas Facturas A Primeira Factura Manutenção conteúdo

Visão Geral A configuração do Gnet compreende as seguintes etapas principais: - Instalar o software e configurar o sistema para funcionamento do Gnet. - Elaborar uma Factura ou um Orçamento teste para mais tarde verificar a impressão. - Configurar as preferências de impressão da página no web browser de forma a remover a informação de cabeçalho e rodapé e a definir as margens. - Preparar os postos de trabalho existentes para aceder à aplicação Gnet. - Configurar as preferências de impressão para todos os postos de trabalho e impressoras que vão utilizar o Gnet.

Instalar o Gnet O procedimento para instalar o Gestix em Linux varia consoante a distribuição de Linux. IMPORTANTE: A instalação deste produto requer alguns conhecimentos técnicos. Por favor contacte um profissional TI para um apoio qualificado na instalação deste software. O Apache deve estar activo e a funcionar (introduza http://localhost/ na barra de endereço do seu browser para verificar se está a funcionar) O MySQL 4 ou o MySQL 5 deve estar activo e a funcionar. Para verificar abra /usr/bin/mysql (a linha de comando do MySQL) na janela do Terminal e verifique se não recebe nenhuma mensagem de erro na ligação ao servidor MySQL. Escreva exit na linha de comando do mysql para sair. Não continue com a instalação do Gnet caso não tenha conseguido configurar os serviços anteriores. Instalar o Gestix num servidor LAN ou Posto de Trabalho Estão disponíveis diversos ficheiros, relacionados com as principais distribuições Linux. O utilizador deve ter privilégios de root. Pacote IP-Brick: gestix_4.0_ipbrick_i386.deb dpkg -i gestix_4.4_ipbrick_i386.deb Pacotes Debian, Ubuntu: gestix_4.4_i386.deb dpkg -i gestix_4.4_i386.deb Pacotes Caixa Magica, Suse, Redhat, Fedora, Mandriva: gestix-4.0.i386.rpm rpm i gestix--4.0.xx-00.i386.rpm Notas Se usar o pacote RPM, deve desinstalar todas as versões anteriores do Gestix antes de instalar a nova versão: rpm e gestix--3.3.05-00 Se o programa rpm indicar uma dependência quebrada em libstdc++.so.6, forneça esta dependência ou instale manualmente o ficheiro libstdc++.so.6 na directoria /usr/lib e tente de novo o rpm usando a opção nodeps como se segue:

If the rpm program complains about a broken dependency on libstdc++.so.6, either provide this library or install the libstdc++.so.6 file manually into the /usr/lib directory and try the rpm again using the --nodeps option as follows: rpm i --nodeps gestix--4.0.xx-00.i386.rpm Instalar o Gestix Net num servidor Web Pré-requisitos: - MySQL 4.1 ou superior (Em 32bits apenas até ao 5.1) - Apache 1.3 ou superior - Linux Kernel 2.2.0 ou superior Pacote para sistemas com stdlibc++.so.6 e kernel 2.2.5: gestix-4.0.web.i386.tar.gz Pacote para sistemas com stdlibc++.so.5 e kernel 2.2.0: gestix_4.0_web_i386.tar.gz 1. Instalar os ficheiros na localização de instalação: 1.1 Entre no servidor utilizando telnet ou ssh, coloque o Pacote na directoria de trabalho e descomprima-o. gunzip gestix[...]i386.tar.gz 1.2 Altere a directoria actual para a que está disponível para o servidor HTTP, por exemplo: cd public_html 1.3 Extraia os ficheiros do arquivo tar.gz: tar xf../gestix[...]i386.tar 1.4 Faça um soft-link da pasta gnet/lib para a directoria de trabalho actual: ln -s gnet/lib. 1.5 Crie bases de dados e atribua os privilégios de utilizador e a password: Nota: substitua "mysql_user" e "mysql_password" pelo nome de utilizador e password do MySQL Crie duas bases de dados, "gx_db" e "gx_dbres". Dê todos os direitos ao mysql_user nestas duas bases de dados.

Por exemplo: mysql -u root -p --execute="create DATABASE gx_db; CREATE DATABASE gx_dbres" mysql -u root -p --execute="grant ALL PRIVILEGES ON gx_db.* TO 'mysql_user'@'localhost'" mysql -u root -p --execute="grant ALL PRIVILEGES ON gx_dbres.* TO 'mysql_user'@'localhost'" 1.6 Altere a directoria de trabalho actual para a pasta gnet e efectue uma série de comandos para configurar o Gestix Net: Nota: substitua "mysql_user" e "mysql_password" pelo nome de utilizador e password do MySQL cd gnet find. -exec chmod go-w {} \; echo "GNET_PATH `pwd`" > cgi-bin/.htgestix echo "GNET_WWW_DIR." >> cgi-bin/.htgestix echo "GNET_DB_USER mysql_user" >> cgi-bin/.htgestix echo "GNET_DB_PW mysql_password" >> cgi-bin/.htgestix echo "GNET_DB_NAME gx_db" >> cgi-bin/.htgestix echo "GNET_DB_RESOURCES gx_dbres" >> cgi-bin/.htgestix echo "GNET_MYSQLDIR /usr" >> cgi-bin/.htgestix echo "Options ExecCGI" > cgi-bin/.htaccess echo "AddHandler cgi-script.cgi" >> cgi-bin/.htaccess echo "AddDefaultCharset ISO-8859-1" >> cgi-bin/.htaccess echo "gx_db" > temp/enableconfig.cfg 2. Invoque o Gestix a partir da linha de comando para verificar se todas as livrarias necessárias estão disponíveis: cd../gnet/cgi-bin./gestix.cgi Nota: se o resultado forem apenas algumas linhas, pode tratar-se de uma mensagem de erro que nos poderá enviar por email, caso não a consiga interpretar e corrigir. Se a linha indicar the libmysqlclient.so.12 cannot be found, com privilégios de administração entre o comando seguinte: ln /usr/lib/mysql/libmysqlclient.so.14 /usr/lib/mysql/libmysqlclient.so.12 Se, pelo contrário, obtiver muitas linhas de output após ter invocado o comando gestix.cgi, é um bom sinal e pode prosseguir para o passo seguinte. 3. Invoque o Gestix a partir do browser: http://localhost/gnet/cgi-bin/gestix.cgi O browser deve mostrar uma página a indicar A completar a instalação. 5 Abra o Gnet http://localhost/gnet/cgi-bin/gestix.cgi

Configurar o Gnet Quando o Gestix é aberto pela primeira vez após a instalação é mostrado o formulário inicial. O primeiro passo para a configuração do Gestix consiste no preenchimento de diversos campos que vão indicar a configuração mais apropriada para a sua empresa. Idioma Base de instalação Esta escolha irá determinar o idioma para o interface da aplicação bem como o idioma em que são denominados os documentos. Se escolher como idioma base o português o interface estará em português e os documentos terão nomes em português como Factura, Venda a Dinheiro, Guia de Remessa, entre outros. Se escolher como idioma base o Inglês, por exemplo, o interface estará em inglês e os documentos terão nomes em inglês como Invoice, Cash Sale, Delivery Note, etc. Se a sua aplicação inclui o módulo Multiidioma, a escolha do Idioma Base determina o idioma em que são denominados os documentos, ao entrar na aplicação o utilizador pode escolher um idioma diferente para o interface da aplicação. Este módulo permitelhe também escolher o idioma em que deseja imprimir os documentos e poderá criar novas séries de documentos cujas denominações correspondem ao idioma utilizado pelos seus clientes internacionais. Desta forma o módulo Multi-idioma permite-lhe emitir facturas ou outros documentos em diversos idiomas, independentemente daquele escolhido para o interface de trabalho. Número de Série da Licença Introduza o n.º de série correspondente ao produto que adquiriu. Nome Abreviado da Entidade Utilizadora Introduza o nome da sua empresa tal como quer que apareça impresso nos documentos e listagens.

Detalhes da Entidade Utilizadora Nestes campos deverá introduzir os detalhes relativos à sua empresa tais como o nome completo, o endereço de email, os números de telefone e fax e o país. Informação de Log-in do Manager Ao introduzir informação nestes campos estará a criar uma conta de utilizador. Escreva estes dados e guarde-os em lugar seguro dado que caso esqueça o Login e a Password não conseguirá utilizar a aplicação. Nome O seu nome. Login O nome abreviado que o identifica o no sistema. Este nome deverá ser introduzido de todas a vezes que quiser entrar na aplicação. Password Uma combinação secreta de letras e números que deve decorar e digitar de todas as vezes que quiser entrar no Gestix. Nota: Evite a utilização do nome Admin como nome de Login, caso contrário terá acesso apenas às funções de administração do sistema mas não poderá aceder às funcionalidades de negócio. Este nome de Login deve ser reservado apenas para técnicos que devem poder aceder às funções de administração do sistema mas não às informações de negócio nele armazenadas. Reveja a informação introduzida e pressione o botão Gravar. Se aparecer um aviso amarelo no canto superior direito da página clique no aviso para ler a mensagem de erro. Poderá ter-se esquecido de preencher algum dos campos. Após estes passos a inicialização da base de dados será completada. Este processo demora alguns instantes e termina com a apresentação do ecrã de entrada na aplicação onde deverá introduzir o Login e Password definidos anteriormente. Nota: caso se engane nesta fase, ser-lhe-á apresentado novamente formulário de configuração para que possa voltar a digitar os dados de Login e Password.

O formulário de configuração é mostrado da primeira vez que entra na aplicação e consiste numa série complementar de dados para configurar o Gestix para a sua empresa. Poderá voltar a este formulário mais tarde ao clicar em Admin no menu da aplicação e escolher a opção Configuração. Moeda Base Defina qual a moeda base com que pretende trabalhar. Se a sua aplicação inclui o módulo Múltiplas Moedas, deve indicar a moeda base. Terá já uma série de outras moedas definidas que pode utilizar posteriormente para as suas transacções internacionais e pode ainda adicionar outras moedas não contempladas definindo para cada uma a taxa de conversão. Nos campos seguintes deverá indicar os dados referentes ao tratamento de IVA e IRS indicando as respectivas taxas de defeito. Nº de Descontos de Item na Linha dos Documentos Para documentos de vendas e de compras. Permite a indicação de múltiplos descontos para cada item à medida que são inseridos nos documentos. Processamento de Itens de Stock Nestes campos tem a possibilidade de definir como deseja tratar os movimentos de stock. Margens de Página (PDF) O Gestix oferece-lhe a possibilidade de converter documentos e listagens para o formato PDF para arquivo ou envio por email. Nestes campos deve indicar em milímetros, centímetros, ou polegadas (mm, cm ou in) as margens para o documento.

Nota: Estas definições aplicam-se somente à impressão via PDF. Para definir as margens da impressão normal, por favor intervenha na configuração da página do seu Browser. Impressão de Listagens e Relatórios Escolha um tamanho para a página e indique uma imagem para ser impressa no cabeçalho deste tipo de documentos. O tamanho reservado para a imagem é 600 por 64 pixeis. Nota: Se aumentar o número de pixeis da imagem mantendo as proporções o resultado será um aumento de qualidade na impressão da imagem. Impressão de Facturas e Documentos Logísticos Para além da indicação do tamanho da página são-lhe ainda oferecidas diversas opções de personalização destes documentos. Logotipo da Entidade Utilizadora Escolha uma imagem a ser impressa nas facturas e documentos logísticos. O tamanho recomendado para esta imagem é 600 por 320 pixeis. Tal como indicado anteriormente, se forem respeitadas as proporções mas introduzida uma imagem maior o resultado será um aumento de qualidade na impressão. Identificação da Entidade Utilizadora em Texto Introduza o texto que deve figurar nas facturas ou documentos logísticos em alternativa ao uso de uma imagem com logotipo da empresa. Nota: Qualquer destas opções de personalização não é limitativa, mais tarde ao imprimir um documento pode indicar se deseja imprimi-lo utilizando a imagem com o logotipo da empresa, utilizando a informação introduzida em texto ou, no caso de desejar utilizar o papel timbrado da sua empresa, pode definir que esta área é deixada em branco. À excepção do idioma base e da moeda base, todos os dados de configuração podem ser mais tarde alterados acedendo à área Admin na aplicação. Após clicar em Gravar será direccionado para a área de Administração onde poderá indicar outras opções de funcionamento. As opções disponíveis variam de acordo com a edição e com os módulos incluídos na sua aplicação.

Após concluídas as alterações como melhor lhe convier, pressione o botão Voltar para ter acesso à página principal da aplicação onde poderá criar fichas de cliente, de fornecedor, artigos de stock e iniciar as suas tarefas de facturação e compras.

Inserir o Logotipo nas Facturas 1) Escolha Admin no menu lateral para entrar no módulo Administração do Sistema. 2) Escolha a opção Configuração. 3) No item Impressão de Facturas e Documentos Logísticos, escolha o campo Logotipo Entidade Utilizadora e clique em Navegar para escolher a imagem que deseja inserir. A imagem deve estar num dos formatos: jpg / gif / png / bmp O tamanho recomendado para a imagem é 600x320 pixeis, podem ser escolhidos outros tamanhos desde que se mantenham as proporções altura/largura (15 : 8). Nota: 600x320 pixels são as dimensões recomendadas para o tamanho da imagem. Se quiser melhorar a qualidade de impressão do logotipo basta-lhe indicar uma imagem com dimensões superiores às sugeridas. Recorde-se que deverá manter as proporções da imagem para evitar que esta seja deformada. 4) Clique em Gravar no final da página. A imagem gravada na aplicação aparece abaixo do campo Logotipo Entidade Utilizadora. Pode também gravar uma imagem que será impressa no cabeçalho das listagens e relatórios, escolhendo a imagem que deseja utilizar no item Impressão de Listagens e Relatórios e efectuando o mesmo processo. As dimensões recomendadas para esta imagem são 600x64 pixeis.

A Primeira Factura 1) Preparar para Facturar Registe os seus artigos no ficheiro Artigos para que não tenha que repetir as suas descrições cada vez que vende um artigo. A numeração dos artigos é automática mas poderá alterar o seu valor a qualquer momento. Se tem um número elevado de itens poderá querer utilizar Famílias e Atributos para facilitar a organização do ficheiro. Registe os seus clientes no ficheiro de Clientes. Embora possa criar fichas de cliente no momento em que está a fazer a factura, aqui tem informação mais detalhada. Caso tenha um grande número de clientes poderá querer utilizar Classes e Atributos para os classificar. Se pretende um controlo de stock mais rigoroso, lembre-se de desabilitar a tolerância a stock negativo na opção Configuração do menu Admin. Neste caso deverá registar as compras e as vendas por ordem cronológica.

2) Emitir a Factura Clique em Facturação no menu à direita e seleccione o documento Factura. Clique em Novo e preencha o formulário da Factura. Clique no botão Procurar Cliente para escolher um da lista. Se é um novo cliente, marque a opção Novo e preencha os dados nome do cliente, morada, etc. Termine pressionando o botão Continuar. Verifique o número, data, condições de pagamento e restante informação do cabeçalho da factura, depois no campo Descrição das linhas do documento, escreva uma descrição do item, indique uma quantidade válida, a unidade (kg, cm, ton, etc), e o preço unitário. Pressione a tecla Enter para avançar até ao botão Gravar Linha, clicando-o de seguida. Nesta altura deverá ter adicionado uma linha ao corpo da sua factura. Se deseja referir um artigo do ficheiro Artigos na sua factura, clique no botão Artigo para escolher. Se digitar alguma informação no campo Refª Item antes de accionar o botão Artigo, o artigo com esse código será invocado. Depois, introduza ou confirme os restantes dados da linha. Termine com Gravar Linha. O seu documento deverá agora ter 2 linhas, uma de Texto outra com um Artigo. Para itens do tipo Serviço o comportamento é semelhante mas envolvendo o botão Serviço. Termine a sua factura com um clique no botão Gravar, no topo da página. Após breves instantes, a factura será apresentada na página ficando disponíveis no topo os comandos Imprimir e PDF. Use um deles para poder imprimir, prever a impressão, ou gravar o impresso da factura. Clique em Voltar ou noutra opção de menu para continuar.

2) Imprimir a Factura Para imprimir facturas e outros documentos, é necessário configurar as preferências de impressão da página do browser de forma a suprimir a informação de cabeçalho e rodapé (data, hora, endereço web), e ajustar as margens de impressão. Após este passo pode testar a impressão da factura, quer escolhendo directamente o botão IMPRIMIR, quer escolhendo a opção PDF. Perto destes comandos encontra as opções de impressão: a opção Imagem do Logotipo, a opção Layout e a opção Linhas por Página. Imprima com diversas opções até obter os resultados mais adequados ao que pretende. 2) Registe um pagamento Para registar um pagamento para esta factura, escolha o botão Facturação no menu, seleccione o documento Recibo, clique no botão Novo e escolha o Cliente. Após estes passos pressione o botão Documento por baixo do cabeçalho do documento e seleccione a factura para a qual quer emitir o recibo.

Manutenção Cópia de Segurança É fundamental fazer cópias de segurança da base de dados do Gnet para preservar a informação na eventualidade de uma falha de sistema ou perda total. A ferramenta para cópia de segurança do Gnet (Admin Cópia de Segurança) permite-lhe fazer de uma forma simples uma cópia de segurança dos dados e informação confiados ao Gnet. Esta cópia é-lhe fornecida como um ficheiro de texto com todos os comandos SQL necessários para reconstruir a base de dados do Gnet tal como estava na altura da realização da cópia de segurança. Deve utilizar um dispositivo de armazenamento externo para a guardar. Para uma estratégia de protecção de dados completa que, para além do Gnet, abranja todo o seu sistema de informação por favor consulte o seu técnico. Questões Frequentes e Updates Por favor consulte o web site Gestix Net (www.gestix.com) para questões frequentes, dificuldades de utilização, updates de software e condições de serviço. Quick Start r4 - Copyright 2006 WESTIX-TI LDA