Documentação do guia de instalação e atualização

1.Prefácio #

O objetivo deste documento é explicar os requisitos de instalação, pré-requisitos, etapas de instalação e configuração, procedimentos de atualização e etapas de desinstalação da sua solução de software.

2.Preparação da instalação #

2.1.Requisitos de instalação #

  • Instalador XPressEntry (versão mais recente) e arquivo de licença. São necessários direitos de administrador para a instalação.
  • As portas do Firewall do Windows 30000 / 30001 abriram para o executável XPressEntryService. Isso é necessário para que os dispositivos portáteis encontrem o servidor.

2.2.Pré-requisitos de instalação #

  • Windows 7 / Windows Server 2012 ou mais recente,> = 8 GB de RAM
  • .NET Framework 4.7.2
  • 20 GB de espaço livre em disco para instalações muito grandes.
  • Uma conta de serviço de domínio do Windows (ou usuário local, se não houver domínio) para o XPressEntry Service. Será definido como proprietário do banco de dados ou leitor/gravador do banco de dados XPressEntry SQL Server.
  • SQL Server ou SQL Server Express instalado e disponível localmente ou dentro da rede.

3.Instalação do XPressEntry #

3.1.Execute o instalador XPressEntry MSI #

  1. Execute o XPressEntry MSI Installer.
  2. Selecione o local para instalar o XPressEntry
  3.  
    instalação xpressentry
     

  4. Quando a instalação estiver concluída, selecione Fechar.
  5.  
    instalação xpressentry concluída

3.2.Configuração do serviço XPressEntry #

É necessária uma conta de serviço do Windows para acesso à conexão confiável do banco de dados do SQL Server.
 
NOTA: Se a conta de serviço do Windows que será usada NÃO É um administrador na máquina Windows, primeiro Inicie o Serviço XPressEntry pela primeira vez como Sistema Local e pare o serviço antes de continuar.
 

  1. Abra os serviços do Windows. Procure o serviço XPressEntry, clique com o botão direito do mouse e clique em Propriedades.
  2.  
    serviço xpressentry
     

  3. Clique Log On Aba.
  4. Clique Esta contae insira as informações da conta de serviço de domínio do Windows que serão usadas para conectar-se ao SQL Server. Clique em Aplicar.
  5.  
    propriedades do serviço xpressentry
     

3.3.Configurar o SQL Server #

