SUSE Manager/ Certificate of Entitlement Update Tool

From MicroFocusInternationalWiki
Jump to: navigation, search


Introduction

This document explains how to extend the expiration date of the old Spacewalk entitlements certificate from 2015 - 2018. SUSE Manager systems which have not been updated will require that this update tool is run to maintain current entitlements.

Environment

SUSE Manager 1.7

SUSE Manager 2.1

Situation

The Spacewalk Entitlement Certificate expires end of 2015-07-13 00:00:00.

Any update action run on a client connected to the SUSE Manager will report an error. For example a "rhn_check":

   # rhn_check Could not retrieve action item from server <RetryServer for susemanger.domain/XMLRPC>
   Error code: -3006
   Error Message:
      SUSE Manager Certificate has expired
   Error Class Code: 3006
   Error Class Info: Invalid SUSE Manager certificate
   Explanation:
       An error has occurred while processing your request. If this problem
       persists please enter a bug report at bugzilla.novell.com.
       If you choose to submit the bug report, please be sure to include
       details of what you were trying to do when this error occurred and
       details on how to reproduce this problem

Resolution

Please patch your system to the latest provided state greater than or equal to susemanager-2.1.18-0.7.2.

You will find the new script "/usr/lib/susemanager/bin/susemanager-update-swcert.sh" after the update.



Note: Please make sure to run "mgr-sync refresh" before executing the following script !



Note: We highly recommend you run this tool even if your system has been regularly updated to ensure your current entitlements remain active past July 2015.


To update your spacewalk entitlement certificate please complete the following procedure.

At the server command line run:


/usr/lib/susemanager/bin/susemanager-update-swcert.sh


There are three prompts you may encounter after using this tool.


  • ##### Your spacewalk certificate is up-to-date.#####


  • ##### Update successfully finished.#####


  • ##### Update failed.#####


The update will fail if you have more than one organization setup and are sharing your entitlements across a second or third organization. The number of entitlements per row on the organization entitlements page cannot exceed 19,999 within a secondary organization. This bug occurs due to an incompatibility with SUSE subscription counting and the old spacewalk certificate. As a work around log-in to the SUSE Manager web administration page and complete the following procedure.


  1. Select the Admin tab.
  2. On the admin page under the organization column select your Secondary Organization.
  3. Click the Subscriptions tab.
  4. Under System Entitlements re-allocate the number of entitlements to a number low as possible for each entitlement in the Proposed Total column.
  5. Image of Organization 2 Entitlements Page
  6. Select Update Organization.
  7. Re-run the update tool with: /usr/lib/susemanager/bin/susemanager-update-swcert.sh

The prompt should provide: ##### Update successfully finished.#####

You may now re-allocate your original required entitlements on your web admin entitlements page

Troubleshooting Organization Name

If after running the susemanager-update-swcert.sh tool you find that your organization is no longer named properly, you may rename the organization using one of the following two commands.

At the SUSE Manager command line enter the API interface with:

  1. #spacecmd
  2. spacecmd {SSM:0}org_rename "OLDNAME" "NEWNAME"


Alternatively if you wish to bypass spacecmd you can escape the spaces at the normal prompt like so:

  1. # spacecmd -- org_rename "OLD\ SERVER\ NAME" "NEW\ SERVER\ NAME"


Note: If you do not escape the spaces the second command will fail.