1. Sumário

...

1. Introdução (Sumário)

Requisitos de Software para o Portal de Mobilidade
Requisitos de Hardware para o Portal de Mobilidade
Observação
Informações Importantes
Instalação
Atualização
Informações adicionais

LISTA DE FIGURAS
Figura 1 - Menu Parâmetros Iniciais
Figura 2 - Menu Instalação
Figura 3 - Menu Banco de Dados
Figura 4 - Menu Acesso
Figura 5 - Resultado dos testes
Figura 6 - Informações da Licença
Figura 7 - Dados usuário admin
Figura 8 - Botão Setup Concluído
Figura 9 - Menu Parâmetros Iniciais
Figura 10 - Menu Instalação
Figura 11 - Resultado dos testes
Figura 12 - Editar Permissões do site no IIS
Figura 13 - Aba segurança
Figura 14 - Alterando permissões de usuário
Figura 15 - Removendo "Somente Leitura"
Figura 16 - Executando scripts de atualização do banco de dados
Figura 17 - Menu administrador
Figura 18 - Menu Importar Licença
Figura 19 - Importar chave de licença
Figura 20 - Importar Serviços
Figura 21 - Importação de Serviços

...

Introdução 

Âncora

...

teste

...

teste

...

Image Added

O Portal de Mobilidade O Portal de Mobilidade tem como objetivo integrar os aplicativos moveis referente aos apontamentos de campo para os sistemas PIMS Cana e/ou PIMS Multicultivos, permitindo um melhor controle dos dispositivos utilizados e prover controles/funcionalidades que possibilitem um processo de gestão a vista.
Visando a utilização desta ferramenta, foi desenvolvido um Manual para auxiliar o processo de sua instalação através de um Wizard (Instalador).

Âncora

...

RequisitosSoftware

...

RequisitosSoftware

Requisitos de

...

software para o Portal de Mobilidade 

• Ambiente computacional deve ser estável.
• Windows Server 2008 R2 ou Windows Server 2012.
• Instalação do IIS 7.5 ou superior:
  • Para a hospedagem e configuração do Portal no Servidor, tecnologia .NET.
• Incluir no IIS a extensão .apk e o tipo application/vnd.android.package-archive para serem servidos como conteúdo estático pelo servidor (tipos de MIME).
• Instalação .Net Framework 4:
  • Tecnologia envolvida no desenvolvimento do Portal
• SQLServer Express 2008 R2
  • Usado para armazenar os dados que são configurados dinamicamente no Portal, como, serviços e visões dos relatórios e indicadores do Portal.
  • O usuário utilizado para acessar a base do Portal deve possuir privilégios "root"
• Oracle Client ou Oracle Server (Integrado com a Produção)
  • Utilizado para acessar a base de dados do PIMS
  • O formato do horário no registro do Windows deve seguir o padrão Americano

Âncora

...

RequisitosHardware

...

RequisitosHardware

Requisitos de

...

hardware para o Portal de Mobilidade 

Plataforma: Necessário um servidor para a instalação do Portal, não necessariamente dedicado, que possua uma arquitetura de 32 ou 64 bits. É recomendado utilizar uma arquitetura de 64 bits, já que esta arquitetura suporta a utilização de mais de 4GB de RAM, tendo-se assim um melhor desempenho do servidor.

• Sistema operacional: exige-se a utilização do Windows Server 2008 ou Windows Server 2012. O sistema operacional também deve ser compatível com a arquitetura do Servidor 32 ou 64 bits.
• Memória RAM: 4GB disponíveis por instância;
• Processador: Dual Core 2.0 GHZ ou XEON 2.0 GHZ
• Espaço em Disco: 10GB (o espaço em disco total leva em conta os espaços requeridos pela instalação do .NET, pelo Servidor de aplicações IIS. Entretanto, caso o servidor armazene o banco de dados do PIMS, deve ser considerado à parte o espaço necessário).
• Rede: É necessário que o Servidor esteja em Rede, tanto para acesso interno ou externo. O acesso externo é necessário para que os dispositivos, que estão no campo, tenham acesso aos cadastros.

Âncora

...

Obs

...

Obs

Observação 

Os Acessos ao Portal e aos serviços usam o Protocolo HTTP.

Âncora

...

InfoImportantes

...

InfoImportantes

Informações Importantes 

• Antes de iniciar o processo de instalação faça a aquisição das Licenças de Uso junto ao setor comercial da Totvs.

• Certifique-se de que o servidor no qual será instalado o Portal de Mobilidade possua todas as liberações para acessar o IP 189138.16219.10588.147222.

• O Instalador deve ser executado com permissões de administrador

...

