======= Introdução =======
Este documento demonstra como instalar e configurar o Cliente Q-WARE /FDS.

Q-WARE/FDS é um conjunto de aplicações integradas para propagação de dados. Isto
significa que o sistema pode transportar arquivos de forma controlada, disparar aplicações para processar tais arquivos, registrar todos os eventos ocorridos durante os processos, transportar arquivos e controlar a utilização de bandas da rede de comunicação. A divisão funcional em “controle” e “transporte” implica naturalmente a implementação de dois conjuntos de programas. O QWARE é o sistema de controle, e o FDS, o sistema de transporte. O File Delivery System (FDS) é um sistema de transferência de arquivos desenvolvido sobre o Q-WARE. Ele é composto de um conjunto de clientes, aplicações, serviços, plugins e tratadores de eventos do Q-WARE. O transporte dos arquivos é feito através de filas.

O FDS transfere arquivos de uma localidade para outra com absoluta transparência de movimentos e total segurança. Além disto, o FDS possui recursos que facilitam a integração de aplicações locais ou remotas.

=== IMPORTANTE ===
Para ter as informações solicitada na instalação do Qware é necessário realizar uma solicitação pelo [[https://sta.tesouro.fazenda.gov.br/AJUDA/ajuda_qware.htm|Portal SIAFI - Serviço de Download do SIAFI]]. Então, irão receber email com as instruções de como instalar e configurar o Qware.
======= Instalação com suporte a pacotes .RPM e .DEB =======

A instalação utilizando pacotes .RPM é parecido com a instalação utilizando pacotes .DEB. A diferença acontece somente para executar a instalação.

**Pacote .RPM**

Os requisitos necessários para instalação é um Sistema Operacional Linux 32 bits que tenha suporte nativo a pacotes .RPM (Suse, RedHat...). Com usuário root execute o RPM chamado QwareFDSClient-2.3.0.1-2.i386.rpm com o comando: 
<code>rpm –ivh QwareFDSClient-2.3.0.1-2.i386.rpm</code>
Se acontecer algum problema devido à falta de algum lib, execute o comando abaixo, pois a instalação utilizando pacotes .RPM não necessita de nenhuma dependência. 
<code>rpm –ivh QwareFDSClient-2.3.0.1-2.i386.rpm --nodeps</code>
Será criado no sistema operacional um usuário chamado “qware” no grupo “users” que será dono de todos os arquivos que será gerado dentro do diretório padrão: 
<code>/opt/qware</code> 
Em seguida será pedido para executar o script localizado dentro de:
<code> /opt/qware/setup.sh </code>

{{ :cooperacao:tutoriais:image-0.png }}

**Pacote .DEB**

Os requisitos necessários para a instalação é um Sistema Operacional Linux 32 bits que tenha suporte nativo a pacotes .DEB (Debian, Ubuntu). Com usuário root execute o pacote .deb chamado "qwarefdsclient_2.3.0.2_i386.deb" com o comando:
<code> dpkg –i qwarefdsclient_2.3.0.2_i386.deb</code>
Se acontecer algum problema devido à falta de algum pacote ou lib, como por exemplo, faltando a lib: libstdc++5, instale a lib executando o comando apt-get install libstdc++5.

Será criado no sistema operacional um usuário chamado “qware” no grupo “users” que será dono de todos os arquivos que será gerado dentro do diretório padrão: /opt/qware. 

A partir desses passos citados anteriormente o processo de instalação é o mesmo para os dois tipos de pacotes. 

Como na figura abaixo será necessário inserir o usuário e uma senha que será utilizado para gerenciar o Q-Ware, lembrando que esse usuário não pode conter mais do que 14 caracteres e a senha não pode conter caracteres especiais como: (*) asterisco, (?) interrogação, (-) hifem, (.) ponto, (,) virgula, ( () ) parênteses, (“) aspas, (‘) apóstrofos, ([]) colchetes, ({})
chaves, (#) sustenido, (@) arrouba, (!) exclamação, (&) E comercial, ($) cifrão, (+) adição, ( = ) igual, (%) porcento, ( ) brancos, (;) ponto-e-vírgula, (:) dois-pontos, (/\|) barras, (^~ ́` ̈) acentos, (ãõâêîôûáéíóúàèìòùñäë ïöü). O Q-Ware FDS por padrão será instalado com autenticação interna do próprio Q-Ware.

{{ :cooperacao:tutoriais:image-1.png }}

Logo depois que for inserido o usuário e a senha, será exibido uma tela igual da figura abaixo perguntando se deseja realmente configurar os dados fornecidos. Pressione Enter para confirmar os parâmetros.

{{ :cooperacao:tutoriais:image-2.png }}

Em seguida será pedido para inserir o IP de conexão com o servidor do Serpro, como na figura abaixo.
{{ :cooperacao:tutoriais:image-nn3.png }}

Logo será necessário adicionar a porta de conexão do Serpro como na figura abaixo. Lembrando de sempre solicitar para o administrador da rede onde está sendo instalado o Q-Ware para liberar a porta de conexão no firewall.

{{ :cooperacao:tutoriais:image-n4.png }}

Em seguida será necessário adicionar o usuário que o Serpro fornece.

{{ :cooperacao:tutoriais:image-n5.1.png }}

Em seguida será necessário fornecer a senha criptografada que também é fornecida pelo Serpro.

{{ :cooperacao:tutoriais:image-n6.1.png }}

O diretório padrão onde serão recebidos e enviados os arquivos é: /opt/pobox recomenda-se manter o diretório padrão. Para manter a pasta padrão pressione Enter.

{{ :cooperacao:tutoriais:image-n7.1.png }}

Se tudo tiver correto o Q-Ware será exibido uma frase de sucesso. O Q-Ware inicia todos os serviços criados automaticamente.

======= Problemas na instalação =======
O servidor desenvolvimento.ufrn.br está rodando um sistema operacional 64 bits. E o Q-ware está disponível na versão 32 bits. Para contornar este problema, deve-se instalar as suite de ferramentas ia32 Suite.

Para instalar o pacote ia32-libs use o comando:
<code> sudo aptitude install ia32-libs </code>

E para continuar a instalação use o comando:
<code>sudo dpkg -i --force-architecture Qwarefdsclient_2.3.0.2_i386.deb</code>


======= Links Úteis =======
  * Instalar libstdc++5 no Ubuntu 9.10 ou 10.04 - http://www.hackourlives.com/ubuntu-10-04-lucid-lynx-libstdc-so-5/