Difference between revisions of "Updating from SME 7.1.x or earlier"
Line 31: | Line 31: | ||
==Updating from SME 7.1.3 to SME 7.2== | ==Updating from SME 7.1.3 to SME 7.2== | ||
===CD Update=== | ===CD Update=== | ||
− | |||
{{Note_box|For this you need physical access to your server as SSH access is unavailable during CD updates.}} | {{Note_box|For this you need physical access to your server as SSH access is unavailable during CD updates.}} | ||
− | Insert the CD into your server and issue a reboot, follow the instructions presented to you on the server screen to update to SME Server 7.2. | + | # Insert the CD into your server and issue a reboot, follow the instructions presented to you on the server screen to update to SME Server 7.2. |
+ | # Reset yum to the new default configuration as described here: [[:AddingSoftware#Restoring_Default_Yum_Repositories]] | ||
+ | # Reset other settings to new defaults as shown here: [[:Updating_to_SME_7.2#Updating_Configuration_Database_with_New_Default_Values]] | ||
+ | # Perform a final ''yum update'' to obtain any post-iso updates or patches. | ||
+ | |||
===Yum Update=== | ===Yum Update=== | ||
First, make sure you are using the default yum repository configuration by following the instructions found at [[:AddingSoftware#Restoring_Default_Yum_Repositories]] | First, make sure you are using the default yum repository configuration by following the instructions found at [[:AddingSoftware#Restoring_Default_Yum_Repositories]] |
Revision as of 04:40, 1 August 2007
There seem to be a lot of questions about updating to SME v7.2
This document will attempt to compile the various questions and answers in one place.
Updating from SME 7.0 or 7.1 to SME 7.2
CD Update
- Insert the CD into your server and issue a reboot, follow the instructions presented to you on the server screen to update to SME Server 7.2.
- Reset yum to the new default configuration as described here: AddingSoftware#Restoring_Default_Yum_Repositories
- Reset other settings to new defaults as shown here: Updating_to_SME_7.2#Updating_Configuration_Database_with_New_Default_Values
- Perform a final yum update to obtain any post-iso updates or patches.
Yum Update
First, install the latest yum support files:
yum update smeserver-support smeserver-yum yum yum-plugin-fastest-mirror python-sqlite signal-event post-upgrade; signal-event reboot
Now, clean your yum cache and update, forcing your system to use the default repositories
yum clean all yum --disablerepo=* \ --enablerepo=base \ --enablerepo=updates \ --enablerepo=smeaddons \ --enablerepo=smeos \ --enablerepo=smeupdates \ update signal-event post-upgrade; signal-event reboot
Finally, reset your yum repositories to the new defaults (post SME 7.1). Unless you are an expert with yum you are highly encouraged to reset your yum repository configuration to the defaults using the instructions found at AddingSoftware#Restoring_Default_Yum_Repositories
Updating from SME 7.1.3 to SME 7.2
CD Update
- Insert the CD into your server and issue a reboot, follow the instructions presented to you on the server screen to update to SME Server 7.2.
- Reset yum to the new default configuration as described here: AddingSoftware#Restoring_Default_Yum_Repositories
- Reset other settings to new defaults as shown here: Updating_to_SME_7.2#Updating_Configuration_Database_with_New_Default_Values
- Perform a final yum update to obtain any post-iso updates or patches.
Yum Update
First, make sure you are using the default yum repository configuration by following the instructions found at AddingSoftware#Restoring_Default_Yum_Repositories
Now, clear your local yum cache and perform the update:
yum clean all yum update signal-event post-upgrade; signal-event reboot
Cleanup Tasks
Ensuring the correct yum repository configuration
Unless you are an expert with yum you are highly encouraged to reset your yum repository configuration to the defaults using the instructions found at AddingSoftware#Restoring_Default_Yum_Repositories.
SME updates assume that the default repositories are enabled, and that any 3rd party repositories you may have configured are
- disabled by default
- created with appropriate "Exclude" paramaters
- accessed manually when necessary using the yum --enablerepo=xxx syntax.
Updating Configuration Database with New Default Values
SME 7.2 includes different default values for some settings. This section tells you how to change those values.
Generic Instructions
Any configuration database item that has a "default" value can be set to the default value using
config delprop key prop /etc/e-smith/events/actions/initialize-default-databases
Afterwards, you will need to re-expand the affected templates and restart the affected services:
signal-event post-upgrade; signal-event reboot
qpsmtpd LogLevel
SME 7.0 - 7.1.3 all defaulted to qpsmtpd LogLevel 8 (or 'debug') in order to make sure that the logfile contained all plugin results.
SME 7.2 now includes the qpsmtpd logterse plugin allowing us to reduce the LogLevel to 6 without loss of critical tracking information and simultaneously reducing log activity significantly.
config delprop qpsmtpd LogLevel /etc/e-smith/events/actions/initialize-default-databases signal-event email-update svc -t /var/service/qpsmtpd
RHSBL Servers
RHSBL or Right-Hand Side Black List: Search for known spam hosts by host name.
If you want to try out the RHSBL servers configured by default in SME 7.2:
config delprop qpsmtpd SBLList config setprop qpsmtpd SBLList bogusmx.rfc-ignorant.org:multi.surbl.org:black.uribl.com\ :rhsbl.sorbs.net:bulk.rhs.mailpolice.com:fraud.rhs.mailpolice.com\ :porn.rhs.mailpolice.com:adult.rhs.mailpolice.com:ex.dnsbl.org\ :blackhole.securitysage.com signal-event email-update
This will enable the following SBL servers for your system. Be sure to check them out to see if they are consistent with your policies before enabling them. Don't forget that RHSBL is disabled by default in SME!
- bogusmx.rfc-ignorant.org
- multi.surbl.org
- black.uribl.com
- rhsbl.sorbs.net
- bulk.rhs.mailpolice.com
- fraud.rhs.mailpolice.com
- porn.rhs.mailpolice.com
- adult.rhs.mailpolice.com
- ex.dnsbl.org
- blackhole.securitysage.com
DNSBL Servers
DNSBL (DNS Block List): Block spam hosts based on the IP address of the remote system.
If you want to try out the DNSBL servers configured by default in SME 7.2:
config delprop qpsmtpd RBLList config setprop qpsmtpd RBLList bl.spamcop.net:combined.njabl.org:dnsbl.ahbl.org\ :dnsbl-1.uceprotect.net:dnsbl-2.uceprotect.net:list.dsbl.org\ :multihop.dsbl.org:psbl.surriel.com:zen.spamhaus.org signal-event email-update
This will enable the following DNSBL servers for your system. Be sure to check them out before enabling them. (List updated 7/31/2007 to replace sbl-xbl.spamhaus.org with the new zen.spamhaus.org).
Don't forget that DNSBL is disabled by default in SME!
- bl.spamcop.net
- combined.njabl.org
- dnsbl.ahbl.org
- dnsbl-1.uceprotect.net Conservative (blocks single IPs)
- dnsbl-2.uceprotect.net More agressive (blocks class C networks)
- list.dsbl.org single-stage relays tested by trusted testers
- multihop.dsbl.org the outputs of multihop relays, tested by trusted testers
- psbl.surriel.com
- zen.spamhaus.org formerly sbl-xbl.spamhaus.org
Known Issues or Problems
Webmail / Horde
If you have created custom templates designed to change the appearance of Webmail or Horde on your system, you may have to delete your existing custom templates, copy the new version of the same template fragments, and make your customizations on the new copies.
Remote Administration using SSH Tunnels
Prior versions of SME Server allowed you to access server-manager using http://localhost:980/server-manager after establishing an ssh tunnel on port 980 to your SME server.
You could also establish a tunnel from local port xxxx to port 443 on your SME server, then access server-manager at https://localhost:xxxx/server-manager
Both of these options will now generate a page not found error after entering your admin username & password, as the login page automatically redirects both of these to "https://localhost/server-manager".
You can work-around this issue in one of 3 ways:
- Tunnel port 443, then login at https://localhost/server-manager
- Tunnel whatever port you used previously, get the error message, then manually return to your original URL
- Enable PPTP on your SME server and use a PPTP VPN for remote access to access server-manager.
Missing email folders after upgrade
This link explains why you may appear to be missing your mail folders after an upgrade: After I upgrade my SMESERVER, my email folders have disappeared when using IMAP
10fix_privilege_tables in message log
These messages are generated by /usr/share/mysql/mysql_fix_privilege_tables.sql. The script itself says:
You can safely ignore all 'Duplicate column' and 'Unknown column' errors because these just mean that your tables are already up to date. This script is safe to run even if your tables are already up to date!
http://bugs.contribs.org/show_bug.cgi?id=3223