5.3 Upgrade

Archive and Version Services is upgraded to the OES 2 server using either physical media or patch channel.

5.3.1 Physical Media Update

On upgrading the OES 2 server to OES 2 server, Archive and Version Services is automatically upgraded. For more information, see Upgrading to OES 2 SP3 in the OES 2 SP3: Installation Guide.

5.3.2 Patch Update

Upgrade the Archive and Version Services using the patch channel, then perform the additional steps for successful upgradation.

  1. At the command prompt, set the environment variable path.

    UPGRADE=2

  2. To launch YaST, execute the following command:

    yast2 arkmanager

    Specify the administrator and PostgreSQL database credentials.

  3. Restart the Archive server

    rcnovell-ark restart

On executing the above steps, Archive server runs with administrative rights and as an admin user.

5.3.3 Caveats on Upgrading from OES 1 to OES 2 SP1

On upgrading the Archive and Version Services from the OES 1 server to OES 2 SP1 Linux server, Archive server may fail to come up. The failure can be caused due to the following reasons:

  • The group id (gid) of both the novlxtier group (group in eDirectory tree) and the local user group (group on the local machine) are same.

  • Admin user is not listed as the part of the novlxtier group.

To resolve the group ids conflicts, perform the following steps, then restart the Archive server.

  1. To verify the groups of the admin, enter

    id admin

    For example, the output of the command is

    uid=600(admin) gid=600(admingroup) groups=600(admingroup) ,8(www) ,101(messagebus)
    

    The novlxtier group is not listed.

  2. The novlxtier gid must be 81. To verify if any object is using the same gid (81) of the novlxtier group, enter

    getent group | grep 81

  3. To change the gid of the novlxtier group to 81, enter

    namgroupmod -a adminname -w password -g 81 -o cn=novlxtier,servercontext

    On execution of the above command the gid of novlxtier group changes to 81.

    For more information on the namgroupmod utility, see namgroupmod in the OES 2 SP3: Novell Linux User Management Administration Guide.

  4. Changing the gid for novlxtier group may cause ownership issues on the files. To resolve the file ownership issues, execute the nssid.sh script.

    /opt/novell/oes-install/nssid.sh

    For more information, see The OES 1 Solution: The nssid.sh Script in the OES 2 SP3: Planning and Implementation Guide.

  5. To ensure that the admin user is part of the novlxtier group, enter

    id admin

    For example, the output of the command is

    uid=600(admin) gid=600(admingroup) groups=600(admingroup) ,8(www) ,81(novlxtier)
    

    The admin is part of the novlxtier group.

  6. To restart the Archive server, enter

    rcnovell-ark restart