<div class="moz-text-flowed" style="font-family: -moz-fixed">
      Servidor de banco de dados Leto  um servidor de banco de dados de vrias
      plataformas ou um banco de dados com um sistema de gerenciamento.
      Sistema destinado a Programas do Cliente escritos em x[H]arbour,
      poder trabalhar com arquivos DBF/CDX, localizados em um servidor remoto.

      1. Directory structure

      bin/          -    Arquivo executvel do servidor
      doc/          -    documentao
      include/      -    arquivos de cabealho de origem
      lib/          -    lib(Biblioteca) Rdd
      source/
          client/   -    fontes de acesso CLIENTE do rdd
          common/   -    Alguns arquivos de origem comuns
          client/   -    fontes de acesso SERVIDOR do Rdd
      tests/        -    Progamas de exemplos de uso do RDD
      utils/
          manage/   -    Utilitario de acesso ao servidor


      2. Criando binrios

      2.1 Compilador Borland Win32 C

      Uma varivel de ambiente, que define um caminho para o diretrio x[H]arbour,
      HB_PATH deve ser definida antes de compilar a LIB.
      Isso pode ser feito, por exemplo, adicionando uma linha em um make_b32.bat ou no PATH:

      SET HB_PATH=c:\harbour

      Se voc usar xHarbour, tire comentrios de uma linha ' XHARBOUR = yes ' em Makefile.BC.
      Em seguida, executar o make_b32.bat e letodb.exe arquivo executvel do servidor
      ser exibida em uma bin/diretrio e rdd rddleto.lib biblioteca em um lib/diretrio.

      2.2 Compilador Linux GNU C

      Uma varivel de ambiente, que define um caminho para o diretrio Harbour,
      HB_ROOT deve ser definida antes compilando.
      Ou apenas altere o valor de HRB_DIR na Makefile.Linux.

      Em seguida, executar o make_linux.sh e letodb arquivo executvel do servidor
      ser exibida em uma bin/diretrio e rdd librddleto.a biblioteca em um lib/diretrio.

      2.3 xHarbour Builder(Comercial)

      Execute o make_xhb.bat para construir binrios com este compilador.
      Provavelmente, voc precisar alterar o caminho para sua cpia Construtor
      de expresses na make_xhb.bat xHarbour. O valor padro :

      set XHB_PATH=c:\xhb

      3. Executando e parando servidor

      Apenas execut-lo:

      letodb.exe                    ( under Windows )
      ./letodb                      ( under Linux )

      Para o desligamento do servidor, execute o arquivo executvel mesmo com um parmetro 'stop'

      letodb.exe stop               ( under Windows )
      ./letodb stop                 ( under Linux )

      4. Configurao do servidor

      4.1 letodb.ini

      Voc pode fornecer configurao arquivo letodb.ini se voc no estiver
      satisfeito com valores parmetros padro.
      No momento existem os seguintes parmetros (padro os valores so designados):

      Port = 2812              -    Numero da porta do servidor
      DataPath = \dados        -    Um caminho para um diretrio de dados(DBF) em um servidor, esse caminho  valido apartir de onde o server do letoDB esta iniciando
      LogPath = "letodb.log"   -    caminho e o nome de um arquivo de log, nesse exemplo esta criando no mesmo diretorio onde o letodb.exe esta iniciando
      Default_Driver = CDX     -    Padro RDD para abrir arquivos no servidor ( CDX/NTX ) o Padro  CDX
      Lower_Path = 0           -    Caso seja definido como 1, vai converter todos os caminhos para minsculas
      EnableFileFunc = 0            Caso seja definido como 1, vai Ativar o uso de funes como( leto_file(),leto_ferase(), leto_frename() )
      EnableAnyExt = 0         -    Caso seja definido como 1,  Ativado a criao de arquivos de dados(DBF) e ndices com qualquer extenso, com exceo do padro (DBF, CDX, NTX)
      Pass_for_Login = 0       -    Caso seja definido como 1, a autenticao do usurio  necessria para acessar o servidor
      Pass_for_Manage = 0      -    Caso seja definido como 1, a autenticao do usurio  necessria para usar funes de gesto (Leto_mggetinfo (), etc)
      Pass_for_Data = 0        -    Caso seja definido como 1, a autenticao do usurio  necessrio ter acesso de escrita aos dados
      Pass_File = "leto_users" -    o caminho e o nome do arquivo com as informaes dos usurios
      Crypt_Traffic = 0        -    Caso seja definido como 1, passa os dados pela a rede cripitografado

       possvel definir estrutura [DATABASE] (Banco de dados) se voc precisa ter
      um diretrio, onde arquivos so abertos por outro RDD:

      [DATABASE]
      DataPath =               -    (Opo obrigatria)
      Driver = CDX             -    ( CDX/NTX )

      Voc pode definir quantas sees [DATABASE], conforme necessrio.

      No Ambiente Windows o letodb.ini deve ser colocado em um diretrio,
      de onde servidor  iniciado.

      No Linux o programa procura-lo no diretrio de onde o servidor
       iniciado e se no tiver sucesso, vai procurar no diretrio /etc.


      4.2 Autenticao

      Para ativar autenticao do subsistema voc precisa configurar um dos seguintes parmetros em
      letodb.ini a 1 : Pass_for_Login, Pass_for_Manage, Pass_for_Data.
      Mas antes voc precisa criar pelo menos um usurio com direitos administrador, porque quando autenticao
      subsistema funcionar, apenas usurios autenticados com admin direitos so capazes de acrescentar / alterar os usurios
      e as senhas.
      Para adicionar um usurio, voc precisar incluir uma chamada de LETO_USERADD () no seu lado cliente
      programa, por exemplo:
      
      LETO_USERADD( "admin", "secret:)", "YYY" )

      Onde "YYY"  uma STRING, o que confere direitos de administrador, gerenciar e escrever acesso. Voc pode
      tambm utilizar o utils/manager/console.prg programa para definir ou alterar dados de autenticao.

      Para se conectar a um servidor com uma autenticao de dados (nome de usurio e senha), voc precisar
      utilizao da Funo LETO_CONNECT()
      Abaixo um exemplo de Conexo:

      FUNCTION MAIN()
      IF ( leto_Connect( "//192.168.243.16/","USUARIO","SENHA" ) ) == -1
         nRes := leto_Connect_Err()
         IF nRes == LETO_ERR_LOGIN
            ? "Falha ao Logar"
         ELSEIF nRes == LETO_ERR_RECV
            ? "Error ao conectar"
         ELSEIF nRes == LETO_ERR_SEND
            ? "Erro de envio"
         ELSE
            ? "No connectado"
         ENDIF

         Return Nil
      ENDIF
      ? "Conectado em " + leto_GetServerVersion()
      INKEY(0)
      leto_DisConnect()
      RETURN
  
      5. A conexo com o servidor a partir de programas do cliente.

      Para poder se conectar ao servidor voc precisar vincular a rddleto.lib (Windows)
      ou librddleto.a (Linux) e no seu Aplicativo ten que adicionar no incio do seu .PRG
      principal duas linhas:

      REQUEST LETO
      RDDSETDEFAULT( "LETO" )

      Para abrir um arquivo DBF em um servidor, voc precisar escrever em uma
      instruo SET PATH TO ou no comando use diretamente um caminho para
      o servidor em um formulrio padro //ip_address:Port/data_path/Nome_Arquivo.

      Se um parmetro 'datapath' de um arquivo de configurao do servidor  definido
      como um valor no vazio, voc precisar designar no o caminho completo
      para um arquivo no servidor, mas somente uma relativa (relativamente a ' Datapath').

      Por exemplo, se voc precisar abrir um arquivo Test.dbf, que est localizado
      no valor de parmetro (de um arquivo de configurao do servidor letodb.ini)
      Servidor 192.168.5.22 em um diretrio /dados Mydir e o 'datapath'  ' / Dados ',
      a sintaxe ser o seguinte:

      USE "//192.168.5.22:2812/mydir/test"

      Se o servidor no executa ou voc escrever um caminho errado, voc ter erros de execuo.
       possvel verificar acessibilidade de um servidor antes de abrir arquivos usando
      a funo leto_Connect (cAddress), que retorna "-1" no caso de tentativa sem xito:

      Se o servidor no executar ou voc escreve um caminho errado, voc ter erros de execuo.
       possvel verificar a acessibilidade de um servidor antes de abrir arquivos usando
      a funo leto_Connect (cAddress) , que retorna -1 no caso de tentativa sem xito:

      Exemplo:
      IF leto_Connect( "//192.168.5.22:2812/mydir/" ) == -1
         Alert( "Can't connect to server ..." )
      ENDIF

      6. Utilitrio de gerenciamento.

      H dois utilitrios de gerenciamento, interface grfica com o usurio
      e do console, as fontes esto no diretrio utils/manage.

      O utilitrio GUI, Manage.prg,  feita com a biblioteca HwGUI.
      Se tiver HwGUI, basta escrever na linha ' set HWGUI_INSTALL= ""
      do arquivo utils/Manage/BLD.bat um caminho para o diretrio HwGUI
      e executar o BLD.bat, ele criar Manage.exe para voc.

      Para aqueles, que no usam HwGUI, h um utilitrio Modo de console,
      console.prg. Para criar um console.exe, voc pode usar para criar programas
      o hbmake do x[H]arbour e o hbmk2 no Harbour, voc precisa apenas adicionar rddleto.lib  lista de bibliotecas externas.
      Execute o console.exe com um servidor Nome ou IP e porta como um parmetro:

      Exexmplos:
      console.exe server_name:nPort
      console.exe ip_address:nPort
      console.exe 192.168.254.17:2812

      O nome_do_servidor e endereo_IP em uma linha de comando devem
      ser sem zeros  esquerda barras ('//'), pois interpreta Clipper/Harbour
      de maneira especial.

      7. Algumas observaes extras:
      - O letodb.exe que vai rodar como um servio no servidor usando a porta 2812, ento tem
      que liberar essa porta no modem do servidor dando redirecionamento para o IP do servidor LETODB.
      Esse letodb.exe pode rodar de qualquer lugar ou seja qualquer pasta do servidor.
      - Ao finalizar o Aplicativo deve encerrar a conexo com LETO_DISCONNECT()
      - Incluir em Pontos estratgico do sistema o uso de leto_BeginTransaction(), leto_Rollback() e
      leto_CommitTransaction() na pasta \letodb\tests\ tem exemplo de uso.


Nota: Texto originalmente escrito por Alexander Kresin e traduzido por Leonardo Machado </div>