Jump to contentJump to page navigation: previous page [access key p]/next page [access key n]
Applies to SUSE Linux Enterprise Point of Service 11 SP3 and SUSE Linux Enterprise Point of Service 12 Image Server

12 Migration from Older Versions

This section covers the migration from SUSE Linux Enterprise Point of Service 10 systems to SUSE Linux Enterprise Point of Service 11 systems.

12.1 Migration from SUSE Linux Enterprise Point of Service 10 to SUSE Linux Enterprise Point of Service 11

Migrating SUSE Linux Enterprise Point of Service 10 to SUSE Linux Enterprise Point of Service 11 is done during SUSE Linux Enterprise Server 10 upgrade to SUSE Linux Enterprise Server 11. No pre-migration actions are required, but backing up of the SUSE Linux Enterprise Point of Service 10 system is recommended.

12.1.1 Pre-Requisites

  • Installed and configured SUSE Linux Enterprise Point of Service 10 system,

  • SUSE Linux Enterprise Server 11 media,

  • SUSE Linux Enterprise Point of Service 11 add-on product.

12.1.2 Pre-Migration Backup

It is highly recommended to back up your SUSE Linux Enterprise Point of Service 10 configuration before upgrading. On the Administration Server, backup configuration files are stored in the /etc/SLEPOS directory and the LDAP database. The LDAP database can be backed up by saving output of the slapcat command or the content of the /var/lib/ldap directory.

On the Branch Server, only the branchserver.conf configuration file is affected by the migration procedure.

12.1.3 Migration Procedure

  1. Start the installation of SUSE Linux Enterprise Server 11 as an upgrade from your current SUSE Linux Enterprise Server 10 and SUSE Linux Enterprise Point of Service 10 system. When asked for the installation add-on, provide the path to your SUSE Linux Enterprise Point of Service 11 add-on.

    Note
    Note: Network Interfaces

    During the installation of SUSE Linux Enterprise Server 11, set up your network interfaces as specified in the SUSE Linux Enterprise Point of Service 10 LDAP database.

  2. During the installation of the SUSE Linux Enterprise Point of Service 11 add-on, the previous SUSE Linux Enterprise Point of Service 10 installation is detected automatically. You will be asked to confirm the detected components or to make adjustments.

  3. After confirming the installation, SUSE Linux Enterprise Point of Service 11 will be installed and configured according to the existing SUSE Linux Enterprise Point of Service 10 installation.

  4. If the Branch Server migration fails because of a wrong configuration of DNS or the IP address or unavailibility of the Administration Server, the migration can be completed manually after the SUSE Linux Enterprise Server 11 installation with the command:

    posInitBranchserver --noninteractive --reinitialize=/etc/SLEPOS/branchserver.conf
Note
Note: Log Files Related to Migration

In case of any problems during migration, see /var/log/YaST2/y2log and the /var/log/messages log files.

12.1.4 Post-Migration Procedures

12.1.4.1 Firewall Configuration

Firewall settings are migrated by the SUSE Linux Enterprise Server 11 upgrade.

12.1.4.2 ScHarddisk LDAP Entry

Many disk drives available in /dev/hdX in SUSE Linux Enterprise Point of Service 10 are available in /dev/sdX in SUSE Linux Enterprise Point of Service 11. This can cause problems after migration.

For example, if there is a scCashRegister object with scHarddisk /dev/hda in the SUSE Linux Enterprise Point of Service 10 LDAP database, migrating to SUSE Linux Enterprise Point of Service 11 with old images and an old kernel works correctly. The old images contain an old kernel with the naming scheme used in SUSE Linux Enterprise Point of Service 10. But when you assign newly-built SUSE Linux Enterprise Point of Service 11 images to the scCashRegister object, you need to change scHarddisk accordingly.

12.2 Manual Conversion of Image Configurations for SUSE Linux Enterprise Point of Service 11 SP2

