18.1 Migrating CIFS to OES 2023

This section describes how to migrate CIFS from a supported OES server to OES 2023.

Before you proceed with the migration, review Prerequisites. In this section, the source server refers to supported OES versions and the target server refers to an OES 2023 server.

18.1.1 What is Migrated

  • Server configuration information

  • Shares

  • Contexts

18.1.2 Prerequisites

18.1.3 Migration Procedure

  1. Migrating Server Configuration information:

    In case of ID Swap, on the target server using iManager replicate the following server properties:

    • Name

    • Comment

    • Domain/Workgroup

    • Support for Oplocks

    • Support for DFS

  2. Migrating Share information:

    During the migration process, all shares except the shares that have been manually added are migrated. To replicate the shares that are manually added, use the CIFS iManager plug-in. For details, seeManaging CIFS Shares in the OES 2023: OES CIFS for Linux Administration Guide.

  3. Migrating Context information:

    Manual: Copy the context file /etc/opt/novell/cifs/cifsctxs.conf from the source server to the target server.

    iManager: Using CIFS iManager plug-in, replicate the CIFS user's context. For details, see Configuring a CIFS User Contextin the OES 2023: OES CIFS for Linux Administration Guide.

    NOTE:After completing the migrate, ensure that you reconfigure CIFS service using yast2 novell-cifs or use the iManager Add Context task to add the contexts to the cifsctxs.conf file, before you enable subtree search feature.

  4. Copying CIFS configuration file:

    Copy the CIFS configuration file /etc/opt/novell/cifs/cifs.conf from the source to the target server.

    CIFS configuration settings are stored in eDirectory and configuration files. During Transfer ID migration, the settings in eDirectory are migrated automatically, whereas the settings stored in the configuration files are not. To migrate them manually, copy the cifs.conf file to the target server.

  5. If the source server is OES 2015 SP1 or older version, add the following parameters manually in the /etc/opt/novell/cifs/cifs.conf file on the target server.

    1. -OCS yes

    2. -LOG_LEVEL with the required option. The available log level options are: debug, info, and error. For example, to configure debug as the log level, add the parameter -LOG_LEVEL debug

  6. Restart the CIFS server using the systemctl restart novell-cifs.service command.

  7. Proceed to perform proxy migration. For services using the common proxy, see Services that are Using Common Proxy.

18.1.4 Post Transfer ID Migration Procedure

OES 2015 to OES 2023

After performing the migration steps in Transfer ID Migration Procedure, perform the following tasks:

Restarting the CIFS service

  1. Run the following command to restart the service:

    systemctl restart novell-cifs.service

Re-enabling Pass-through Information Levels Capability

  1. If you have enabled pass-through information levels capability on the target server, copying the cifs.conf file might overwrite the settings. Re-enable it on the target server after the migration is complete by running the novcifs -info-level-passthru=yes command.

Enabling “Share volumes by default” Option

After migration of CIFS service to OES 2023, default shares will not be mounted by CIFS.

  1. View the list of all available share points using the command novcifs -sl.

  2. Check the status of "Share volumes by default" attribute using the command novcifs --list-servers.

  3. Enable the “Share volumes by default” attribute using the command novcifs --share-vols-default=<netbios name of the physical or virtual server> --value=yes.

    For example, novcifs --share-vols-default=BLR8-192.168_W --value=yes.

18.1.5 Verifying Migration

After you have migrated the CIFS services to the OES 2023 target, verify that the migration process is complete by checking for the following details: