Registere the system with the ULN

After editing the configuration file, you are now ready to register the system with the ULN.

To register the system with the ULN:

  1. Run the /opt/opsware/patch_importer/bin/uln_import with the –show_conf option.

    This option has two main purposes. It shows your current configuration as well as registering the system if the system has not been previously registered with the ULN.

    [root@vc002 patch_importer]# /opt/opsware/patch_importer/bin/uln_import --show_conf
    ********** Configuration For ULN **********
    Retrieving platform information from SA
    Retrieving channel information from Oracle ULN
    |
    [system_profile]
    rand_key_path        : /var/opt/opsware/crypto/wordbot/.randkey-rhn_import
    package_path         : /var/opt/opsware/patch_importer/packages
    which_packages       : latest
    server_uri           : https://linux-update.oracle.com/XMLRPC
    cache_path           : /var/opt/opsware/uln_import/cache
    dbg_random_fail      : 0
    erratum_path         : /$network_name/Errata/$erratum_type Policies/$erratum_name
    download_server_uri  : http://linux-update.oracle.com/XMLRPC
    package_search_path  :
                /Package Repository/OS Media/$opsware_platform
                /Package Repository/All Red Hat Linux/$opsware_platform
                /Migrated/Package Repository/Customer Independent/$opsware_platform
     
    packages_only        : False
    errata_path          : /$network_name/Errata/$parent_channel_name/$channel_name Advisory Roll-Up Policy
    hide_passwords       : 1
    import_threads       : 5
    show_config_only     : 0
    tmp_path             : /var/opt/opsware/patch_importer
    system_id            : /etc/opt/opsware/patch_importer/system_id
    mode                 : all
    continue_on_error    : 1
    channel_path         : /$network_name/Channels/$parent_channel_name/$channel_name Policy
     
    [main]
    rand_key_path        : /var/opt/opsware/crypto/wordbot/.randkey-rhn_import
    erratum_path         : /ULN/Errata/$erratum_type Policies/$erratum_name
    which_packages       : latest
    package_path         : /ULN/Packages/$channel_name
    download_server_uri  : http://linux-update.oracle.com/XMLRPC
    package_search_path  :
    /Package Repository/OS Media/$opsware_platform
    /Package Repository/All Red Hat Linux/$opsware_platform
    /Migrated/Package Repository/Customer Independent/$opsware_platform
    packages_only        : False
    csi                  : 1234567
    proxy_host           : abc.acme.com:8080
    errata_path          : /ULN/Errata/$channel_name Advisory Roll-Up Policy
    import_threads       : 10
    tmp_path             : /var/opt/opsware/patch_importer
    system_id            : /etc/opt/opsware/patch_importer/system_id
    channel_path         : /ULN/Channels/$channel_name Policy
    continue_on_error    : 1
    username             : test@hpe.com
    server_uri           : https://linux-update.oracle.com/XMLRPC
    cache_path           : /var/opt/opsware/uln_import/cache
    dbg_random_fail      : 0
    password             : (Hidden)
    hide_passwords       : 1
    show_config_only     : 1
    mode                 : all
     
    <Configuration For Channel: ol5_x86_64_latest>
     
      Enabled         : True
      Packages Only   : False
      Which Packages  : latest
      Package Path    : /ULN/Packages/$channel_name
    ********************************************
  1. Once the system is registered, you should be able to view it under the Systems tab at the ULN: https://linux.oracle.com. By default, the ULN automatically assigns the latest platform channel to the newly registered system.

    A system_id file is created in /etc/opt/opsware/patch_importer/uln/. If you are unable to register with the ULN, you can check the log file at /var/log/opsware/patch_importer/patch_importer.log for possible errors. You can also run uln_import in debug mode if necessary.

    /opt/opsware/patch_importer/bin/uln_import --show_conf –v

    If you need to register with the ULN, make sure to remove the old system_id anddelete the registered system from the ULN before doing so.

    rm –rf /etc/opt/opsware/patch_importer/uln/system_id
    /opt/opsware/patch_importer/bin/uln_import –show_conf

Subscribing and unsubscribing channels from the ULN

Subscribing and unsubscribing channels must be done with the ULN. Before you can perform the subscription/unsubscription step, you need designate the system as a YUM server.

To designate the registered system as a YUM server:

  1. If you have different flavors of Enterprise Linux deployed in your environment, check the Yum Server box in the Edit System Properties tab of your registered system in order to subscribe to all the available channels.

    IMPORTANT: It is important to select the Yum Server box. If it is not selected, the ULN will restrict the channels to only those that are relevant to the registered system’s platform. By designating the registered system as a Yum Server, the ULN will allow it to subscribe to any currently available channels.

  2. Click Apply Changes to submit the changes.

    Once the registered system is designated as a Yum Server, it is capable of subscribing any channels currently available.

