CS – Manutenção Automotiva  
Histórico de Revisão

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 

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).

Requisitos de software para o Portal de Mobilidade 

• Ambiente computacional deve ser estável.
• 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

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 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 2012. O sistema operacional também deve ser compatível com a arquitetura do Servidor 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.

Observação 

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

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 138.219.88.222.

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

• Para uso do banco de dados do Portal de Mobilidade anexado ao SQ Server Management Studio é necessário que o usuário utilizado para se conectar ao banco de dados tenha acesso root ao banco, pois, será necessário realizar a criação de novas tabelas.

• Quando executado o processo de atualização via instalador, o mesmo realiza automaticamente um backup do Portal de Mobilidade atual. O bakcup será salvo um diretório acima do diretório de instalação do Portal. Exemplo:
  • Instalação do Portal em C:\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.

Instalaçã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.

Menu Parâmetros Iniciais

Figura 1 - Menu Parâmetros Iniciais

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

Figura 2 - Menu Instalação

No menu instalação é necessário realizar as seguintes configurações:

• 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.
• 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 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

Como fazer:

1. Insira a ID do cliente e clique no botão . A ID será enviada aos servidores da TOTVS para validação, após alguns segundos o instalador receberá uma resposta, caso a ID seja válida será exibido na frente do campo o ícone , caso a ID não seja válida será exibido o ícone , se não foi possível realizar a comunicação com os servidores TOTVS será exibido o ícone . Somente é permito prosseguir com a instalação caso a ID do cliente seja válida ou se não foi possível realizar a comunicação com os servidores da TOTVS.
2. 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.
3. 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.
4. Escolha o diretório para a instalação do Portal de Mobilidade. O diretório sugerido é C:\inetpub, caso queira escolher outro diretório, basta digitar o caminho desejado, ou procurar um diretório clicando no ícone .

Menu Banco de Dados

Figura 3 - Menu Banco de Dados
No menu Banco de Dados é realizada a configuração do banco de dados do Portal de Mobilidade, esse banco de dados não é o do PIMS, mas, sim o banco de dados no qual o Portal de Mobilidade fará uso para guardar e buscar as suas configurações e outros dados necessários para o seu funcionamento. O banco de dados pode ser utilizado de duas maneiras, uma delas é a utilização de um arquivo MDF e a outra é a utilização de um banco de dados anexado ao SQL Server, através do SQL Server Management Studio.
Para utilizar o banco de diretamente de um arquivo MDF, marque a opção "Utiliza banco de dados em arquivo" fazendo isso o é liberado o campo para indicar o diretório onde está localizado o arquivo MDF, clique no botão e localize o arquivo MDF, no campo "Servidor\Instância coloque o nome do Instância do SQL Server instalado no servidor, os campos "Banco", "Usuário" e "Senha" são desabilitados, já que, não há necessidade de preencher essas informações.
No menu banco de dados é necessário realizar as seguintes configurações:

• Servidor\Instância (campo obrigatório)
  • Nome ou IP do servidor mais a Instância do SQL Server (se existir) separados por barra ().
• Banco (campo obrigatório)
  • Nome do banco de dados do servidor SQL.
• Usuário (campo obrigatório)
  • Nome do usuário para acesso ao banco de dados
• Senha (campo obrigatório)
  • Senha para acessar o banco de dados

Menu Acesso

Figura 4 - Menu Acesso

No menu Acesso devem ser configuradas as informações de Acesso ao Portal de Mobilidade. Ao abrir os campos são preenchidos com valores padrão, esses valores servem como exemplo de preenchimento dos campos.
No menu acesso é necessário realizar as seguintes configurações:

• Porta (campo obrigatório)
  • A porta reservada para o site do Portal de Mobilidade
• Endereço Principal (campo obrigatório)
  • Principal endereço de acesso ao Portal de Mobilidade, geralmente configurado com o endereço IP externo. Não é necessário incluir a porta nesse campo.
• E-mail do administrador (campo obrigatório)
  • E-mail do administrador do Portal de Mobilidade
• Lista de IPs de Acesso (campo obrigatório)
  • Lista de IPs que permitiram acessar o Portal, geralmente preenchido com localhost, IP interno do servidor e IP externo do servidor sem necessidade de incluir a porta e separados com ; (ponto e vírgula)
• ID do cliente (campo obrigatório)
  • Esse campo exibe a ID do cliente informada no menu Instalação.
• Criar Virtual Path
  • Marcar essa opção caso o Portal de Mobilidade seja instalado em um virtual path.

Resultado dos testes

Figura 5 - Resultado dos testes

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 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.

Após clicar no botão Concluir o instalador do Portal de Mobilidade tentará se comunicar com os servidores da 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:

Figura 6 - Informações da Licença

Juntamente com a configuração da licença o instalador criará um usuário "admin" utilizando como nome de usuário o e-mail informado na Tela Acesso, campo E-mail do administrado (Figura 4) e a senha totvs@123. Essas informações também são exibidas na tela.

Figura 7 - Dados usuário admin

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.

Figura 8 - Botão Setup Concluído

Atualização

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.

Menu Parâmetros Iniciais

Figura 9 - Menu Parâmetros Iniciais

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

Figura 10 - Menu Instalação

No menu instalação é necessário realizar as seguintes configurações:

• 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
• 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.

Como fazer:

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.

Informações adicionais 

Instalação em ambiente de teste

Para realizar a instalação em ambiente de teste é 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).

Figura 11 - Resultado dos testes

