From 8772647131cab5b0f5e35f6be8da7857b9d37046 Mon Sep 17 00:00:00 2001 From: Zhang Huangbin Date: Mon, 9 Dec 2019 09:37:20 +0800 Subject: [PATCH] Update iRedMail upgrade tutorial. --- .../0-install.iredmail.on.debian.ubuntu.md | 8 +-- .../0-install.iredmail.on.freebsd.md | 4 +- .../0-install.iredmail.on.openbsd.md | 16 +++--- .../0-install.iredmail.on.rhel.md | 4 +- en_US/upgrade/0-upgrade.iredmail.0.9.9-1.0.md | 45 ++++++--------- html/install.iredmail.on.debian.ubuntu.html | 8 +-- html/install.iredmail.on.freebsd.html | 4 +- html/install.iredmail.on.openbsd.html | 11 ++-- html/install.iredmail.on.rhel.html | 4 +- html/upgrade.iredmail.0.9.9-1.0.html | 56 ++++++++----------- 10 files changed, 66 insertions(+), 94 deletions(-) diff --git a/en_US/installation/0-install.iredmail.on.debian.ubuntu.md b/en_US/installation/0-install.iredmail.on.debian.ubuntu.md index 8a144b4b..41d48ea0 100644 --- a/en_US/installation/0-install.iredmail.on.debian.ubuntu.md +++ b/en_US/installation/0-install.iredmail.on.debian.ubuntu.md @@ -82,10 +82,10 @@ mx.example.com * iRedMail needs official Debian/Ubuntu apt repositories, please enable them in `/etc/apt/sources.list`. -* Install package `bzip2` so that you can uncompress downloaded iRedMail package. +* Install package `gzip` so that you can uncompress downloaded iRedMail package. ``` -# sudo apt-get install bzip2 +# sudo apt-get install gzip ``` ### Download the latest release of iRedMail @@ -95,13 +95,13 @@ mx.example.com * Upload iRedMail to your mail server via ftp or scp or whatever method you can use, login to the server to install iRedMail. We assume you uploaded - it to `/root/iRedMail-x.y.z.tar.bz2` (replace x.y.z by the real version number). + it to `/root/iRedMail-x.y.z.tar.gz` (replace x.y.z by the real version number). * Uncompress iRedMail tarball: ``` # cd /root/ -# tar xjf iRedMail-x.y.z.tar.bz2 +# tar zxf iRedMail-x.y.z.tar.gz ``` ## Start iRedMail installer diff --git a/en_US/installation/0-install.iredmail.on.freebsd.md b/en_US/installation/0-install.iredmail.on.freebsd.md index c4f0c1db..59bddbda 100644 --- a/en_US/installation/0-install.iredmail.on.freebsd.md +++ b/en_US/installation/0-install.iredmail.on.freebsd.md @@ -88,13 +88,13 @@ mx.example.com * Upload iRedMail to your mail server via ftp or scp or whatever method you can use, login to the server to install iRedMail. We assume you uploaded - it to `/root/iRedMail-x.y.z.tar.bz2` (replace x.y.z by the real version number). + it to `/root/iRedMail-x.y.z.tar.gz` (replace x.y.z by the real version number). * Uncompress iRedMail tarball: ``` # cd /root/ -# tar xjf iRedMail-x.y.z.tar.bz2 +# tar zxf iRedMail-x.y.z.tar.gz ``` ## Start iRedMail installer diff --git a/en_US/installation/0-install.iredmail.on.openbsd.md b/en_US/installation/0-install.iredmail.on.openbsd.md index 847e655f..d7b0d256 100644 --- a/en_US/installation/0-install.iredmail.on.openbsd.md +++ b/en_US/installation/0-install.iredmail.on.openbsd.md @@ -103,14 +103,12 @@ near you on OpenBSD web site: ### Install required packages -Before running iRedMail installer, we need to install few required packages: - -``` -pkg_add bash bzip2 -``` - iRedMail is wrote in Bash shell scripting language, so bash shell interpreter -is required. And `bzip2` is used to uncompress downloaded iRedMail package. +is required, install it first: + +``` +pkg_add bash +``` ### Download the latest release of iRedMail @@ -119,13 +117,13 @@ is required. And `bzip2` is used to uncompress downloaded iRedMail package. * Upload iRedMail to your mail server via ftp or scp or whatever method you can use, login to the server to install iRedMail. We assume you uploaded - it to `/root/iRedMail-x.y.z.tar.bz2` (replace x.y.z by the real version number). + it to `/root/iRedMail-x.y.z.tar.gz` (replace x.y.z by the real version number). * Uncompress iRedMail tarball: ``` # cd /root/ -# tar xjf iRedMail-x.y.z.tar.bz2 +# tar zxf iRedMail-x.y.z.tar.gz ``` ## Start iRedMail installer diff --git a/en_US/installation/0-install.iredmail.on.rhel.md b/en_US/installation/0-install.iredmail.on.rhel.md index 346bb0e0..b3749bb8 100644 --- a/en_US/installation/0-install.iredmail.on.rhel.md +++ b/en_US/installation/0-install.iredmail.on.rhel.md @@ -125,13 +125,13 @@ Disable it immediately without rebooting your server. * Upload iRedMail to your mail server via ftp or scp or whatever method you can use, login to the server to install iRedMail. We assume you uploaded - it to `/root/iRedMail-x.y.z.tar.bz2` (replace x.y.z by the real version number). + it to `/root/iRedMail-x.y.z.tar.gz` (replace x.y.z by the real version number). * Uncompress iRedMail tarball: ``` # cd /root/ -# tar xjf iRedMail-x.y.z.tar.bz2 +# tar zxf iRedMail-x.y.z.tar.gz ``` ## Start iRedMail installer diff --git a/en_US/upgrade/0-upgrade.iredmail.0.9.9-1.0.md b/en_US/upgrade/0-upgrade.iredmail.0.9.9-1.0.md index 03d801d6..a456a0e4 100644 --- a/en_US/upgrade/0-upgrade.iredmail.0.9.9-1.0.md +++ b/en_US/upgrade/0-upgrade.iredmail.0.9.9-1.0.md @@ -2,10 +2,6 @@ [TOC] -!!! warning - - This is still a __DRAFT__ document, do __NOT__ apply it. - !!! note "Paid Remote Upgrade Support" We offer remote upgrade support if you don't want to get your hands dirty, @@ -14,7 +10,7 @@ ## ChangeLog -TODO +* Dec 9, 2019, initial release. ## General (All backends should apply these changes) @@ -28,7 +24,7 @@ so that you can know which version of iRedMail you're running. For example: 1.0 ``` -### Upgrade iRedAPD (Postfix policy server) to the latest stable release +### Upgrade iRedAPD (Postfix policy server) to the latest stable release: 3.3 !!! attention @@ -39,7 +35,7 @@ so that you can know which version of iRedMail you're running. For example: Please follow below tutorial to upgrade iRedAPD to the latest stable release: [Upgrade iRedAPD to the latest stable release](./upgrade.iredapd.html) -### Upgrade iRedAdmin (open source edition) to the latest stable release (0.9.6) +### Upgrade iRedAdmin (open source edition) to the latest stable release: 0.9.9 Please follow this tutorial to upgrade iRedAdmin open source edition to the latest stable release: @@ -50,26 +46,17 @@ latest stable release: Please follow below tutorial to upgrade mlmmjadmin to the latest stable release: [Upgrade mlmmjadmin to the latest stable release](./upgrade.mlmmjadmin.html) -### Upgrade Roundcube webmail to the latest stable release +### Upgrade Roundcube webmail to the latest stable release: 1.4.1 -!!! warning "Roundcube 1.3" +!!! warning "Roundcube 1.4" - * Roundcube 1.3 requires at least __PHP 5.4__. If your server is still running - PHP 5.3 and cannot upgrade to 5.4, please upgrade Roundcube to the latest - 1.2 branch (1.2.5) instead. - * Roundcube 1.3 no longer supports IE < 10 and old versions of Firefox, - Chrome and Safari. - * Roundcube 1.3 uses jQuery 3.2 and will not work with current jQuery - mobile plugin. If you use any third-party plugin, please check its - website to make sure it's compatible with Roundcube 1.3 before upgrading. - - With the release of Roundcube 1.3.0, the previous stable release branches - 1.2.x and 1.1.x will switch in to LTS low maintenance mode which means - they will only receive important security updates but no longer any regular - improvement updates. + Since Roundcube 1.3, at least __PHP 5.4__ is required. If your server is + running PHP 5.3 and cannot upgrade to 5.4, please upgrade Roundcube + the latest 1.2 branch instead. +The latest Roundcube webmail 1.4.1 offers a shiny new web UI. Please follow Roundcube official tutorial to upgrade Roundcube webmail to the -latest stable release (1.3.10): +latest stable release (1.4.1): * [How to upgrade Roundcube](https://github.com/roundcube/roundcubemail/wiki/Upgrade). @@ -160,8 +147,8 @@ Please follow commands below to get the updated filter rules. ``` cd /etc/fail2ban/filter.d/ -wget -O postfix.iredmail.conf https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/fail2ban/filter.d/postfix.iredmail.conf -wget -O dovecot.iredmail.conf https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/fail2ban/filter.d/dovecot.iredmail.conf +wget -O postfix.iredmail.conf https://github.com/iredmail/iRedMail/raw/master/samples/fail2ban/filter.d/postfix.iredmail.conf +wget -O dovecot.iredmail.conf https://github.com/iredmail/iRedMail/raw/master/samples/fail2ban/filter.d/dovecot.iredmail.conf ``` Restarting Fail2ban service is required. @@ -189,7 +176,7 @@ this service. ``` cd /root/ -wget https://bitbucket.org/zhb/iredmail/raw/default/extra/update/updateLDAPValues_099_to_1.py +wget https://github.com/iredmail/iRedMail/raw/master/update/ldap/updateLDAPValues_099_to_1.py ``` * Open downloaded file `updateLDAPValues_099_to_1.py`, set LDAP server @@ -212,7 +199,7 @@ of them have read-write privilege to update mail accounts. * Execute this script, it will add required data: ``` -# python updateLDAPValues_099_to_1.py +# python2 updateLDAPValues_099_to_1.py ``` #### Enable quota-status service in Dovecot @@ -287,7 +274,7 @@ Download plain SQL file used to create required column and index, then import it directly as MySQL root user (Please run commands below as `root` user): ``` -wget -O /tmp/iredmail.mysql https://bitbucket.org/zhb/iredmail/raw/default/extra/update/1.0/iredmail.mysql +wget -O /tmp/iredmail.mysql https://github.com/iredmail/iRedMail/raw/master/update/1.0/iredmail.mysql mysql vmail < /tmp/iredmail.mysql rm -f /tmp/iredmail.mysql ``` @@ -363,7 +350,7 @@ According to the Dovecot settings configured by iRedMail, a new SQL column * Download plain SQL file used to create required column and index: ``` -wget -O /tmp/iredmail.pgsql https://bitbucket.org/zhb/iredmail/raw/default/extra/update/1.0/iredmail.pgsql +wget -O /tmp/iredmail.pgsql https://github.com/iredmail/iRedMail/raw/master/update/1.0/iredmail.pgsql ``` * Connect to PostgreSQL server as `postgres` user and import the SQL file: diff --git a/html/install.iredmail.on.debian.ubuntu.html b/html/install.iredmail.on.debian.ubuntu.html index 49db4bc3..7caa4028 100644 --- a/html/install.iredmail.on.debian.ubuntu.html +++ b/html/install.iredmail.on.debian.ubuntu.html @@ -111,9 +111,9 @@ mx.example.com -
# sudo apt-get install bzip2
+
# sudo apt-get install gzip
 

 
 