To subscribe/unsubscribe channels:

  1. Navigate to the Manage Subscriptions tab of the registered system.

    Keep in mind that some channels do not contain any updates. They are just base RPMs from the ISO or the release media. Some channels are superset of others. Also, unlike the RedHat network, the ULN has no concept of “parent channels.”

  2. Select the desired channels.
  3. To subscribe to a channel, move it from the Available channels column to the Subscribed channels column.

  4. To unsubscribe, move it from the Subscribed channels column to the Available channels column.

  5. Click Save Subscriptions.


  6. Once you subscribe to the desired channels from the ULN, you may want to verify it by running /opt/opsware/patch_importer/bin/uln_import with the –show_conf option to make sure the channels are enabled.

    [root@vc002 bin]# /opt/opsware/patch_importer/bin/uln_import --show_conf
    ********** Configuration For ULN **********
    Retrieving platform information from SA
    Retrieving channel information from Oracle ULN
    |
    [system_profile]
    rand_key_path        : /var/opt/opsware/crypto/wordbot/.randkey-rhn_import
    package_path         : /var/opt/opsware/patch_importer/packages
    which_packages       : latest
    server_uri           : https://linux-update.oracle.com/XMLRPC
    cache_path           : /var/opt/opsware/uln_import/cache
    dbg_random_fail      : 0
    erratum_path         : /$network_name/Errata/$erratum_type Policies/$erratum_name
    download_server_uri  : http://linux-update.oracle.com/XMLRPC
    package_search_path  :
                /Package Repository/OS Media/$opsware_platform
                /Package Repository/All Red Hat Linux/$opsware_platform
                /Migrated/Package Repository/Customer Independent/$opsware_platform
     
    packages_only        : False
    errata_path          : /$network_name/Errata/$parent_channel_name/$channel_name Advisory Roll-Up Policy
    hide_passwords       : 1
    import_threads       : 5
    show_config_only     : 0
    tmp_path             : /var/opt/opsware/patch_importer
    system_id            : /etc/opt/opsware/patch_importer/system_id
    mode                 : all
    continue_on_error    : 1
    channel_path         : /$network_name/Channels/$parent_channel_name/$channel_name Policy
     
    [main]
    rand_key_path        : /var/opt/opsware/crypto/wordbot/.randkey-rhn_import
    erratum_path         : /ULN/Errata/$erratum_type Policies/$erratum_name
    which_packages       : latest
    package_path         : /ULN/Packages/$channel_name
    download_server_uri  : http://linux-update.oracle.com/XMLRPC
    package_search_path  :
    /Package Repository/OS Media/$opsware_platform
    /Package Repository/All Red Hat Linux/$opsware_platform
    /Migrated/Package Repository/Customer Independent/$opsware_platform
    packages_only        : False
    csi                  : 12345678
    proxy_host           : test.acme.com:8080
    errata_path          : /ULN/Errata/$channel_name Advisory Roll-Up Policy
    import_threads       : 10
    tmp_path             : /var/opt/opsware/patch_importer
    system_id            : /etc/opt/opsware/patch_importer/system_id
    channel_path         : /ULN/Channels/$channel_name Policy
    continue_on_error    : 1
    username             : abc@hpe.com
    server_uri           : https://linux-update.oracle.com/XMLRPC
    cache_path           : /var/opt/opsware/uln_import/cache
    dbg_random_fail      : 0
    password             : (Hidden)
    hide_passwords       : 1
    show_config_only     : 1
    mode                 : all
     
    <Configuration For Channel: el5_u5_i386_patch>
     
      Enabled         : True
      Packages Only   : False
      Which Packages  : latest
      Package Path    : /ULN/Packages/$channel_name
     
     
    <Configuration For Channel: el5_u5_x86_64_patch>
     
      Enabled         : True
      Packages Only   : False
      Which Packages  : latest
      Package Path    : /ULN/Packages/$channel_name
     
    ********************************************

Keep in mind that SA will filter out the channels for the platforms that it does not currently support. For example, you may subscribe to Enterprise Linux 3 channels, but they will be ignored by SA.

Importing packages

By default, the SA Patch Importer will create a software policy for each channel, unless users elect not to do so by specifying the –package_only option.

To import the packages:

  1. Run /opt/opsware/patch_importer/bin/uln_import
    [root@vc002 bin]# /opt/opsware/patch_importer/bin/uln_import
    ********** Importing Packages From ULN **********
    Retrieving platform information from SA
    Retrieving channel information from Oracle ULN
    Processing package information
    |
     
    ***** Import Phase *****
     
    Importing 649 packages for channel Enterprise Linux 5 Update 5 Patch (x86_64)
    |============================================================| 100%  00:00:00
    Elapsed Time: 912 seconds
     
    Importing 530 packages for channel Enterprise Linux 5 Update 5 Patch (i386)
    |============================================================| 100%  00:00:00
    Elapsed Time: 978 seconds
     
    ULN Import Completed
     
    *************************************************
  2. When the import process is complete, you can logon to the SA Java Client to view the newly created policies.

  3. By default, the policies are created in the /ULN/Channels/ folder and will be named, <Channel Name> Policy, where <Channel Name> is the name of the channel. For example: /ULN/Channels/Enterprise Linux 5 Update 5 Patch (i386) Policy.

‘Read’ (or greater) permission to the /ULN/Channels/ folder is required to view the newly created policies.

  1. By default the packages are imported into the /ULN/Packages/<Channel Name>/ folder, where <Channel Name> is the name of the channel. For example: /ULN/Packages/Enterprise Linux 5 Update 5 Patch (i386)/

    ‘Read’ (or greater) permission to the channel folder is required to view the newly imported packages.

  1. After you verify the newly created software policies, you may start remediating the OEL servers.

You must have the proper permissions to perform remediation tasks. See the the SA 10.51 Use section for more information on software remediation.