Changes between Version 33 and Version 34 of phpgwapi/atualizar24


Ignore:
Timestamp:
11/23/12 11:21:24 (11 years ago)
Author:
wmerlotto
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • phpgwapi/atualizar24

    v33 v34  
    1 = Como atualizar seu Expresso para a versão 2.4 = 
    2 [[PageOutline]] 
    3 Ao baixar o pacote da nova versão do Expresso, sua atualização é semelhante às outras atualizações (veja [wiki:documentacao/atualizarExpresso esta página]). 
    4  
    5 '''Atenção:''' 
    6  * Antes de qualquer coisa, faça backup dos seus dados, principalmente do banco de dados; 
    7  * Procure simular essa atualização em um ambiente de homologação; 
    8  * Este procedimento irá interromper o serviço temporariamente; 
    9  * Proceda em horários sem utilização; 
    10  
    11 = Procedimentos após atualização = 
    12  
    13 Após a atualização de seu Expresso, são necessárias algumas configurações adicionais de novas funcionalidades disponíveis nesta versão. 
    14  
    15 == Diretório "prototype" == 
    16  
    17 Abaixo do diretório principal de seu Expresso existe o diretório "/prototype". Esta pasta compreende um conjunto de novas funcionalidades inseridas no Expresso, desenvolvidas sob uma nova Api proposta abrangendo desde o novo módulo !ExpressoCalendar até componentes/funcionalidades de módulos já existentes como o !ExpressoMail. 
    18  
    19 == Arquivos de configuração Gerais == 
    20  
    21 Os arquivos de configuração da pasta prototype encontram-se no diretório "/config", formando o caminho "prototype/config". Neste diretório, inicialmente é necessário configurar os seguintes arquivos: 
    22  
    23  
    24  
    25  
    26  * PostgreSQL.srv 
    27 {{{ 
    28 path = "services/PostgreSQL.php" 
    29 class = "PostgreSQL" 
    30 [config] 
    31 ; Conexao via socket unix 
    32 host = /tmp 
    33 ; Conexão via TCP/IP 
    34 ;host = 127.0.0.1 
    35 port = 5432 
    36 dbname = expresso 
    37 user = postgres 
    38 ; Caso o usuario tenha senha... 
    39 ;password= 
    40 }}} 
    41  
    42                      -- Neste arquivo deve ser configurado o "host", "port"(porta de conexão com o PostgreSQL), "dbname", "user" e caso seja necessário uma senha para conexão a mesma deve ser dado no campo "password"; 
    43  
    44  
    45  
    46  
    47  * Sieve.srv 
    48 {{{ 
    49 path = "services/Sieve.php" 
    50 class = "Sieve" 
    51 [config] 
    52 host = 127.0.0.1 
    53 port = 2000 
    54 loginType = null 
    55 auth = true 
    56 debug = false 
    57 euser = '' 
    58 useTLS = false 
    59 options = null 
    60 }}} 
    61  
    62                      -- Neste arquivo deve ser configurado o "host"(onde está o serviço sieve - Ip da máquina), "port"(Porta do serviço Sieve), "loginType", "auth", "debug", "euser", "userTLS", "options"; 
    63  
    64  
    65  
    66  
    67  * OpenLDAP.srv 
    68 {{{ 
    69 path = "services/OpenLDAP.php" 
    70 class = "OpenLDAP" 
    71 [config] 
    72 idAtribute = "uidNumber" 
    73 host = 127.0.0.1 
    74 context = "dc=LDAP_DC" 
    75 ; Caso o LDAP requisite autenticao, configure os parametros a seguir 
    76 ;user = 
    77 ;password =  
    78 }}} 
    79  
    80                      -- Neste arquivo deve ser configurado o "idAtribute" (nome do campo do LDap que representa o Id unico do usuário), "host"(onde está o serviço OpenLDAP) e "context";  
    81  
    82  * Imap.srv 
    83 {{{ 
    84 path = services/ImapServiceAdapter.php 
    85 class = ImapServiceAdapter 
    86 }}} 
    87  
    88  
    89 == Instalação básica da Agenda (expressoCalendar) == 
    90  
    91 1 - Instalar módulo a partir do setup do Expresso, conforme o padrão de todos os módulos; 
    92  
    93 2 - Configurar obrigatóriamente os arquivos "PostgreSQL.srv", "OpenLDAP.srv" e "SMTP.srv", 
    94 localizados em "/prototype/config/" na Árvore de diretórios a partir da raíz; 
    95  
    96 3 - Ativar o módulo para os gerentes pelo módulo Admin; 
    97  
    98 4 - Ativar o módulo para os usuários ou para um grupo de usuários pelo módulo !ExpressoAdmin; 
    99  
    100 5 - Configurar o cron do servidor para executar perioricamente o arquivo de alarmes do 
    101 Expresso, permitindo o envio de notificações de alarmes dos eventos (via e-mail): 
    102         * Executar o comando "crontab -u apache -e" para centos ou "crontab -u www-data -e" para debian/ubuntu; 
    103         * Copiar e colar esta linha na linha de comando 
    104         "*/5 * * * * php -q /CAMINHO ABSOLUTO DO EXPRESSO/prototype/modules/calendar/alarms.php". 
    105  
    106 == Suporte a !DaviCal == 
    107  
    108 1 - Instalação do Servidor !DaviCal: 
    109  
    110  * Seguir o tutorial oficial, disponibilizado em: http://www.davical.org/installation.php 
    111  
    112  * Outras informações também podem ser encontradas em:  
    113    http://wiki.davical.org/ 
    114    http://wiki.davical.org/w/Configuration/LDAP  
    115  
    116  * Observação: O davical DEVE ser instalado na mesma máquina do Expresso 
    117    Livre, mas a base de dados pode estar em outro servidor (já que o davical 
    118    necessita que a base de dados esteja em UTF-8). 
    119  
    120 No desenvolvimento da versão 2.4 nos baseamos na versão '''1.0.2''' do Davical 
    121  
    122 2 - Aplicar os três patches em anexo nesta página Wiki nos arquivos do 
    123 servidor !DaviCal: 
    124  
    125  * caldav-DELETE.php.diff 
    126  * caldav-MOVE.php.diff 
    127  * caldav-PUT-vcalendar.php.diff 
    128  
    129 Para aplicar os patches, copie os arquivos acima, acesse o diretório do código do !DaviCal 
    130 (geralmente em /usr/share/davical/inc), cole os arquivos neste diretório e utilize os comandos: 
    131  
    132  * patch -p0 < caldav-DELETE.php.diff 
    133  * patch -p0 < caldav-MOVE.php.diff 
    134  * patch -p0 < caldav-PUT-vcalendar.php.diff 
    135  
    136 3 - Após aplicados os patches, acessar cada um dos arquivos: 
    137  
    138  * caldav-DELETE.php 
    139  * caldav-MOVE.php 
    140  * caldav-PUT-vcalendar.php 
    141  
    142 e especificar o caminho da sua instalação Expresso em cada um deles, definido na variável: 
    143  
    144 $expresso = 'PATH_DO_SEU_EXPRESSO'; 
    145  
    146 Observação: Lembre-se de acertar na configuração do davical a variável open_basedir 
    147 {{{ 
    148   php_value open_basedir "/usr/share/davical:/usr/share/awl:/usr/share/awl/inc:/tmp:/etc/davical:'PATH_DO_SEU_EXPRESSO'" 
    149 }}} 
    150  
    151 4 - Para configurar a agenda como um cliente !DaviCal 
    152  
    153  * Configurar a url utilizada para acessar o servidor !DaviCal no arquivo 
    154 localizado em "/prototype/config/CalDAV.srv" 
    155 {{{ 
    156 ;Url utilizada para acessar o serviço caldav 
    157 url = "http://davical.domain.com/caldav.php" 
    158 ;Conta do caldav onde fica armazenada as agendas de contas compartilhadas 
    159 sharedAccountsLocation = "shareds" 
    160 }}} 
    161  
    162  * Ativar o suporte ao caldav, definindo para "true" o parâmetro "useCaldav" 
    163 no arquivo localizado em "/prototype/config/expressoCalendar.ini" 
    164  
    165 5 - No módulo "admin", na opção "Configurações do calendário", o "Calendário padrão da instalação do expresso:"deve estar como: "expressoCalendar". 
    166  
    167  
    168 == Configuração do Cron == 
    169  
    170 1 - Para a configuração do Cron, deve-se colocar o script localizado em (expresso/INSTALL/arquivos/expresso-cron) no diretório "/etc/cron.d", o mesmo deve ser alterado conforme o sistema operacional utilizado. 
    171  
    172 2 - Se a instalação for feita via Script, este arquivo será configurado e colocado automaticamente. 
    173  
    174 3 - Se for feita apenas uma atualização, deverá ser configurado manualmente. 
    175  
    176  
    177 == Migração da Agenda (expressoCalendar) == 
    178  
    179 1 - Entrar no módulo Administrador; 
    180  
    181 2 - Em "expressoCalendar" clicar em  "!ExpressoCalendar migração*" (Imagem 1); 
    182 [[Image(img1.jpg,center,45%)]] 
    183  
    184 3 - Clicar no botão "Salvar" uma vez (Imagem 2). O sistema ira migrar e voltar ao home do módulo Administrador; 
    185 [[Image(img2.jpg,center,35%)]] 
    186  
    187 Obs.: A migração ainda não suporta Repetições e nem Alarmes, portanto não serão migrados junto com os eventos!ainda estão em 'TODO'. 
    188  
    189  
    190 == Instalação do módulo REST API e atualização do módulo Expresso Mail == 
    191  
    192 1 - A partir da interface de instalação de módulos do expresso (expresso/setup) na tela de visualização de módulos instalados/desinstalados/desatualizados, Será necessário procurar pelo módulo com o título "REST API", marcá-lo para instalação e clicar sobre o botão salvar. Veja maiores detalhes na imagem abaixo. 
    193  
    194 2 - Após a instalação do módulo "REST API", procurar pelo módulo com o título "Expresso Mail", marcá-lo para atualização e clicar sobre o botão salvar. Veja maiores detalhes na imagem abaixo. A ordem de instalação destes módulos deve ser seguida desta maneira, instalando primeiro o "REST API", pois "Expresso Mail" precisará que ele já esteja instalado para que a nova funcionalidade de contatos dinâmicos funcione corretamente. 
    195 [[Image(setup.jpg,center,70%)]] 
    196  
    197  
    198 == Alteração do limite de resultados de uma pesquisa no LDAP == 
    199  
    200 Em diversos locais do expresso são realizadas buscas no LDAP. Nestes locais, ao escolher um setor ou pressionar "Enter" em um campo vazio, será retornado resultados limitados do LDAP. Isto ocorre por que este valor está fixo no código, porém é possivel alterá-lo. 
    201  
    202 Para alterar a quantidade de resultados em uma pesquisa no LDAP é preciso editar o arquivo "prototype/services/OpenLDAP.php". Procure pela variável "var $limit = 10" presente na linha 9 deste arquivo. Ao alterar o valor desta variável, o limite máximo de resultados em uma busca no LDAP será alterada. Segue abaixo uma imagem para maiores detalhes de localização. 
    203 [[Image(limit.jpg,center,22%)]] 
    204  
    205  
    206 == Nova funcionalidade de auto-completar para destinatários de mensagem == 
    207  
    208 No módulo Expresso Mail, para que a nova funcionalidade de auto-completar para destinátários de uma mensagem seja funcional, será preciso seguir os passos abaixo: 
    209  
    210 1-  Limpar os todos os dados de cookie e cache de seu navegador. Para que a interface de remoção destes dados seja exibida em seu navegador, utilize o atalho Ctrl+Shift+del ou procure pela funcionalidade no menu de seu navegador, a imagem abaixo utiliza como exemplo a remoção de dados para o navegador firefox. 
    211 [[Image(limpar_cache_firefox.jpg,center,50%)]] 
    212  
    213 2 - Selecionar um identificador único que o usuário contenha em seu LDAP. Para isto acesse o módulo "Administrador" e acesse o link "Configuração do servidor" do módulo Expresso Mail. Ao final da página que será aberta, em "Identificador do destinatário de uma mensagem" escolha o atributo LDAP disponível no campo de seleção exibido. Para finalizar esta modificação clique sobre o botão "Salvar". A imagem abaixo utiliza como exemplo o atributo "uid". 
    214 [[Image(alterar_atributo_ldap.jpg,center,50%)]] 
    215  
    216 == Lista de pacotes que devem ser instalados (Debian / Ubuntu / CentOS) == 
    217  
    218 Para Debian e Ubuntu: 
    219     HTTP:  apache2-mpm-prefork libapache2-mod-php5 apache2-utils 
    220   
    221     PHP:  php5 php5-common php5-dev php5-gd php5-imap php5-ldap php5-pgsql php5-cgi php5-cli php5-curl php5-xmlrpc php5-memcache libgv-php5 php5-pspell 
    222  
    223     Complementares: zip unzip memcached libmemcached 
    224   
    225 Para CentOS: 
    226     HTTP: httpd mod_ssl 
    227      
    228     PHP: php php-cli php-ldap php-pgsql php-imap php-mbstring php-gd php-xml php-pecl-memcache graphviz-php php5-pspell 
    229   
    230     Complementares: zip unzip memcached libmemcached 
    231  
    232 '''A versão do PHP deve ser maior que 5.3.3, preferencialmente a última disponível (atualmente a 5.3.15).''' 
    233  
    234 == Permitindo o uso do ''.htaccess'' no Apache == 
    235 A partir da versão 2.4.0 do Expresso Livre, as configurações relativas ao PHP necessárias para que o Expresso funcione foram concentradas no arquivo ''.htaccess''. Então, é muito importante permitir que o Apache use tais configurações: 
    236 {{{ 
    237 <Directory /ONDE/EXPRESSO/ESTA/INSTALADO> 
    238    # Para o .htaccess funcionar 
    239    AllowOverride All 
    240  
    241    Order allow,deny 
    242    allow from all 
    243 </Directory> 
    244 }}} 
     1Esta página foi alterada. Por favor, '''[wiki:versoes/24 veja aqui a nova página]'''.