Download the latest release of iRedMail

@@ -125,14 +125,14 @@ mx.example.com
 
  • 
 
    Upload iRedMail to your mail server via ftp or scp or whatever method you
   can use, login to the server to install iRedMail. We assume you uploaded
-  it to /root/iRedMail-x.y.z.tar.bz2 (replace x.y.z by the real version number).
    
+  it to /root/iRedMail-x.y.z.tar.gz (replace x.y.z by the real version number).
    
 
    • 
 
  • 
 
    Uncompress iRedMail tarball:
    
 
    • 
 
 
    # cd /root/
-# tar xjf iRedMail-x.y.z.tar.bz2
+# tar zxf iRedMail-x.y.z.tar.gz
 
    
 
 
    Start iRedMail installer
    
diff --git a/html/install.iredmail.on.freebsd.html b/html/install.iredmail.on.freebsd.html
index 9377ac21..fd0b95e2 100644
--- a/html/install.iredmail.on.freebsd.html
+++ b/html/install.iredmail.on.freebsd.html
@@ -113,14 +113,14 @@ mx.example.com
 
  • 
 
    Upload iRedMail to your mail server via ftp or scp or whatever method you
   can use, login to the server to install iRedMail. We assume you uploaded
-  it to /root/iRedMail-x.y.z.tar.bz2 (replace x.y.z by the real version number).
    
