WALK Server: Configuração

Este guia o conduzirá através do processo de configuração do WALK Server

Este guia o conduzirá através do processo de configuração do WALK Server. Assumindo que o mesmo esteja devidamente instalado, siga cuidadosamente todos os passos.

Entendendo a estrutura de diretórios

No diretório de instalação do WALK Server existem os seguintes sub-diretórios: aplicativos, download, upload e logs, os quais serão explicados abaixo.

1. Diretório de aplicativos

Neste diretório são colocados os aplicativos compilados no formato .wsxml, gerados pelo WALK Compiler.

Ao se estabelecer uma conexão entre o WALK Server e um POS, o WALK Server verifica se o aplicativo deste diretório se encontra na mesma versão do aplicativo do POS; caso a versão seja diferente, o WALK Server automaticamente atualiza a aplicação do POS.

O nome de um aplicativo deve conter 10 caracteres, e se chamar appplanobe. Este nome pode ser modificado no aplicativo inicio.xml dentro da pasta do WALK Downloader. Para mais informações verifique os guias de instalação do Framework WALK.

2. Diretório de download

Neste diretório são colocados os arquivos que serão baixados pelos terminais POS através da instrução POSXML baixaarquivo.

3. Diretório de upload

Neste diretório são colocados os arquivos que serão enviados para o WALK Server pelos terminais POS através da instrução POSXML enviaarquivo.

4. Diretório de logs

Neste diretório é criado diariamente um arquivo de log do WALK Server, onde é possível verificar vários pontos, dentre eles:

  1. Inicialização do WALK Server

  2. Status de conexões SSL

  3. Status da atualização de aplicativos

  4. Status da comunicação com o autorizador

  5. Visualização de pacotes trocados entre os terminais POS e o WALK Server

Configuração

Com um editor de textos (como o WordPad), abra o arquivo config.xml localizado no diretório de instalação do WALK Server.

Arquivo config.xml
Arquivo config.xml

1. Porta de comunicação

    <porta value="800"/>

O item de configuração porta define qual porta o WALK Server deverá utilizar para receber as conexões feitas pelos terminais POS.

2. Endereço IP do autorizador

    <ipautorizador value="127.0.0.1"/>

O item de configuração ipautorizador define o endereço IP do autorizador que o WALK Server irá se conectar.

3. Porta de comunicação do autorizador

    <portaautorizador value="15000"/>

O item de configuração portaautorizador define a porta do autorizador que o WALK Server irá se conectar.

4. URL do autorizador

    <urlautorizador value=""/>

O item de configuração urlautorizador define a URL do autorizador que o WALK Server irá se conectar.

5. Informações do autorizador informados pela aplicação

    <indexipautorizador value="-1"/>
    <indexportaautorizador value="-1"/>
    <indexurlautorizador value="-1"/>

Caso as informações do autorizador forem informados pela aplicação no terminal POS, é necessário definir a posição que o dado vem no buffer que o terminal envia.

Esta opção substitui os dados de IP, Porta e URL definidos anteriormente. Para não utilizar este recurso, deixe os parâmetros definidos com -1.

Confira este tutorial para entender o formato do pacote de dados trocado pelo terminal e o WALK Server.

6. Desabilitar SSL

    <disablessl value="false"/>

O item de configuração disablessl permite desabilitar a comunicação criptografada utilizando SSL entre o terminal e o WALK Server.

Não recomendado a não ser que exista uma VPN entre WALK Server e os terminais POS.

7. Habilitar X25

    <enableX25 value="false"/>

O item de configuração enableX25 permite que o WALK Server atenda terminais que se comuniquem utilizando o serviço RENPAC da Embratel ou similares.

8. Modo de atualização exclusiva

    <enableonlyupdate value="false"/>

O item de configuração enableonlyupdate permite utilizar o WALK Server apenas para atualização de aplicativo. Quando habilitada, o WALK Server não irá se comunicar com o autorizador, retornando a página msgOnlyUpdate definida em erros.xml, no diretório aplicativos do WALK Server.

Esta configuração é útil quando criamos aplicativos que se comunicam diretamente com o host autorizador, e precisam verificar apenas se no WALK Server existe alguma atualização.

Qualquer configuração que for alterada, você deve reiniciar o serviço do WALK Server no Windows.
Próximo: Testes →