Changes between Version 1 and Version 2 of Servicos/Funambol/InstalacaoServidor


Ignore:
Timestamp:
06/19/09 11:51:10 (15 years ago)
Author:
marciostarke
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Servicos/Funambol/InstalacaoServidor

    v1 v2  
    4949}}} 
    5050Dessa forma já serão copiados os seguintes arquivos:[[br]] 
    51 O módulo pSync (funambol-psync-1.0.0.s4j) será copiado para o diretório /opt/Funambol/ds-server/modules; 
    52 O driver de conexão com o banco de dados (postgresql.jar) será copiado para os diretórios: 
    53 /opt/Funambol/tools/jre-1.5.0/jre/lib/ext; 
    54 /opt/Funambol/tools/tomcat/lib; 
    55 /opt/Funambol/inbox-listener/lib; 
    56 /opt/Funambol/pim-listener/lib; 
    57 /opt/Funambol/ds-server/default/lib; 
    58 /opt/Funambol/ctp-server/lib; 
    59 O arquivo XML de configuração de paramêtros do novo autenticador desenvolvido pela TISGM (LdapUserProvisioningOfficer.xml) será copiado para /opt/Funambol/config/com/funambol/server/security 
    60 O arquivo de criação do usuário de administração com a senha inicial correta (init_engine.sql) será copiado para /opt/Funambol/ds-server/default/sql/postgresql 
    61 Como a ferramenta não copia o arquivo JAR (server-framework-7.0.4.jar)com as novas classes desenvolvidas para a pasta do módulo de correio, é feita uma cópia para os diretórios 
    62 /opt/Funambol/inbox-listener/lib  
    63 /opt/Funambol/pim-listener/lib  
    64 /opt/Funambol/ctp-server/lib  
    65 /opt/Funambol/tools/tomcat/lib 
    66 Serão copiados também uns arquivos para melhorar a compatibilidade dos celulares da Motorola V8 e A1200, copiando os arquivos MotorolaA1200in.bsh e MotorolaV8in.bsh para /opt/Funambol/config/com/funambol/server/engine/pipeline/phones-support/bsh e o arquivo 110.1110.MotorolaA1200.xml para 
    67 /opt/Funambol/config/com/funambol/server/engine/pipeline/input 
    68  
    69         Caso já exista uma instalação do Funambol num banco de dados do Expresso, e esteja ocorrendo apenas uma migração de servidores ou uma reinstalação, deve-se pular os procedimentos abaixo e ir para o item 3.2 – Configuração dos arquivos – Parte 2 
    70  
    71 3.1 – Configuração dos Arquivos – Parte 1 
    72         Acabada a instalação é necessário fazer a configuração, começando pelo o arquivo install.properties, do diretório /opt/Funambol/ds-server. Nesse arquivo estão as informações necessárias de conexão ao banco de dados e de quais módulos devem ser instalados. 
    73         Onde está escrito: 
     51 * O módulo pSync (funambol-psync-1.0.0.s4j) será copiado para o diretório /opt/Funambol/ds-server/modules; 
     52 * O driver de conexão com o banco de dados (postgresql.jar) será copiado para os diretórios: 
     53  * /opt/Funambol/tools/jre-1.5.0/jre/lib/ext; 
     54  * /opt/Funambol/tools/tomcat/lib; 
     55  * /opt/Funambol/inbox-listener/lib; 
     56  * /opt/Funambol/pim-listener/lib; 
     57  * /opt/Funambol/ds-server/default/lib; 
     58  * /opt/Funambol/ctp-server/lib; 
     59 * O arquivo XML de configuração de paramêtros do novo autenticador desenvolvido pela TISGM (LdapUserProvisioningOfficer.xml) será copiado para /opt/Funambol/config/com/funambol/server/security 
     60 * O arquivo de criação do usuário de administração com a senha inicial correta (init_engine.sql) será copiado para /opt/Funambol/ds-server/default/sql/postgresql 
     61 * Como a ferramenta não copia o arquivo JAR (server-framework-7.0.4.jar)com as novas classes desenvolvidas para a pasta do módulo de correio, é feita uma cópia para os diretórios: 
     62  * /opt/Funambol/inbox-listener/lib  
     63  * /opt/Funambol/pim-listener/lib  
     64  * /opt/Funambol/ctp-server/lib  
     65  * /opt/Funambol/tools/tomcat/lib 
     66 * Serão copiados também uns arquivos para melhorar a compatibilidade dos celulares da Motorola V8 e A1200, copiando os arquivos MotorolaA1200in.bsh e MotorolaV8in.bsh para /opt/Funambol/config/com/funambol/server/engine/pipeline/phones-support/bsh e o arquivo 110.1110.MotorolaA1200.xml para /opt/Funambol/config/com/funambol/server/engine/pipeline/input 
     67Caso já exista uma instalação do Funambol num banco de dados do Expresso, e esteja ocorrendo apenas uma migração de servidores ou uma reinstalação, deve-se pular os procedimentos abaixo e ir para o item 2.2 – Configuração dos arquivos – Parte 2 
     68 
     69---- 
     70 
     71== 2.1. Configuração dos Arquivos – Parte 1 == #arquivos_1 
     72Acabada a instalação é necessário fazer a configuração, começando pelo o arquivo ''install.properties'', do diretório /opt/Funambol/ds-server. Nesse arquivo estão as informações necessárias de conexão ao banco de dados e de quais módulos devem ser instalados.[[br]] 
     73Onde está escrito: 
     74{{{ 
    7475        # The DBMS name. One of: 
    7576        #   - hypersonic 
     
    7879        # 
    7980        dbms=hypersonic 
    80  
    81         Deve-se mudar o dbms para acessar postgresql, ficando desta forma: 
    82  
     81}}} 
     82Deve-se mudar o dbms para acessar postgresql, ficando desta forma: 
     83{{{ 
    8384        # The DBMS name. One of: 
    8485        #   - hypersonic 
     
    8788        # 
    8889        dbms=postgresql 
    89  
    90         Deve-se editar as seguintes linhas que estão descomentadas de: 
    91  
     90}}} 
     91Deve-se editar as seguintes linhas que estão descomentadas de: 
     92{{{ 
    9293        jdbc.classpath=../tools/hypersonic/lib/hsqldb.jar 
    9394        jdbc.driver=org.hsqldb.jdbcDriver 
     
    9596        jdbc.user=sa 
    9697        jdbc.password= 
    97  
    98         Para: 
    99  
     98}}} 
     99Para: 
     100{{{ 
    100101        jdbc.classpath=/opt/Funambol/tools/tomcat/lib/postgresql.jar 
    101102        jdbc.driver=org.postgresql.Driver 
     
    103104        jdbc.user=<usuario do banco do expresso> 
    104105        jdbc.password=<senha do banco do expresso> 
    105  
    106         No final do arquivo temos os módulos que serão instalados: 
    107          
     106}}} 
     107No final do arquivo temos os módulos que serão instalados: 
     108{{{      
    108109        # 
    109110        # Modules definitions 
    110111        # 
    111112        modules-to-install=content-provider-7.0.3,email-connector-7.0.6, foundation-7.0.6, phones-support-7.0.4, webdemo-7.0.6 
    112  
    113         Deve-se adicionar o módulo do pSync (funambol-psync-1.0.0) à lista. Não é preciso colocar a extensão .jar: 
    114          
     113}}} 
     114Deve-se adicionar o módulo do pSync (funambol-psync-1.0.0) à lista. Não é preciso colocar a extensão .jar: 
     115{{{      
    115116        # 
    116117        # Modules definitions 
    117118        # 
    118119        modules-to-install=content-provider-7.0.3,email-connector-7.0.6, foundation-7.0.6, phones-support-7.0.4, webdemo-7.0.6, funambol-psync-1.0.0 
    119  
    120         Depois de editado e salvo, deve-se ir para o diretório /opt/Funambol/bin e rodar o comando ./install. 
    121         Vai então aparecer um texto explicando o que vai ser feito, que praticamente é a criação das tabelas do Funambol no banco de dados. Para cada módulo será perguntado se deseja recriar as tabelas no banco novo. É necessário atentar para duas situações durante a instalação. Caso seja a primeira instalação, basta digitar “y” para dar continuidade a instalação, como mostra o trecho a seguir: 
     120}}} 
     121Depois de editado e salvo, deve-se ir para o diretório /opt/Funambol/bin e rodar o comando ''./install''.[[br]] 
     122Vai então aparecer um texto explicando o que vai ser feito, que praticamente é a criação das tabelas do Funambol no banco de dados. Para cada módulo será perguntado se deseja recriar as tabelas no banco novo. É necessário atentar para duas situações durante a instalação. Caso seja a primeira instalação, basta digitar “y” para dar continuidade a instalação, como mostra o trecho a seguir: 
     123{{{ 
    122124        [echo] Funambol Data Synchronization Server will be installed on the Tomcat 6.0.x application server 
    123125        [echo] Undeploying funambol... 
     
    127129        [input] Do you want to recreate the database? 
    128130        [input]       (y,n) 
    129  
    130         Nesse caso todas as tabelas são recriadas. Na primeira instalação como as tabelas ainda não existem, algumas mensagens de erros referente a recriação das tabelas podem aparecer, mas são erros esperados e não influenciam na instalação e funcionamento do Funambol. 
    131         Para os passos seguintes é necessário ter o “postgresql-client” instalado para executar os comandos listados abaixo. Considerar que os comandos estão sendo executados na pasta descompactada do funambol no diretório /tmp. 
    132         É necessário a criação de duas novas triggers para que o módulo pSync consiga atualizar no dispositivo móvel alterações feitas nos contatos e eventos do calendário do Expresso. Para executar esse comando é necessário usar o endereço, o usuário e a senha (os mesmos utilizados na edição do arquivo install.properties). Para criar as triggers executar o comando: 
     131}}} 
     132Nesse caso todas as tabelas são recriadas. Na primeira instalação como as tabelas ainda não existem, algumas mensagens de erros referente a recriação das tabelas podem aparecer, mas são erros  esperados e não influenciam na instalação e funcionamento do Funambol.[[br]] 
     133Para os passos seguintes é necessário ter o ''postgresql-client'' instalado para executar os comandos listados abaixo. Considerar que os comandos estão sendo executados na pasta descompactada do funambol no diretório /tmp/funambol.[[br]] 
     134É necessário a criação de duas novas ''triggers'' para que o módulo pSync consiga atualizar no dispositivo móvel alterações feitas nos contatos e eventos do calendário do Expresso. Para executar esse comando é necessário usar o endereço, o usuário e a senha (os mesmos utilizados na edição do arquivo install.properties). Para criar as triggers executar o comando: 
     135{{{ 
    133136psql -h <endereço do postgres> -U <usuário do postgres> -W -d expresso < triggers.sql 
    134         Após executar o comando entrar com a senha. Poderão aparecer os erros de que as triggers não existem, mas é porque elas ainda não foram criadas.  
    135  
    136         Caso ocorra algum erro referente a inexistência da “language plpgsql”, usar o seguinte comando: 
     137}}} 
     138Após executar o comando entrar com a senha. Poderão aparecer os erros de que as triggers não existem, mas é porque elas ainda não foram criadas. [[br]] 
     139Caso ocorra algum erro referente a inexistência da “language plpgsql”, usar o seguinte comando: 
     140{{{ 
    137141createlang plpgsql -h <endereço do postgres> -U <usuário do postgres> -W -d expresso 
    138 Após executar o comando entrar com a senha. Depois de criada a “language plpgsql” e preciso executar o comando pra criação de triggers novamente. 
    139  
    140         Depois é preciso criar um usuário que fará a correta codificação entre o funambol (UTF-8) e o Expresso (Latin1). Para criar o usuário executar o comando: 
     142}}} 
     143Após executar o comando entrar com a senha. Depois de criada a “language plpgsql” e preciso executar o comando pra criação de triggers novamente.[[br]] 
     144Agora é preciso criar um usuário que fará a correta codificação entre o funambol (UTF-8) e o Expresso (Latin1). Para criar o usuário executar o comando: 
     145{{{ 
    141146psql -h <endereço do postgres> -U <usuário do postgres> -W -d expresso < criausu.sql 
    142         Após executar o comando entrar com a senha 
    143  
    144         O último passo é habilitar a conexão segura, através de HTTPS. Executar no diretório   /opt/Funambol/tools/jre-1.5.0/jre/bin o comando ./keytool -genkey -alias tomcat -keyalg RSA 
    145         Vão aparecer então as perguntas para gerar o certificado começando com: 
     147}}} 
     148Após executar o comando entrar com a senha.[[br]] 
     149O último passo é habilitar a conexão segura, através de HTTPS. Executar o comando: 
     150{{{ 
     151/opt/Funambol/tools/jre-1.5.0/jre/bin/keytool -genkey -alias tomcat -keyalg RSA 
     152}}} 
     153Vão aparecer então as perguntas para gerar o certificado começando com: 
     154{{{ 
    146155        Enter keystore password:  
    147         Entrar com o valor de changeit 
    148         Depois responder as seguintes perguntas de acordo com o lugar, ou empresa que estiver fazendo a instalação: 
     156}}} 
     157Entrar com o valor de ''changeit''[[br]] 
     158Depois responder as seguintes perguntas de acordo com o lugar, ou empresa que estiver fazendo a instalação: 
     159{{{ 
    149160        What is your first and last name?  
    150161          [Unknown]:   
     
    164175        Enter key password for <tomcat>  
    165176        (RETURN if same as keystore password):  changeit  
    166  
    167         Para finalizar entrar novamente no diretório /opt/Funambol/tools/jre-1.5.0/jre/bin e executar o comando  ./keytool -export -alias tomcat -file <nome do certificado>.cer, onde o nome do certificado pode ser qualquer nome. 
    168  
    169 3.2 – Configuração dos Arquivos – Parte 2 
    170         Deve-se editar um arquivo para que o servidor Funambol use o usuário do postgres criado. Editar o arquivo /opt/Funambol/config/com/funambol/server/db/db.xml, modificando as linhas: 
     177}}} 
     178Para finalizar executar o comando  
     179{{{ 
     180/opt/Funambol/tools/jre-1.5.0/jre/bin/keytool -export -alias tomcat -file <nome do certificado>.cer 
     181}}} 
     182Onde o nome do certificado pode ser qualquer nome. 
     183 
     184---- 
     185 
     186= 2.2. Configuração dos Arquivos – Parte 2 = #arquivos_2 
     187Deve-se editar um arquivo para que o servidor Funambol use o usuário do postgres criado. Editar o arquivo ''/opt/Funambol/config/com/funambol/server/db/db.xml'', modificando as linhas: 
     188{{{ 
    171189        <void method="setProperty"> 
    172190                <string>username</string> 
     
    177195                <string><senha do banco do expresso></string> 
    178196        </void> 
    179         Para: 
     197}}} 
     198Para: 
     199{{{ 
    180200        <void method="setProperty"> 
    181201                <string>username</string> 
     
    186206                <string>funambol</string> 
    187207        </void> 
    188          
    189         No mesmo arquivo db.xml deve-se editar também as seguintes linhas, caso elas não tenham sido modificadas durante a instalação: 
     208}}}      
     209No mesmo arquivo db.xml deve-se editar também as seguintes linhas, caso elas não tenham sido modificadas durante a instalação: 
     210{{{ 
    190211        <void method="setProperty">  
    191212                <string>url</string>  
     
    196217                <string>{jdbc-driver}</string>  
    197218        </void>  
    198         Para: 
     219}}} 
     220Para: 
     221{{{ 
    199222        <void method="setProperty">  
    200223                <string>url</string>  
     
    205228                <string>org.postgresql.Driver</string>  
    206229        </void>  
    207  
    208         No mesmo arquivo db.xml deve-se adicionar também as seguinte linhas para manter a conexão do Funambol com o banco do Expresso ativa: 
     230}}} 
     231No mesmo arquivo db.xml deve-se adicionar também as seguinte linhas para manter a conexão do Funambol com o banco do Expresso ativa: 
     232{{{ 
    209233        <void method="setProperty">  
    210234                <string>testWhileIdle</string>  
     
    239263                <string>true</string>  
    240264        </void> 
    241  
    242         Para habilitar a conexão segura no Funambol, deve-se editar o arquivo /opt/Funambol/tools/tomcat/conf/server.xml descomentando as seguintes linhas: 
     265}}} 
     266Para habilitar a conexão segura no Funambol, deve-se editar o arquivo /opt/Funambol/tools/tomcat/conf/server.xml descomentando as seguintes linhas: 
     267{{{ 
    243268        <!--  
    244269        <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"  
     
    246271                        clientAuth="false" sslProtocol="TLS" />  
    247272        -->  
    248  
    249         Agora é preciso configurar o Funambol para acessar o diretório. Isso é feito editando o arquivo  
    250  /opt/Funambol/config/com/funambol/server/security/LdapUserProvisioningOfficer.xml. Modificar a linha <”IP do servidor LDAP”> para o IP desejado. 
     273}}} 
     274Agora é preciso configurar o Funambol para acessar o diretório. Isso é feito editando o arquivo ''/opt/Funambol/config/com/funambol/server/security/LdapUserProvisioningOfficer.xml''. Modificar a linha <”IP do servidor LDAP”> para o IP desejado. 
     275{{{ 
    251276        <void property="ldapIP">  
    252277                <string><"IP do servidor LDAP"></string>  
    253278        </void>  
    254          
    255          
    256  
    257  
    258  
    259 3.3 – Configuração do Serviço 
    260         Para iniciar ou parar o serviço basta acessar o diretório /opt/Funambol/bin e rodar o comando ./funambol start para iniciar e ./funambol stop para parar. Pode-se verificar se o serviço do Funambol está rodando, digitando "ps aux" na linha de comando. Devem aparecer 05 processos do java do Funambol rodando. É importante verificar se o Java utilizado é o que vem com o Funambol (/opt/Funambol/tools/jre-1.5.0/jre), para evitar possíveis conflitos de versões diferentes do Java. Caso não seja, configurar o JAVA_HOME para esse diretório. Para configurar, primeiro digite echo $JAVA_HOME para visualizar qual é o diretório que está sendo utilizado. Caso não seja o diretório desejado, executar export JAVA_HOME = /opt/Funambol/tools/jre-1.5.0/jre.   
    261         Assim finaliza-se a instalação, sendo agora necessário fazer a configuração do servidor.  
     279}}}      
     280 
     281---- 
     282 
     283= 2.3. Configuração do Serviço = #Configuracao-do_servico 
     284Para iniciar ou parar o serviço basta rodar o comando; 
     285{{{ 
     286/opt/Funambol/bin/funambol start (para iniciar) 
     287/opt/Funambol/bin/funambol stop (para parar) 
     288}}} 
     289Pode-se verificar se o serviço do Funambol está rodando, digitando ''ps aux'' na linha de comando. Devem aparecer 05 processos do java do Funambol rodando.[[br]] 
     290É importante verificar se o Java utilizado é o que vem com o Funambol (''/opt/Funambol/tools/jre-1.5.0/jre''), para evitar possíveis conflitos de versões diferentes do Java. Caso não seja, configurar o JAVA_HOME para esse diretório. Para configurar, primeiro digite: 
     291{{{ 
     292echo $JAVA_HOME 
     293}}} 
     294Para visualizar qual é o diretório que está sendo utilizado. Caso não seja o diretório desejado, executar  
     295{{{ 
     296export JAVA_HOME = /opt/Funambol/tools/jre-1.5.0/jre 
     297}}} 
     298Assim finaliza-se a instalação, sendo agora necessário fazer a configuração do servidor.