+  it to /root/iRedMail-x.y.z.tar.gz (replace x.y.z by the real version number).
    
 
    • 
 
  • 
 
    Uncompress iRedMail tarball:
    
 
    • 
 
 
    # cd /root/
-# tar xjf iRedMail-x.y.z.tar.bz2
+# tar zxf iRedMail-x.y.z.tar.gz
 
    
 
 
    Start iRedMail installer
    
diff --git a/html/install.iredmail.on.openbsd.html b/html/install.iredmail.on.openbsd.html
index 32f31ca4..9f465289 100644
--- a/html/install.iredmail.on.openbsd.html
+++ b/html/install.iredmail.on.openbsd.html
@@ -131,12 +131,11 @@ mirror site will speed up package installation. You can find mirror list
 near you on OpenBSD web site:
 Getting OpenBSD.
    
 
    Install required packages
    
-
    Before running iRedMail installer, we need to install few required packages:
    
-
    pkg_add bash bzip2
+
    iRedMail is wrote in Bash shell scripting language, so bash shell interpreter
+is required, install it first:
    
+
    pkg_add bash
 
    
 
-
    iRedMail is wrote in Bash shell scripting language, so bash shell interpreter
-is required. And bzip2 is used to uncompress downloaded iRedMail package.
    
 
    Download the latest release of iRedMail
    
 
      
 
    • 