Havendo erros ou não, antes de corrigir ou concluir a instalação, execute os seguintes procedimentos:

• Abra o IIS (Internet Information Service), clique com o botão direito sobre o nome do Site Portal de Mobilidade e clique em "Editar Permissões"

Figura 12 - Editar Permissões do site no IIS

• Clique na aba "Segurança" e clique no botão "Editar" abaixo das informações de "Nomes de grupo e de usuário"

Figura 13 - Aba segurança

• Para cada "Nome de grupo ou de Usuário" marque a opção "Permitir" na permissão "Controle Total" e clique no botão "Aplicar" e depois no botão "OK"

Figura 14 - Alterando permissões de usuário

• Clique na aba "Geral", desmarque o atributo "Somente Leitura", clique no botão "Aplicar" e depois no botão "OK"

Figura 15 - Removendo "Somente Leitura"

• Volte ao instalador, conclua a instalação ou clique em "Corrigir" caso o botão "Concluir" não esteja habilitado e verifique se todas as configurações estão corretas, caso o botão "Concluir" esteja habilitado, conclua a instalação.

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.

Figura 16 - Executando scripts de atualização do banco de dados



Importar Licença através do Portal de Mobilidade
Caso o servidor de onde será instalado o Portal de Mobilidade não possua acesso ao servidor da Totvs localizado no IP 138.219.88.222 será necessário realizar manualmente a importação da Licença através do Portal de Mobilidade. Para isso vá até o menu "Administrador" (Figura 16).

Figura 17 - Menu administrador

Navegue até o item "Importar Licença" (Figura 17).

Figura 18 - Menu Importar Licença

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.

Figura 19 - Importar chave de licença

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).

Figura 20 - Importar Serviços

Na próxima tela escolha os serviços que deseja importar, atentando-se para sempre manter a origem e os destinos iguais, ou seja, quando a origem for "Manfro", o destino deve ser "Manfro", como na Figura 20.

Figura 21 - Importação de Serviços

Caso não seja possível realizar a importação dos serviços através da comunicação com os servidores Totvs, solicite junto a Totvs os arquivos para que seja realizada a Importação Manual, para isso, indique a Totvs quais os serviços serão importados. Após recebidos os arquivos, vá até a seção Importação manual, indique qual o serviço a ser importado, clique em Upload Serviços e encontre o arquivo referente ao serviço.

AVISO: Antes de realizar a importação automática dos serviços, verifique a seção "Configurando corretamente o servidor de importação de serviços." ao final deste manual

Alterando formato da data do client Oracle
Deve-se verificar no regedit a seguinte chave: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ORACLE\KEY_OraClient10g_home1\NLS_LANG
A chave NLS_LANG deverá ficar com valor igual AMERICAN_AMERICA.XXXXXXXX

Deve-se criar neste diretório abaixo a chave NLS_DATE_FORMAT com valor igual DD/MM/YYYY.
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ORACLE\KEY_OraClient10g_home1

Formato de Data do Windows

Neste passo deve-se verificar o formato de data do Windows. Entrar em Painel de Controle>>>Região e Idioma>>>Configurações Adicionais>>>Data
O formato de data deverá estar como dd/MM/aaaa


Configurando a manipulação de arquivos .apk no IIS

A partir da versão 12.1.14 do Portal de Mobilidade o gerenciamento dos aplicativos dos dispositivos móveis passou a ser realizado diretamente pelo Portal.
Para que essa gerencia possa ser realizada corretamente, é necessário configurar o IIS para manipular arquivos com a extensão .apk, para isso, siga os passos a seguir:

• Abra o IIS
• Clique no site PortalMobile
• Encontre a opção "Tipo de MIME", como na imagem abaixo:

• Clique em adicionar e acrescente o seguinte "Tipo de MIME"
  • Extensão: .apk
  • Tipo: application/vnd.android.package-archive

Configurando para uso da Ordem de Serviço Offline (OS Offline)

Caso o cliente deseje utilizar a Ordem de Serviço Offline, é necessário verificar se as configurações necessárias existem dentro do arquivo web.config, que está localizado em C:\inetpub\PortalMobile.
Abra o arquivo web.config e procure pela tag <listeners>, verifique se dentro dessa tag existe a tag abaixo, caso contrário adicione.

<add fileName="App_Data\Manfro\Manfro.log" footer="" formatter="Single Line Formatter" header="" rollFileExistsBehavior="Increment" rollInterval="None" rollSizeKB="1024" timeStampPattern="dd-MM-yyyyy" listenerDataType="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.RollingFlatFileTraceListenerData, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" traceOutputOptions="None" filter="All" type="Microsoft.Practices.EnterpriseLibrary.Logging.TraceListeners.RollingFlatFileTraceListener, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" name="Manfro" /> 

Ainda com o web.config aberto, procure pela tag <categorySources> e verifique se dentro dela existe a tag abaixo, caso contrário adicione.

<add switchValue="All" name="Manfro">
<listeners>
<add name="Manfro" />
</listeners>
</add>

Configurando corretamente o servidor de importação de serviços.

No momento da instalação ou atualização a tag <ServerTotvsServices> será configurada de acordo com o banco de dados do PIMS (Oracle ou SQLServer). O objetivo desta tag é indicar ao Portal de Mobilidade em qual servidor Totvs ele deve buscar os serviços, sendo para Oracle o servidor http://138.219.88.222/Portal e para SQLServer o servidor http://138.219.88.222/PortalSQL. Antes de realizar a importação dos serviços, verifique se a tag esta configurada corretamente!