• Quando executado o processo de atualização via instalador, o mesmo realiza automaticamente um backup do Portal de Mobilidade atual. Esse backup O bakcup será salvo no seguinte diretório um diretório acima do diretório de instalação do Portal. Exemplo:
  • Instalação do Portal em C:\
  inetpub\backup
  • PortalDeMobilidade
  • Diretório de Backup C:\Backup\<nome do site> + data do backup 

• É extremamente importante que seja realizado um backup manual do Portal de Mobilidade, para prevenir algum problema no backup automático realizado pelo instalador, para isso, copie todo o diretório do Portal de Mobilidade atual, geralmente localizado em C:\inetpub\PortalMobile.

Âncora
Instalacao Instalacao

Instalação

Image Added _Toc464655834_Toc464655834Instalação 

Antes de iniciar o processo de instalação do Portal de Mobilidade é necessário que sejam cumpridos todos os pré-requisitos citados nos itens acima.

...

O menu parâmetros iniciais permite escolher o aplicativo PIMS (PIMS Cana ou PIMS Multicultivos), o SGBD (Sistema Gerenciador de Banco de Dados) do Pims, a operação que será realizada Instalação ou Atualização, o tipo da instalação (Teste ou Produção), a configuração do License Server (Ativar - Se irá utilizar o License Server para gerenciar as licenças, IP - Endereço IP do License Server, Porta - Porta do License Server) e o protocolo de instalação (HTTP ou HTTPS). Para instalar o Portal de Mobilidade selecione o Aplicativo PIMS, o SGBD, marque a opção Instalação, selecione o tipo de instalação, escolha o protocolo de instalação e clique no botão avançar. O idioma do instalador segue o idioma do Sistema Operacional.

Menu Instalação
Image RemovedImage Added

...

• ID do cliente (campo obrigatório)
  • Deve conter a ID única do cliente registrada na Totvs para uso do Portal de Mobilidade. Essa ID deve ser fornecida ao cliente junto com o fechamento do contrato.
  E-mail
  • Inserir o e-mail para o qual deseja que seja enviada o Código da licença de uso do Portal de Mobilidade. O código é único e exclusivo e contém a quantidade de dispositivos liberados, os aplicativos e o tempo liberado para uso do Portal de Mobilidade.
• Código da Licença (campo obrigatório)
  • Inserir o código enviado pela TOTVS
• Nome do Site (campo obrigatório)
  • O nome informado nesse campo será usado na criação do diretório de instalação (Exemplo: Se optar por instalar em C:\, o Portal será instalado em C:\<Valor colocado no campo Nome do Site>) e também será utilizado como o nome do site no IIS
• Escolha o Escolha o local para instalar o Portal (campo obrigatório)
  • Indique o diretório onde o Portal de Mobilidade será instalado. O diretório sugerido é C:\inetpub

...

Após concluir as configurações e clicar no botão "Validar", o instalador do Portal de Mobilidade realiza automaticamente alguns testes para validar as configurações.
Os ícones abaixo indicam o resultado dos testes:
- Erro
- Sucesso
- Aviso

OBS**: Caso ocorra um erro nos itens "StringConnection", "MembershipApi" e "Write", a instalação do Portal de Mobilidade não é concluída, sendo necessário clicar no botão corrigir e rever as configurações realizadas. Caso não haja erro nos itens anteriormente citados o instalador permite concluir a instalação, pois, erros nem itens subsequentes não impedem o funcionamento total do é concluída, sendo necessário clicar no botão corrigir e rever as configurações realizadas. Caso não haja erro nos itens anteriormente citados o instalador permite concluir a instalação, pois, erros nem itens subsequentes não impedem o funcionamento total do Portal de Mobilidade.

OBS**: No caso de erros de "StringConnection" e "Membership API", e os parâmetros de conexão com o Banco de Dados/Portas estiverem corretos, após clicar no botão "Corrigir" para uma nova análise, é sugerido que o usuário PARE OS SERVIÇOS DO IIS, pois, caso possua alguma outra configuração prévia, poderá ocorrer um conflito entre as portas utilizadas na instalação. Após finalizada a mesma, e as mensagens estiverem OK, basta reiniciar os serviços do IIS Portal de Mobilidade.

Após clicar no botão Concluir o instalador do Portal de Mobilidade tentará se comunicar com os servidores da Totvs TOTVS para fazer a liberação dos aplicativos de acordo com a sua Licença, havendo sucesso nessa comunicação, serão exibidas na tela as informações da sua licença, como na imagem abaixo:

...

Clicando no botão "Ok", será exibida a mensagem de que a instalação está concluída, em seguida a mensagem para fechar o instalador, após fechar o instalador, uma janela do navegador padrão será aberta, nessa janela serão executados alguns testes diretamente no Portal de Mobilidade, tendo sucesso nesses testes clique no botão "Sim, setup completo" ao final da página. Será aberta a tela inicial o Portal de Mobilidade.