Image configurations created in SUSE Linux Enterprise Point of Service 11 or SUSE Linux Enterprise Point of Service 11 SP1 must be converted for use in SUSE Linux Enterprise Point of Service 11 SP2. This conversion is done automatically in Image Creator. If you want to use old configurations directly in KIWI, convert the configurations using xsltproc and the stylesheet provided in /usr/share/kiwi/xsl/convertSleposSp1toSp2.xsl.

The following example assumes default paths and overwrites the old configuration file with the new one. To keep the old configuration and save the output to a different file, change the -o parameter:

 xsltproc -o /var/lib/SLEPOS/system/image_name/config.xml \
             /usr/share/kiwi/xsl/convertSleposSp1toSp2.xsl \
             /var/lib/SLEPOS/system/image_name/config.xml

12.3 Migration from SUSE Linux Enterprise Point of Service 11 SP1 to SUSE Linux Enterprise Point of Service 11 SP2

No pre-migration actions are required.

12.3.1 Pre-Requisites

  • Installed and configured SUSE Linux Enterprise Point of Service 11 SP2 system with latest updates

  • Available SMT service

12.3.2 Migration Procedure

  1. Save the content of the LDAP database on the SUSE Linux Enterprise Point of Service 11 SP1 Administration Server to an ldif file:

    slapcat >sp1.ldif
  2. On the SUSE Linux Enterprise Point of Service 11 SP1 Administration Server, save system and boot images excluding PXE and KIWI files:

    find /srv/SLEPOS/boot /srv/SLEPOS/image  \! -type d \! -path "*pxelinux*"  \
    -print |tar czf sp1-images.tar.gz -T-
  3. Move the sp1.ldif and sp1-images.tar.gz to a freshly installed SUSE Linux Enterprise Point of Service 11 SP2 FP2 Administration Server. Make sure the fix for bnc#775040 is installed.

  4. Unpack the sp1-images.tar.gz file to the root directory (/).

  5. Run posInitAdminserver. The organisation and country must be the same as on the original installation. It is possible to change password or encryption.

  6. Delete the preconfigured image, which might conflict with the migrated one:

    posAdmin --remove --recursive --DN cn=default,cn=global,o=myorg,c=us
  7. Import the ldif file:

    posAdmin --import --type LDIF --file sp1.ldif

    There will be warnings that the organisation objects already exist. It is normal.

  8. Validate the LDAP database:

    posAdmin -v info --validate
  9. Reinstall the Branch Servers.

  10. Run posInitBranchserver on every Branch Server.

    Append --enable-pos-services option to posInitBranchserver call if you had posleases2ldap and posASWatch running on the Branch Server.

  11. Regenerate config.MAC and other files on every Branch Server:

    pos dump-all
  12. Boot the terminals.

12.4 Migration from SUSE Linux Enterprise Point of Service 11 SP2 to SUSE Linux Enterprise Point of Service 11 SP3

The migration consist of three steps:

  1. Collect the old data from the Administration Server.

    Use the SUSE Linux Enterprise Point of Service backup tool slepos_backup_data.sh to collect the old configuration, LDAP and images. To use this tool, make sure you have installed the POS_Migration package from SUSE Linux Enterprise Point of Service 11 SP3 on your old system:

    /usr/lib/SLEPOS/migration/slepos_backup_data.sh -f backup_file_name.tgz
  2. Migrate the data to the SUSE Linux Enterprise Point of Service 11 SP3 Administration Server

    Transfer the collected backup to your SUSE Linux Enterprise Point of Service 11 SP3 server (make sure the POS_Migration package is installed) and call slepos_migrate.sh tool:

     /usr/lib/SLEPOS/migration/slepos_migrate.sh --deploy_type=AS -f backup_file_name.tgz

    After the migration is completed, call posAdmin --validate to make sure the LDAP database was correctly imported.

  3. Reinitialize the Branch Servers

    Branch Servers are not migrated, they are always initialized as new. After a Branch Server is (re)initialized, call pos dump-all to regenerate configuration files for cash registers.

Note
Note: SUSE Linux Enterprise Point of Service 11 SP2 Images

It is possible to use SUSE Linux Enterprise Point of Service 11 SP2 images with SUSE Linux Enterprise Point of Service 11 SP3 servers.

Print this page