GT-MobVida Manual de Operações Recife, 12 de Maio de 2016
Sumário 1. Introdução... 3 2. Pré-requisitos para a construção dos executáveis... 3... 3 2. Cliente... 4 3. Construindo os executáveis... 5... 5 2. Cliente Web... 5 3. Cliente móvel... 5 4. Configuração do ambiente de execução... 5... 5 5. Instalação... 5... 5 2. Cliente Web... 5 3. Cliente móvel... 5
1. Introdução O projeto MobVIDA tem como proposta a implementação de um ambiente para a criação de questionários eletrônicos de forma fácil e intuitiva, que permita o rastreamento de doenças e planejamento do cuidado na área de saúde do idoso, associando sua utilização a teleconsultorias por meio de uma plataforma de telessaúde na nuvem. Para tanto, fez-se necessário que, além desse ambiente, também fosse criado um meio intuitivo de aplicação para os questionários criados. 2. Pré-requisitos para a construção dos executáveis Tanto para construção quanto para a execução o MobVIDA depende do Java 1.8 Update 33 Enterprise Edition. Para a construção ainda é necessário a linguagem Groovy 2.3 e do Framework Grails 2.9. Deste modo todos esses pré-requisitos precisam estar devidamento instalados no ambiente de deploy. Instalação do Java A maior parte das distribuições linux não disponibilizam mais o em seus repositórios os pacotes do Java da Oracle. Apesar da Open JDK ser uma excelente máquina virtual para Java, nos recomendamos a utilização da JDK da Oracle tanto para build quando para a execução do MobVIDA. Os comandos para adição do repositório oficial da Oracle download e instalação do Java em distribuições linux similares ao Debian são: sudo add-apt-repository ppa:webupd8team/java sudo apt-get update sudo apt-get install oracle-java8-installer sudo apt-get install oracle-java8-set-default Caso se deseje construir o executável a partir de uma máquina Windows a instalação do JDK deve começar com o download manual do executável do site da Oracle (http://www.oracle.com/technetwork/java/javase/downloads/index.html). Após baixado e instalado ainda é necessário adicionar uma variável de ambiente chamada JAVA_HOME com o caminho para o diretório onde o Java fora instalado. É necessário, ainda, setar no final da variável de ambiente PATH a JAVA_HOME. Instalação do Groovy e do Grails É recomendável que a instalação do desses componentes sejam realizado através do Groovy environment Manager (GVM), apesar de ser possível fazer a instalação manual separada de cada um a partir do site dos respectivos projetos. A instalação do GVM em servidores Linux pode se dar a partir dos comandos: sudo apt-get install curl curl -s get.gvmtool.net bash source ~/.gvm/bin/gvm-init.sh gvm install grails O GVM pode ser instalado no Windows via a criação de um módulo no power shell ou através da utilização do cygwin, no entanto os relatos é de que o seu funcionamento não é estável. Assim é preferível modificar as variáveis de ambiente do Groovy e do Grails manualmente para cada versão que se vá trabalhar. Então é recomendável fazer o download download do Grails em https://grails.org/download, extrair o conteúdo do pacote em um local apropriado como em "c:\program Files". Após isso, criar uma variável de ambiente chamada
GRAILS_HOME tendo como conteúdo o caminho onde o pacote foi extraído. Adicionar "%GRAILS_HOME%bin " no final da variável PATH. Cadastro de Usuários A autenticação e autorização de usuários para o protótipo do Mobvida foi feita com o suporte do Spring Security Core Plugin 1. Para adição de novos usuário é necessário editar o método user() no arquivo BootStrap.groovy localizado em grailsapp/grails-app/conf/. Os usuários são compostos pelos atributos: username, nome, password, email, cpf e relacionamse com um conjuntos de papeis. Os papéis já criados são o de administrador e usuário comum. Caso seja necessário criar um novo papel é necessário instanciar um objeto do tipo Role seguindo o modelo: Role varpapel = new Role(authority: nomedopapelasercriado ) varpapel.save(flush: true, failonerror: true) A criação de usuários acontece de maneira similar, instanciando-se o objeto User conforme o modelo: User varusuario = User(username: "nomelogin", nome: "Nome do usuário", password: "senha", email: "email@email.com.br", cpf:"000.000.000-00") varusuario.save(flush: true, failonerror: true) Por fim, para que o usuário tenha suas devidas permissões de acesso dentro do Mobvida é necessário que ele seja associado a um papel. Esse papel pode ser o de ADMIN ou o de agente, que já estão previamente criados no protótipo, ou qualquer outro papel criado pelo administrador. A estrutura para essa vinculação é: UserRole varvinculo = new UserRole(user: [nomeda variável que contem o usuário], role: nome da variável que contém o papel) varvinculo.save(flush: true, failonerror: true) Os mesmo comandos podem ser utilizado a partir do terminal groovy após o build do aplicativo para a adição de outros usuários. Configurar base de dados A base de dados que será utilizada precisa ser setada no arquivo DataSources.groovy, localizado na pasta grails-app/conf. Para tanto, é preciso modificar o valor das variáveis url e driverclassname, respectivamente, com o endereço da instância do banco de dados a ser utilizado o driver JDBC correspondente. 2. Cliente As aplicações para os clientes móveis precisam podem ser construídas diretamente a partir do Apache Cordova (https://cordova.apache.org/) ou com o apoio de um ferramenta que auxilie o processo. Dado que durante todo o projeto o Framework Intel XDK foi utilizado para a criação das builds, esta é a ferramenta recomendada. O download desse pode ser realizado pelo site https://software.intel.com/intel-xdk, que está disponível em diversas plataformas e possui um instalador gráfico intuitivo. 1 http://grails.org/plugin/spring-security-core
3. Construindo os executáveis Para construir o executável do servidor basta executar o seguinte comando a partir da pasta raiz do projeto: grails war 2. Cliente Web O cliente Web não precisa ser construído, uma vez que a aplicação foi construída com elementos nativos dessa plataforma. 3. Cliente móvel A construção do cliente móvel é feito a partir o Intel XDK. É preciso importer o projeto do cliente para o Intel XDK, clicar na aba build, selecionar as plataformas alvo (Android ou ios) e setar a pasta raiz para www/admin. Para o caso de construção de clientes ios, ainda é necessário fornecer um certificado de desenvolvimento e arquivos P12 válidos. Feito isto, basta confirmar e após o processo de construção baixar o executável pelo link fornecido pela própria ferramenta. 4. Configuração do ambiente de execução O ambiente de execução deve ter o Java instalado, assim como descrito na seção 2. Além disso, é necessário que o servidor possua instalado um container para execução de projetos Java. Recomenda-se a utilização do Tomcat 8 para tal. A instalação em servidores linux pode ser feita a partir dos seguintes comandos: wget http://mirror.sdunix.com/apache/tomcat/tomcat-8/v8.0.23/bin/apachetomcat-8.0.23.tar.gz sudo mkdir /opt/tomcat sudo tar xvf apache-tomcat-8*tar.gz -C /opt/tomcat --strip-components=1 cd /opt/tomcat sudo chgrp -R tomcat conf sudo chmod g+rwx conf sudo chmod g+r conf/* Para servidores Windows é necessário fazer o download manual do Tomcat 8, descompactar o conteúdo e setar a variável de ambiente CATALINA_HOME com o endereço do diretório onde o Tomcat foi instalado. 5. Instalação Para a instalação do aplicativo servidor do MobVIDA é necessário apenas que se coloque o arquivo WAR criado na seção 3 dentro da pasta pública do Tomcat. 2. Cliente Web Para a instalação do cliente Web é necessário apenas que se copia a pasta do projeto do aplicativo cliente do para a pasta pública do Tomcat. O acesso ao cliente Web deve ser feito via browser a partir da url do servidor terminada com /www/admin/login.html. 3. Cliente móvel
A instalação do cliente móvel é gerenciada pelo sistema operacional do aplicativo móvel. Para tanto é necessário quo executável criado na seção 3, seja salvo no aparelho e instaldo acionando-o via sistema operacional.