@@ -146,14 +145,14 @@ is required. And bzip2 is used to uncompress downloaded iRedMail pa
 
    • 
 
      Upload iRedMail to your mail server via ftp or scp or whatever method you
   can use, login to the server to install iRedMail. We assume you uploaded
-  it to /root/iRedMail-x.y.z.tar.bz2 (replace x.y.z by the real version number).
      
+  it to /root/iRedMail-x.y.z.tar.gz (replace x.y.z by the real version number).
      
 
      • 
 
    • 
 
      Uncompress iRedMail tarball:
      
 
      • 
 
    
 
    # cd /root/
-# tar xjf iRedMail-x.y.z.tar.bz2
+# tar zxf iRedMail-x.y.z.tar.gz
 
    
 
 
    Start iRedMail installer
    
diff --git a/html/install.iredmail.on.rhel.html b/html/install.iredmail.on.rhel.html
index acc20eca..0d504e2c 100644
--- a/html/install.iredmail.on.rhel.html
+++ b/html/install.iredmail.on.rhel.html
@@ -155,14 +155,14 @@ used by iRedMail team to build the binary packages are available
 
  • 
 
    Upload iRedMail to your mail server via ftp or scp or whatever method you
   can use, login to the server to install iRedMail. We assume you uploaded
-  it to /root/iRedMail-x.y.z.tar.bz2 (replace x.y.z by the real version number).
    