SQL Server

  1. Abra o SQL Server Management Studio. Entre com uma conta com acesso de administrador de banco de dados.
  2.  
    Servidor SQL
     

  3. Na janela Pesquisador de Objetos, clique com o botão direito do mouse Bases de dados e clique Novo banco de dados… Nomeie o banco de dados para o banco de dados XPressEntry. Clique OK.
  4.  
    xpressentry novo banco de dados
     

  5. Em seguida, precisamos conceder à conta de serviço do Windows dbo.owner acesso ao banco de dados XPressEntry recém-criado. Na janela Explorador de Objetos, expanda Segurançae clique com o botão direito logins. Clique Novo Login… Pesquise ou adicione a conta de serviço do Windows para o Nome de login.
  6.  
    login do xpressentry
     

  7. Clique em Mapeamento do usuário à esquerda Selecione uma página janela. Procure o banco de dados recém-criado e marque a caixa Mapa. Abaixo, no Associação à função de banco de dados, Verifica db_ownerou separadamente, combinação de db_datareader e db_datawriter. Db_owner substitui db_datareader e db_datawriter Clique em OK.
  8.  
    propriedades de login
     

  9. Vá para o local em que o XPressEntry foi instalado ou procure no XPressEntryDatabaseTool no menu Iniciar do Windows. Execute o XPressEntryDatabaseTool.exe
  10. Qualquer usuário do Windows que acessará o XPressEntryDatabaseTool exigirá acesso ao db_owner para executar migrações de banco de dados. A execução do XPressEntryDatabaseTool como o usuário do Windows de serviço simplificará o processo se estiver definido como db_owner.
  11. Quaisquer usuários do Windows que acessarão o XPressEntry Server Application também precisarão do acesso db_datareader e db_datawriter. Isso pode ser atribuído aos usuários do domínio ou explicitamente apenas aos administradores ou usuários específicos.
  12.  
    ferramenta de banco de dados xpressentry
     

  13. Adicionar a licença XPressEntry - Clique em Procurar arquivo de licença e adicione o arquivo de licença fornecido pela Telaeris. Se for bem-sucedida, a página Sobre o XPressEntry será fechada.
  14.  
    licença xpressentry
     

  15. Clique Alterar / definir o banco de dados
  16.  
    xpressentry define o banco de dados
     

  17. Defina as informações do servidor do banco de dados do SQL Server e clique em Carregar banco de dados.
  18.  
    conexão com o banco de dados xpressentry
     

  19. Selecione o banco de dados XPressEntry ao qual se conectar e clique em Concluir.
  20.  
    xpressentry configure e conecte o banco de dados
     

  21. Clique Validar que o usuário atual é o proprietário.
  22.  
    usuário atual do xpressentry
     

  23. Clique Executar criação / migração de tabela.
  24.  
    criação de tabela de execução xpressentry
     

  25. A conexão com o banco de dados é configurada corretamente quando Sucesso da Conexão com o Banco de Dados, Usuário Atual é db_owner e a Versão do Banco de Dados está atualizada.
  26. Se o XPressEntryDatabaseTool estiver sendo executado como administrador, você poderá parar ou iniciar o serviço XPressEntry. Não há problema em parar o serviço com o ícone X vermelho.
  27. Verificar API verificará se a rota da API está funcionando corretamente. Isso requer que o serviço seja iniciado.
  28. A opção Verificar permissões de serviço verificará se o usuário Logon do serviço XPressEntry possui permissões de leitura e gravação adequadas no banco de dados XPressEntry.
  29.  
    permissões de serviço xpressentry
     
     
    administrador do xpressentry
     

3.4.Solução de problemas do banco de dados #

  1. Você pode clicar duas vezes em qualquer caixa de erro para exibir a mensagem completa.
  2. Se o usuário conectado ao Windows não tiver acesso de leitor ou gravação ao banco de dados XPressEntry, você verá a seguinte mensagem de erro durante a abertura ou quando clicar em Verificar conexão. Atribua acesso de leitura e gravação adequado ao usuário atual do Windows.

 
banco de dados xpressentry

4.Atualizando o XPressEntry #

  1. Execute o XPressEntry MSI Installer e / ou o Datamanager Plugin Installer específico.
  2. Selecione o local para instalar o XPressEntry.
  3.  
    instalação xpressentry
     

  4. Quando a instalação estiver concluída, selecione Fechar.
  5.  
    instalação xpressentry concluída
     

  6. Vá para o local em que o XPressEntry foi instalado ou procure no XPressEntryDatabaseTool no menu Iniciar do Windows. Execute o XPressEntryDatabaseTool.exe
  7.  
    ferramenta de banco de dados xpressentry
     

  8. Verifique a versão da migração de banco de dados clicando em verifique a migração. Se a versão de migração precisar ser atualizada para a versão mais recente, selecione Executar criação / migração de tabela. Se a versão de migração estiver atualizada, A versão do banco de dados está atualizada em [VERSION].
  9.  
    criação de tabela de execução xpressentry
     
     

    migração de verificação xpressentry
     

  10. Clique Pronto . Inicie o XPressEntryService.

5.Desinstalando o XPressEntry #

  1. Pare o XPressEntryService.
  2. Execute o XPressEntry MSI Installer ou o XPressEntry Datamanager Plugin Installer específico. Selecione Remover XPressEntry.
  3.  
    remover xpressentry
     

  4. Selecionar todo o mundo. Clique Próximo.
  5.  
    desinstalar o xpressentry
     

Sugerir Editar