Atualizando ISPConfig 3.1 para ISPConfig 3.2

Este tutorial explica os passos para atualizar um servidor ISPConfig 3.1 para ISPConfig 3.2. Este tutorial é compatível com os sistemas operacionais CentOS, Debian e Ubuntu.

Por favor, veja as notas de lançamento do ISPConfig 3.2 para uma lista de novos recursos e informações adicionais sobre o lançamento do ISPConfig 3.2.

Verifique os Requisitos do Sistema do ISPConfig 3.2

O ISPConfig 3.2 é compatível com as seguintes versões de sistemas operacionais:

CentOS 7
CentOS 8
Debian 9
Debian 10
Ubuntu 16.04 LTS
Ubuntu 18.04 LTS
Ubuntu 20.04 LTS

O ISPConfig 3.2 funciona em sistemas operacionais mais antigos?

Pode ser que funcione se a versão padrão do PHP instalada for no mínimo PHP 5.4. Não testamos versões mais antigas e você pode ter que ajustar arquivos de configuração manualmente quando contiverem configurações que não são suportadas por versões de software antigas que podem estar em uso em um sistema operacional não suportado.

Instalar novas dependências de software

Alguns dos recursos no ISPConfig 3.2 requerem software adicional. Este software deve ser instalado antes de você começar a atualização.

Para Debian e Ubuntu

sudo apt-get install bzip2 p7zip-full xz-utils lzip rar unrar-free goaccess dovecot-lmtpd

Nota: Os pacotes rar e unrar-free não estão disponíveis na arquitetura ARM. Isso significa que o modo rar para backups de sites não funcionará, outras funções não são afetadas.

Para CentOS 7

sudo yum -y install ncurses-devel gcc geoip-devel tokyocabinet-devel lbzip2 p7zip xz-libs lzip  
cd /tmp  
wget http://tar.goaccess.io/goaccess-1.4.tar.gz  
tar xfz goaccess-1.4.tar.gz  
cd goaccess-1.4  
sudo ./configure --enable-utf8 --enable-geoip=legacy  
sudo make  
sudo make install  
sudo ln -s /usr/local/bin/goaccess /usr/bin/goaccess

Para CentOS 8

dnf install ncurses-devel gcc geoip-devel tokyocabinet-devel lbzip2 p7zip p7zip-plugins xz-libs lzip  
cd /tmp  
wget http://tar.goaccess.io/goaccess-1.4.tar.gz  
tar xfz goaccess-1.4.tar.gz  
cd goaccess-1.4  
sudo ./configure --enable-utf8 --enable-geoip=legacy  
sudo make  
sudo make install  
sudo ln -s /usr/local/bin/goaccess /usr/bin/goaccess

CentOS 7 e 8

Não há pacote rar gratuito para CentOS no repositório centOS ou Epel, apenas uma versão de teste do rarlab. Se você quiser instalá-lo mesmo assim, aqui estão os passos de instalação. O rar é opcional e usado apenas como opção de arquivo para backups de sites. Quando você não o instala, então apenas rar como uma opção de formato de backup não funcionará.

cd /tmp  
wget https://www.rarlab.com/rar/rarlinux-x64-5.9.1.tar.gz  
tar -zxvf rarlinux-x64-5.9.1.tar.gz  
cd rar  
sudo cp -v rar unrar /usr/local/bin/

Verifique se há modelos de arquivos de configuração personalizados

O ISPConfig suporta modelos de arquivos de configuração personalizados que são armazenados na pasta /usr/local/ispconfig/server/conf-custom/. Se você criou algum modelo de configuração lá, então é provável que eles não sejam compatíveis com o ISPConfig 3.2. Ou remova-os (recomendado) ou crie novos com base nos arquivos de configuração que acompanham o ISPConfig 3.2.

Você pode verificar se há arquivos de configuração personalizados com estes comandos:

ls -la /usr/local/ispconfig/server/conf-custom/

Se o resultado for assim, então você não tem nenhum modelo de arquivo de configuração personalizado:

[root@server1 tmp]# ls -la /usr/local/ispconfig/server/conf-custom/  
total 8  
drwxr-x---.  6 root root   76 Oct  1 00:02 .  
drwxr-x---. 13 root root 4096 Oct  1 00:02 ..  
-rwxr-x---.  1 root root   45 Oct  1 00:02 empty.dir  
drwxr-x---.  2 root root   23 Oct  1 00:02 error  
drwxr-x---.  2 root root   23 Oct  1 00:02 index  
drwxr-x---.  2 root root   23 Oct  1 00:02 install  
drwxr-x---.  2 root root   23 Oct  1 00:02 mail

Então não há nada a fazer neste caso.

Em seguida, verifique a pasta de instalação:

ls -la /usr/local/ispconfig/server/conf-custom/install/

O seguinte resultado mostra uma pasta vazia sem nenhum modelo personalizado:

[root@server1 tmp]# ls -la /usr/local/ispconfig/server/conf-custom/install/  
total 4  
drwxr-x---. 2 root root 23 Oct  1 00:02 .  
drwxr-x---. 6 root root 76 Oct  1 00:02 ..  
-rwxr-x---. 1 root root 45 Oct  1 00:02 empty.dir

Então, não há modelos personalizados aqui que precisam ser removidos ou ajustados.

