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:

• Seguir o tutorial oficial, disponibilizado em:  http://www.davical.org/installation.php

• Outras informações também podem ser encontradas em:  http://wiki.davical.org/  http://wiki.davical.org/w/Configuration/LDAP

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

No desenvolvimento da versão 2.4 nos baseamos na versão 1.0.2 do Davical

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"

5 - Exemplo de Configuração para acesso a agenda através do Mozilla Thunderbird !!!! Rolava de colocar um Exemplo aqui !!!!!'''

6 - Para acessar uma Agenda Compartilhada via Davical

!!!! Rolava de colocar um Exemplo aqui !!!!!'''

Configuração do Cron

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.

2 - Se a instalação for feita via Script, este arquivo será configurado e colocado automaticamente.

3 - Se for feita apenas uma atualização, deverá ser configurado manualmente.

Migração da Agenda (expressoCalendar)

1 - Entrar no módulo Administrador;

2 - Em "expressoCalendar" clicar em "ExpressoCalendar migração*" (Imagem 1);

3 - Clicar no botão "Salvar" uma vez (Imagem 2). O sistema ira migrar e voltar ao home do módulo Administrador;

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

Instalação do módulo REST API e atualização do módulo Expresso Mail

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.

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.