+  it to /root/iRedMail-x.y.z.tar.gz (replace x.y.z by the real version number).
    
 
    • 
 
  • 
 
    Uncompress iRedMail tarball:
    
 
    • 
 
 
    # cd /root/
-# tar xjf iRedMail-x.y.z.tar.bz2
+# tar zxf iRedMail-x.y.z.tar.gz
 
    
 
 
    Start iRedMail installer
    
diff --git a/html/upgrade.iredmail.0.9.9-1.0.html b/html/upgrade.iredmail.0.9.9-1.0.html
index e885a86e..982ea963 100644
--- a/html/upgrade.iredmail.0.9.9-1.0.html
+++ b/html/upgrade.iredmail.0.9.9-1.0.html
@@ -22,10 +22,10 @@
 
  • ChangeLog
    • 
 
  • General (All backends should apply these changes)
 
-
    
-
    Warning
    
-
    This is still a DRAFT document, do NOT apply it.
    
-
    
 
    
 
    Paid Remote Upgrade Support
    
 
    We offer remote upgrade support if you don't want to get your hands dirty,
@@ -75,7 +71,9 @@ check the details and
 contact us.
    
 
    
 
    ChangeLog
    
-
    TODO
    
+
      
+
    • Dec 9, 2019, initial release.
      • 
+
    
 
    General (All backends should apply these changes)
    
 
    Update /etc/iredmail-release with new iRedMail version number
    
 
    iRedMail stores the release version in /etc/iredmail-release after
@@ -84,7 +82,7 @@ so that you can know which version of iRedMail you're running. For example:
    
 
    1.0
 
    
 
-
    Upgrade iRedAPD (Postfix policy server) to the latest stable release
    
+
    Upgrade iRedAPD (Postfix policy server) to the latest stable release: 3.3
    
 
    
 
    Attention
    
 
    iRedAPD offers SRS (Sender Rewriting Scheme) support in this release, but