Âncora
Atualizacao

...

Atualizacao

...

Atualização

...

Image Added 

Antes de iniciar o processo de atualização do Portal de Mobilidade é necessário parar o Site no IIS (Internet Information Service) e aguardar no mínimo 5 minutos antes de iniciar o processo de atualização.

...

O menu parâmetros iniciais permite escolher o aplicativo PIMS (PIMS Cana ou PIMS Multicultivos), o SGBD (Sistema Gerenciador de Banco de Dados) do Pims, a operação que será realizada Instalação ou Atualização e o tipo da instalação (Trial ou Produção). Para atualizar o Portal de Mobilidade, selecione o Aplicativo PIMS, marque a opção atualização  (ao marcar a opção de atualização a seleção do protocolo ficará desabilitada) e clique no botão para indicar onde está instalado o Portal de Mobilidade que será atualizado, e selecione o tipo de instalação (Teste ou Produção), após, clique em Avançar. O idioma do instalador segue o idioma do Sistema Operacional.

Menu Instalação
Image RemovedImage Added

...

• ID do cliente (campo obrigatório)
  • Contém a ID única do cliente registrada na Totvs para uso do Portal de Mobilidade. Essa ID é recuperada das configurações atuais do Portal de Mobilidade
• E-mail
  • Inserir o e-mail para o qual deseja que seja enviada a chave de licença de uso do Portal de Mobilidade. A chave é única e exclusiva e contém a quantidade de dispositivos liberados, os aplicativos e o tempo liberado para uso do Portal de Mobilidade.
• Chave (campo obrigatório)
  • Inserir a chave enviada pela TOTVS
• Chave (campo obrigatório)
  • Inserir a chave enviada pela TOTVS
• Nome do Site (campo obrigatório)
  • O nome informado nesse campo será usado na criação do diretório de instalação (Exemplo: Se optar por instalar em C:\, o Portal será instalado em C:\<Valor colocado no campo Nome do Site>) e também será utilizado como o nome do site no IIS
• Escolha o local para instalar o Portal (campo obrigatório)
  • Indica o local da instalação do Portal de Mobilidade que será atualizada.

...

1. Caso ainda não possua a chave de licença, preencha o campo E-mail com o e-mail no qual deseja receber a chave e clique no botão , caso o e-mail tenha sido enviado para a TOTVS o seguinte ícone é exibido , se não foi possível enviar o e-mail para a TOTVS o ícone é exibido. Caso não receba uma resposta da TOTVS com a chave favor entrar em contato pelo telefone (18) 3302-1200.
2. Em posse da chave de licença insira no campo Chave e clique no botão . Caso a chave seja válida o seguinte ícone é exibido , se se a chave não for válida o ícone é exibido. Somente é possível prosseguir com a instalação se a chave de licença for válida.

Âncora

...

InfoAdicional

...

InfoAdicional

Informações adicionais 

Instalação em ambiente de teste

Para realizar a instalação em ambiente de teste é necessário ecessário entrar em contato com a TOTVS para que seja gerada uma ID de cliente com liberação de instalação ou atualização de um ambiente de teste. Após negociado com a TOTVS será liberada uma ID e Chave de licença contendo os aplicativos que forem negociados e o ambiente de teste ficará disponível por 30 dias a partir da data de geração da chave de licença. A instalação do ambiente de teste deve ser realizada em no máximo 24 horas após a liberação da chave de licença, pois, ela é válida apenas por 24 horas após a sua geração. Se não for possível realizar a instalação dentro das 24 horas, será necessário entrar novamente em contato com a TOTVS para geração de uma nova chave de licença.
Liberar permissões de acesso ao diretório de instalação do Portal de Mobilidade através do IIS
Após clicar em "Validar" na tela de Acesso (Figura 4) a tela de resultado dos testes é exibida (Figura 10).

...

Atualizar o banco de dados
Após concluir a instalação abra a url http://localhost/Setup/Base.aspx (onde localhost é o endereço principal de acesso ao Portal de Mobilidade. Feito isso serão executados os scripts de atualização do banco de dados.

...

Na tela seguinte (Figura 18) inclua a sua chave de licença e clique em "Importar Configuração", caso não seja possível importar, solicite junto a Totvs o arquivo da sua licença, para importa-lo clique em "Upload License" e indique o arquivo enviado pela Totvs. Após isso o Portal de Mobilidade terá toda as informações referentes a duração da licença, quantidade de dispositivos e aplicativos liberados.

Importação de serviços

Após realizar a instalação é necessário fazer a importação dos serviços que serão utilizados no Portal, para isso vá até o menu "Administrador" (Figura 16). Navegue até o item "Importar Serviços" (Figura 19).

...