wiki:phpgwapi/atualizar24

Version 13 (modified by wmerlotto, 8 years ago) (diff)

Adicionado as imagens diretamente no wiki

Como atualizar seu Expresso para a versão 2.4

Ao baixar o pacote da nova versão do Expresso, sua atualização é semelhante às outras atualizações (veja esta página?).

Atenção:

  • Antes de qualquer coisa, faça backup dos seus dados, principalmente do banco de dados;
  • Procure simular essa atualização em um ambiente de homologação;
  • Este procedimento irá interromper o serviço temporariamente;
  • Proceda em horários sem utilização;

Procedimentos após atualização

Após a atualização de seu Expresso, são necessárias algumas configurações adicionais de novas funcionalidades disponíveis nesta versão.

Diretório "prototype"

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.

Arquivos de configuração Gerais

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:

  • PostgreSQL.srv
    path = "services/PostgreSQL.php"
    class = "PostgreSQL"
    [config]
    ; Conexao via socket unix
    host = /tmp
    ; Conexão via TCP/IP
    ;host = 127.0.0.1
    port = 5432
    dbname = expresso
    user = postgres
    ; Caso o usuario tenha senha...
    ;password=
    

-- 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";

  • Sieve.srv
    path = "services/Sieve.php"
    class = "Sieve"
    [config]
    host = 127.0.0.1
    port = 2000
    loginType = null
    auth = true
    debug = false
    euser = ''
    useTLS = false
    options = null
    

-- 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";

  • OpenLDAP.srv
    path = "services/OpenLDAP.php"
    class = "OpenLDAP"
    [config]
    idAtribute = "uidNumber"
    host = 127.0.0.1
    context = "dc=LDAP_DC"
    ; Caso o LDAP requisite autenticao, configure os parametros a seguir
    ;user =
    ;password = 
    

-- 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";

  • Imap.srv
    path = services/ImapServiceAdapter.php
    class = ImapServiceAdapter
    

Instalação básica da Agenda (expressoCalendar)

1 - Instalar módulo a partir do setup do Expresso, conforme o padrão de todos os módulos;

2 - Configurar obrigatóriamente os arquivos "PostgreSQL.srv", "OpenLDAP.srv" e "SMTP.srv", localizados em "/prototype/config/" na Árvore de diretórios a partir da raíz;

3 - Ativar o módulo para os gerentes pelo módulo Admin;

4 - Ativar o módulo para os usuários ou para um grupo de usuários pelo módulo ExpressoAdmin;

5 - Configurar o cron do servidor para executar perioricamente o arquivo de alarmes do Expresso, permitindo o envio de notificações de alarmes dos eventos (via e-mail):

  • Executar o comando "crontab -u apache -e" para centos ou "crontab -u www-data -e" para debian/ubuntu;
  • Copiar e colar esta linha na linha de comando "*/5 * * * * php -q /CAMINHO ABSOLUTO DO EXPRESSO/prototype/modules/calendar/alarms.php".

Suporte a DaviCal

1 - Instalação do Servidor DaviCal:

  • Observação: O davical DEVE ser instalado na mesma máquina do Expresso Livre, mas a base de dados pode estar em outro servidor (já que o davical necessita que a base de dados esteja em UTF-8).

2 - Aplicar os três patches em anexo nesta página Wiki nos arquivos do servidor DaviCal:

  • caldav-DELETE.php.diff
  • caldav-MOVE.php.diff
  • caldav-PUT-vcalendar.php.diff

Para aplicar os patches, copie os arquivos acima, acesse o diretório do código do DaviCal (geralmente em /usr/share/davical/inc), cole os arquivos neste diretório e utilize os comandos:

  • patch -p0 < caldav-DELETE.php.diff
  • patch -p0 < caldav-MOVE.php.diff
  • patch -p0 < caldav-PUT-vcalendar.php.diff

3 - Após aplicados os patches, acessar cada um dos arquivos:

  • caldav-DELETE.php
  • caldav-MOVE.php
  • caldav-PUT-vcalendar.php

e especificar o caminho da sua instalação Expresso em cada um deles, definido na variável:

$expresso = 'PATH_DO_SEU_EXPRESSO';

4 - Para configurar a agenda como um cliente DaviCal

  • Configurar a url utilizada para acessar o servidor DaviCal no arquivo

localizado em "/prototype/config/CalDAV.srv"

  • Ativar o suporte ao caldav, definindo para "true" o parâmetro "useCaldav"

no arquivo localizado em "/prototype/config/expressoCalendar.ini"

Migração da Agenda (expressoCalendar)

1 - Entrar no módulo Administrador;

2 - Em "expressoCalendar" clicar em "ExpressoCalendar migração*" (Imagem 1); No image "img1.jpg" attached to phpgwapi/atualizar24

3 - Clicar no botão "Salvar" uma vez (Imagem 2). O sistema ira migrar e voltar ao home do módulo Administrador; No image "img2.jpg" attached to phpgwapi/atualizar24

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

Attachments