@@ -93,33 +91,23 @@ issues and how to enable it: Enable SRS (Sender Rewriting S
 
    
 
    Please follow below tutorial to upgrade iRedAPD to the latest stable release:
 Upgrade iRedAPD to the latest stable release
    
-
    Upgrade iRedAdmin (open source edition) to the latest stable release (0.9.6)
    
+
    Upgrade iRedAdmin (open source edition) to the latest stable release: 0.9.9
    
 
    Please follow this tutorial to upgrade iRedAdmin open source edition to the
 latest stable release:
 Upgrade iRedAdmin to the latest stable release
    
 
    Upgrade mlmmjadmin to the latest stable release (2.1)
    
 
    Please follow below tutorial to upgrade mlmmjadmin to the latest stable release:
 Upgrade mlmmjadmin to the latest stable release
    
-
    Upgrade Roundcube webmail to the latest stable release
    
+
    Upgrade Roundcube webmail to the latest stable release: 1.4.1
    
 
    
-
    Roundcube 1.3
    
-
      
-
    • Roundcube 1.3 requires at least PHP 5.4. If your server is still running
-  PHP 5.3 and cannot upgrade to 5.4, please upgrade Roundcube to the latest
-  1.2 branch (1.2.5) instead.
      • 
-
    • Roundcube 1.3 no longer supports IE < 10 and old versions of Firefox,
-  Chrome and Safari.
      • 
-
    • Roundcube 1.3 uses jQuery 3.2 and will not work with current jQuery
-  mobile plugin. If you use any third-party plugin, please check its
-  website to make sure it's compatible with Roundcube 1.3 before upgrading.
      • 
-
    
-
    With the release of Roundcube 1.3.0, the previous stable release branches
-1.2.x and 1.1.x will switch in to LTS low maintenance mode which means
-they will only receive important security updates but no longer any regular
-improvement updates.
    
+
    Roundcube 1.4
    
+
    Since Roundcube 1.3, at least PHP 5.4 is required. If your server is
+running PHP 5.3 and cannot upgrade to 5.4, please upgrade Roundcube
+the latest 1.2 branch instead.
    
 
    
-
    Please follow Roundcube official tutorial to upgrade Roundcube webmail to the
-latest stable release (1.3.10):
    
+
    The latest Roundcube webmail 1.4.1 offers a shiny new web UI.
+Please follow Roundcube official tutorial to upgrade Roundcube webmail to the
+latest stable release (1.4.1):
    
 
@@ -198,8 +186,8 @@ iRedMail, so we decide to remove the filter rule used to match Postfix log
 
  • On Linux:
    • 
 
 
    cd /etc/fail2ban/filter.d/
-wget -O postfix.iredmail.conf https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/fail2ban/filter.d/postfix.iredmail.conf
-wget -O dovecot.iredmail.conf https://bitbucket.org/zhb/iredmail/raw/default/iRedMail/samples/fail2ban/filter.d/dovecot.iredmail.conf
+wget -O postfix.iredmail.conf https://github.com/iredmail/iRedMail/raw/master/samples/fail2ban/filter.d/postfix.iredmail.conf
+wget -O dovecot.iredmail.conf https://github.com/iredmail/iRedMail/raw/master/samples/fail2ban/filter.d/dovecot.iredmail.conf
 
    
 
 
    Restarting Fail2ban service is required.
    
@@ -220,7 +208,7 @@ this service.
    
 
  • Download script used to update existing mail accounts:
    • 
 
 
    cd /root/
-wget https://bitbucket.org/zhb/iredmail/raw/default/extra/update/updateLDAPValues_099_to_1.py
+wget https://github.com/iredmail/iRedMail/raw/master/update/ldap/updateLDAPValues_099_to_1.py
 
    
 
 
      
@@ -242,7 +230,7 @@ of them have read-write privilege to update mail accounts.
      
 
        
 
      • Execute this script, it will add required data:
        • 
 
      
-
      # python updateLDAPValues_099_to_1.py
+
      # python2 updateLDAPValues_099_to_1.py
 
      
 
 
      Enable quota-status service in Dovecot
      
@@ -300,7 +288,7 @@ to process this email (e.g. spam/virus scanning), and avoids bounce message.
      
 mailbox.enablequota-status is required.
      
 
      Download plain SQL file used to create required column and index, then import
 it directly as MySQL root user (Please run commands below as root user):
      
-
      wget -O /tmp/iredmail.mysql https://bitbucket.org/zhb/iredmail/raw/default/extra/update/1.0/iredmail.mysql
+
      wget -O /tmp/iredmail.mysql https://github.com/iredmail/iRedMail/raw/master/update/1.0/iredmail.mysql
 mysql vmail < /tmp/iredmail.mysql
 rm -f /tmp/iredmail.mysql
 
      
@@ -361,7 +349,7 @@ to process this email (e.g. spam/virus scanning), and avoids bounce message.
      
 
        
 
      • Download plain SQL file used to create required column and index:
        • 
 
      
-
      wget -O /tmp/iredmail.pgsql https://bitbucket.org/zhb/iredmail/raw/default/extra/update/1.0/iredmail.pgsql
+
      wget -O /tmp/iredmail.pgsql https://github.com/iredmail/iRedMail/raw/master/update/1.0/iredmail.pgsql