3.0 Migrating from SLRS 8 to Novell Linux Point of Service 9

If you are currently using SUSE® Linux Retail Solution 8 (SLRS 8), you can migrate your existing LDAP directory to Novell® Linux Point of Service 9. Furthermore, if you want to continue using your SLRS 8 images, you can migrate the images to your Novell Linux Point of Service 9 Administration Server so they can be distributed to your Point of Service terminals.

NOTE:This migration procedure does not migrate Novell eDirectory™ or IBM* Directory. You must use the respective directory tools to migrate eDirectory or IBM Directory.

To migrate from SLRS 8 to Novell Linux Point of Service 9:

  1. Execute the following commands to export the SLRS 8 LDAP directory to an LDIF file:

    rcldap stop slapcat -l ldif_file

  2. Save the LDIF file to a location off the box.

  3. (Optional) If you want to continue using your SLRS 8 images, do the following:

    1. Back up the /opt/SLES/POS/rsync/ directories to a location off the box.

      • /opt/SLES/POS/rsync/image/

        You must copy both the client images and their MD5 checksums.

      • /opt/SLES/POS/rsync/boot/

        You must back up the DiskNetboot images (initrd and linux) to provide the Linux kernel required to boot the SLRS 8 images.

      • /opt/SLES/POS/rsync/config/

        You must copy all the configuration files required for existing scConfigFileSyncTemplate objects in the LDAP directory.

    2. Rename the SLRS 8 initrd.gz file to initrd-slrs8.gz.

    3. Rename the SLRS 8 linux file to k_pos_ibm.

      NOTE:Leave the pxelinux.0 and pxelinux.cfg files as they are. They are not needed for the migration.

  4. (Optional) Maintain an SLRS 8 image server from your SLRS 8 system. This is required only if you want to continue to generate SLRS 8 images.

  5. Install the Novell Linux Point of Service 9 Administration Server.

    For specific instructions, see Section 4.0, Setting Up the Administration Server.

  6. Copy the LDIF file you exported in Step 1 to a location where the Novell Linux Point of Service 9 Administration Server can see it (for example, a floppy drive, pen drive, or NFS server).

  7. Run the following command to import the LDIF file:

    posInitLdap.sh --ldif=path_to_ldif_file

    This command performs the following functions:

    • Imports the SLRS 8 LDAP Directory.
    • Creates the SLRS 8 scDistributionContainer object.
    • Moves all existing scPosImage objects under the SLRS 8 scDistributionContainer object.
    • Updates all existing scCashRegister objects to point to scPOSimage objects in the SLRS 8 Distribution Container.
    • Changes the initrd.gz property in the scCashRegister objects to initrd-slrs8.gz.

  8. Copy the files you backed up in Step 3.a to the corresponding RSYNC directories on the Novell Linux Point of Service 9 Administration Server.

  9. Use the following command to copy the initrd file to the /opt/SLES/POS/rsync/boot/ directory as initrd.gz (type the command all on one line):

    cp /opt/SLES/POS/image/initrd-disknetboot-version-date.gz
/opt/SLES/POS/rsync/boot/initrd.gz

    IMPORTANT:The Novell Linux Point of Service 9 initrd file is required to boot SLRS8 images.

  10. Use the following command to copy the linux kernel file to the /opt/SLES/POS/rsync/boot/ directory as linux (type the command all on one line):

    cp /opt/SLES/POS/image/initrd-disknetboot-version-date.kernel.kernel_version /opt/SLES/POS/rsync/boot/linux

    IMPORTANT:The Novell Linux Point of Service 9 kernel file is required to boot SLRS8 images.

  11. Install the Branch Servers.

    For specific instructions, see Section 6.0, Setting Up a Branch Server.

  12. Run possyncimages.pl to pull the SLRS8 and Novell Linux Point of Service 9 images down to the Branch Servers.

    IMPORTANT:The Novell Linux Point of Service 9 kernel and initrd files are required to boot SLRS8 images; therefore, you must run possyncimages.pl to download linux and initrd.gz from the /rsync/boot/ directory on the Administration Server to the /tftpboot/boot/ directory on each Branch Server before you can boot SLRS 8 images on your Point of Service terminals.

  13. Run either posldap2crconfig.pl --dumpall or posAdmin --updateconfig to update the hardware configuration information on the Branch Server.

    These commands regenerate the hardware configuration and config.MAC_address files for all Point of Service terminals found in LDAP. For more information on the posldap2crconfig.pl command, see posldap2crconfig.pl in the Novell Linux Point of Service 9 Administration Guide. For information on the posAdmin --updateconfig command, see Updating config.MAC_address and Hardware Configuration Files in the Novell Linux Point of Service 9 Administration Guide.