Technical article 126724

How to upgrade from SCOoffice 4.1 to SCOoffice 4.2 on single system

OpenServer 6.0.0OpenServer 5.0.7

Written · Last revised

Problem

If you want to upgrade your current system that is running OpenServer 5.0.7 with SCOoffice 4.1 to OpenServer 6.0 with SCOoffice 4.2 follow the steps below:

Solution

The following steps should be done to the SCOoffice 4.1 system before it is take offline:

First of all determine confirm whether /opt/insight is in a separate filesystem to root, as recommended in: http://uw714doc.xinuos.com/en/scooffice/gsg_before_install.html#_Allocating_a_Separate

to determine disk space requirements and expectation.

1.  Logged onto the Web Interface as user "admin".
2.  Select Tools -> Backup & Restore -> Create Backup ->
LDAP,
and then click the Backup button.
(This step is used to generate a new
/opt/insight/var/openldap-data/slapcat.ldif

file with all the latest LDAP information.

3.  Select Tools -> Backup & Restore -> Create Backup ->
    Mail, and then click the Backup button.

Depending on the customization which has been done, there maybe other areas which you need to deal with:

3a. If any system aliases have been created then /opt/insight/etc/mail/aliases needs to be saved so it can be moved to the new system and hashed.

3b. The web client preference ( including signatures ) are in a directory under /opt/insight/icc/data and need to be saved to be moved to the new server.

3c. If filters have been setup, they are under /opt/insight/var/imap/seive and need to be saved and moved to the new server.

4.  Make note of changes made to network, DNS and SCOoffice
    configuration files (main.cf, etc.) to help with new install.
Next, shut the system down.

The following steps are performed to install the new OpenServer6.0 with SCOoffice 4.2.

The steps below assume that you are going to use a new hard drive to install onto.

If you wish to use the same hard drive, then make sure you have a backup of the entire /opt/insight directory structure from the old system before continuing.

5.  As a guide, take the hard drive out of slot 1 and insert it into
    slot 2, (or whatever is appropriate for your system. If you are
    installing on the same hard drive then skip step 5 and 6).
6.  Insert a new drive into slot 1. (or whatever is appropriate for
    your system)
7.  Do a fresh install of OpenServer 6.
8.  Install OpenServer 6.0 MP2 and/or latest Maintenance Pack
    Supplement, configure network and DNS for mail server.
9.  Perform a default installation of SCOoffice 4.2.
10. Mount the second drive that has OpenServer 5.0.7 and SCOoffice
    4.1 mail server on it to /drive2 (or whatever mount point you
    wish to use).
11. Stop the slapd process.  Use the following command:
# /opt/insight/etc/rc/slapd stop

12. Use the slapadd command to add the LDAP content from the SCOoffice 4.1 system:

# cat /drive2/opt/insight/var/openldap-data/slapcat.ldif | \
  /opt/insight/sbin/slapadd -c

If you are installing onto the same hard drive and you performed a backup of all your data, then restore the file:

/opt/insight/var/openldap-data/slapcat.ldif
from backup.  Make sure to include the correct path to it
in the slapadd command.)
13. Copy the mail backup file:
/drive2/opt/insight/htdocs/is4web/tar/mail-......cpio.gz
over to the /opt/insight/htdocs/is4web/tar directory.

If you are installing onto the same hard drive and you performed a backup of all your data, then restore the file:

/opt/insight/htdocs/is4web/tar/mail-......cpio.gz

into the same directory on the new system.

14. Log into the web interface as user "admin" and select:

Tools -> Backup & Restore -> Restore and Upload, then click on
the "Restore" button out to the right of the latest
"mail-.......cpio.gz" file  (this will restore all the users
email on this new system.)

15. Edit the file /opt/insight/etc/postfix/main.cf to add any additional changes that you manually made to the old server.

		Manual changes to  /opt/insight/etc/postfix/main.cf can
		be lost if the admin web interface is used.

For example, you may need have to add any additional domains that your server was receiving email for.

Example, server name is mail.domain1.com.

If your email server also receives email for the domains:

domain2.com and domain3.com then the following are the changes you should make to the main.cf file.

myhostname = mail.domain1.com   #this should already be there
mydomain = domain1.com   #this should already be there
myorigin = $ mydomain    #this should already be there
mydestination = $myhostname,$mydomain,domain2.com,domain3.com
# the last two entries are new
relay_domains = $mydestination     #this should already be there

16. Stop and start the entire mail server using the following commands:

# /etc/init.d/insightserver stop
# /etc/init.d/insightserver start

Your new server should now be ready for production use again and you should now be able to umount and remove the "old" drive.

From the Xinuos technical article database, record 126724. Reproduced with permission. The original is at www.sco.com/ta/126724, which is reachable but blocked from search engines.

Next step

Need this fixed rather than explained?

Tell us the release, what the system runs and what it is doing. We will reply by email with what we would do next.

  • You deal with the people who do the work
  • No obligation, and no upgrade required before we will help
  • We tell you plainly if something is not worth doing

Send an enquiry

We reply by email. If a server is down, say so in the first line. You can also write to help@scoexpert.com.