Let’s Encrypt para ISPConfig porta 8080, Postfix, Dovecot e pure-ftpd

Se você configurou manualmente um certificado Let’s Encrypt para o vhost do ISPConfig e serviços como postfix, dovecot e pure-ftpd, então isso pode entrar em conflito com a nova funcionalidade Let’s encrypt que o ISPConfig fornece para esses serviços. Ou mantenha sua antiga configuração do Let’s encrypt escolhendo ‘não’ quando o Atualizador do ISPConfig perguntar se deve recriar o Certificado SSL, ou cuide para remover quaisquer scripts de renovação do Let’s encrypt que você possa ter instalado que possam interferir na nova função no ISPConfig.

Atualizar ISPConfig 3.1 para 3.2

Agora podemos iniciar o processo de atualização. A atualização precisa ser executada como usuário root, para Debian, use:

su -

para se tornar usuário root.

Para CentOS e Ubuntu, use:

sudo -s

para se tornar root.

Então a atualização do ISPConfig é iniciada com o comando:

ispconfig_update.sh

Escolha “ stable “ como a fonte de atualização no diálogo que aparece na tela:

Atualização estável do ISPConfig

Nota: as opções de atualização disponíveis diferem, dependendo da sua versão antiga do ISPConfig. Mas sempre há uma opção chamada stable.

O processo de atualização fará algumas perguntas, que são mostradas abaixo. Eu destaquei as respostas recomendadas em vermelho.

--------------------------------------------------------------------------------
 _____ ___________   _____              __ _         ____
|_   _/  ___| ___ \ /  __ \            / _(_)       /__  \
  | | \ `--.| |_/ / | /  \/ ___  _ __ | |_ _  __ _    _/ /
  | |  `--. \  __/  | |    / _ \| '_ \|  _| |/ _` |  |_ |
 _| |_\__/ / |     | \__/\ (_) | | | | | | | (_| | ___\ \
 \___/\____/\_|      \____/\___/|_| |_|_| |_|\__, | \____/
                                              __/ |
                                             |___/
--------------------------------------------------------------------------------


>> Atualizar

Sistema Operacional: Ubuntu 20.04.1 LTS (Focal Fossa)

Este aplicativo irá atualizar o ISPConfig 3 no seu servidor.

O script deve criar um backup do ISPConfig em /var/backup/ agora? (sim,não) [sim]: sim

Criando backup do diretório "/usr/local/ispconfig"...
Criando backup do diretório "/etc"...
Verificando o banco de dados do ISPConfig .. OK
Iniciando atualização incremental do banco de dados.
Carregando arquivo de patch SQL: /tmp/ispconfig3_install/install/sql/incremental/upd_dev_collection.sql
Reconfigurar permissões no banco de dados mestre? (sim,não) [não]: <-- Em sistemas multiserver, escolha sim, em sistemas de servidor único, escolha não.

Reconfigurar Serviços? (sim,não,selecionado) [sim]: sim

Configurando Postfix
Configurando Dovecot
Configurando Mailman
Configurando Spamassassin
Configurando Amavisd
Configurando Getmail
Configurando BIND
Configurando Pureftpd
Configurando Apache
Configurando vlogger
Configurando vhost de Apps
Configurando Jailkit
Configurando Firewall do Ubuntu
Configurando Banco de Dados
Atualizando ISPConfig
Porta ISPConfig [8080]: <-- apenas pressione enter para aceitar o padrão

Criar novo certificado SSL do ISPConfig (sim,não) [não]: <-- Escolha não para manter o certificado SSL existente, escolha sim para criar um novo certificado SSL ou mudar de um certificado SSL autoassinado para um certificado SSL Let's encrypt.

Reconfigurar Crontab? (sim,não) [sim]: sim

Atualizando Crontab
Reiniciando serviços ...
Atualização concluída.

Não se preocupe quando você ver algumas outras linhas “Configurando …”, o resultado real depende da configuração de software do seu servidor.

Precisa de ajuda com a atualização?

Se você precisar de ajuda com a atualização, se tiver alguma dúvida adicional sobre o processo de atualização ou se encontrar problemas após atualizar seu sistema, então por favor faça uma postagem que descreva seu problema no fórum de suporte do ISPConfig aqui no howtoforge:

https://www.howtoforge.com/community/forums/installation-configuration.27/

Por favor, não use a função de comentário abaixo deste artigo para perguntas de suporte individuais.

Algo deu completamente errado e você quer reverter para a configuração anterior?

O atualizador do ISPConfig cria um backup de todo o diretório /etc (então todos os seus arquivos de configuração), o diretório /usr/local/ispconfig (toda a instalação anterior do ISPConfig) e o banco de dados MySQL/MariaDB do ISPConfig dbispconfig. O backup pode ser encontrado na pasta /var/backup/ há uma subpasta começando com ‘ispconfi_’ mais o nome do host do servidor e a data da atualização. Exemplo:

[root@server1 ~]# ls /var/backup/  
ispconfig_server1.example.com_2020-10-15_19-38

Esta pasta contém os arquivos de backup como arquivos tar.gz e um dump SQL:

[root@server1 ~]# ls /var/backup/ispconfig_server1.example.com_2020-10-15_19-38/  
etc.tar.gz  ispconfig_db_backup.sql  ispconfig_software.tar.gz