Managing alternate content sources

Alternate content sources define alternate paths to download content during synchronization. The content itself is downloaded from the alternate content source, while the metadata is downloaded from the orcharhino Server or the upstream URL, depending on the configuration. You can use alternate content source to speed up synchronization if the content is located on the local filesystem or on a nearby network. You can set up alternate content sources for orcharhino Server and orcharhino Proxy. You must refresh the alternate content source after creation or after making any changes. A weekly cron job refreshes all alternate content sources. You can also refresh the alternate content sources manually using the orcharhino management UI or the Hammer CLI. Alternate content sources associated with your orcharhino Server, or orcharhino Proxy Servers attached to multiple organizations, affect all organizations.

There are three types of alternate content sources:

Custom

Custom alternate content sources download the content from any upstream repository on the network or filesystem.

Simplified

Simplified alternate content sources copy the upstream repository information from your orcharhino Server for the selected products. Simplified alternate content sources are ideal for situations where the connection from your orcharhino Proxy to the upstream repo is faster than from your orcharhino Server.

RHUI

RHUI alternate content sources download content from a Red Hat Update Infrastructure server. orcharhino management UI provides examples to help you find the network paths and to import authentication credentials.

Permission requirements for alternate content sources

Non-administrator users must have the below permissions to manage alternate content sources:

  1. view_smart_proxies

  2. view_content_credentials

  3. view_organizations

  4. view_products

In addition to the above permissions, assign permissions specific to alternate content sources, depending on the actions the users can perform:

  1. view_alternate_content_sources

  2. create_alternate_content_sources

  3. edit_alternate_content_sources

  4. destroy_alternate_content_sources

Alternate Content Sources (ACS) is a technical preview. ATIX AG does not recommend using this in your production environment.

Configuring custom alternate content sources

Prerequisites
Procedure
  1. In the orcharhino management UI, navigate to Content > Alternate Content Sources.

  2. Click Add Source and set the Source type as Custom.

  3. Select the Content type.

  4. In the Name field, enter a name for the alternate content source.

  5. Optional: In the the Description field, provide a description for the ACS.

  6. Select orcharhino Proxies to which the alternate content source is to be synced.

  7. Enter the Base URL of the alternate content source.

  8. Enter a comma-separated list of Subpaths.

  9. Provide the Manual Authentication or Content Authentication credentials, if these are needed.

  10. If SSL verification is required, enable Verify SSL and select the SSL CA certificate.

  11. Review details and click Add.

  12. Navigate to Content > Alternate Content Sources > click the vertical ellipsis next to the newly created alternate content source > Select Refresh.

CLI procedure
  1. On orcharhino Server, enter the following command:

    # hammer alternate-content-source create \
    --alternate-content-source-type custom \
    --base-url "https://local-repo.example.com:port" \
    --name "My_ACS_Name" \
    --smart-proxy-ids My_orcharhino_Proxy_ID
  2. Check if the newly created alternate content source is listed:

    # hammer alternate-content-source list
  3. Refresh the alternate content source:

    # hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID
  4. Add the orcharhino Proxies to which the alternate content source is to be synced:

    # hammer alternate-content-source update \
    --id My_Alternate_Content_Source_ID \
    --smart-proxy-ids My_orcharhino_Proxy_ID
  5. Refresh the alternate content sources:

    # hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID

Configuring simplified alternate content sources

Procedure
  1. In the orcharhino management UI, navigate to Content > Alternate Content Sources.

  2. Click Add Source and set the Source type as Simplified.

  3. Select the Content type.

  4. In the Name field, enter a name for the alternate content source.

  5. Optional: In the Description field, provide a description for the ACS.

  6. Select orcharhino Proxies to which the alternate content source is to be synced.

  7. Optional: Select Use HTTP proxies if you want the ACS to use the orcharhino Proxy Server’s HTTP proxy.

  8. Select the products that should use the alternate content source.

  9. Review details and click Add.

  10. Navigate to Content > Alternate Content Sources, click the vertical ellipsis next to the newly created alternate content source, and select Refresh.

CLI procedure
  1. Create a simplified ACS:

    # hammer alternate-content-source create \
    --alternate-content-source-type simplified \
    --name My_ACS_Name \
    --product-ids My_Product_ID \
    --smart-proxy-ids My_orcharhino_Proxy_ID
  2. Check if the newly created ACS is listed:

    # hammer alternate-content-source list
  3. Refresh the ACS:

    # hammer alternate-content-source refresh --id My_ACS_ID

Synchronizing orcharhino Proxy directly from Red Hat CDN

You can use simplified alternate content sources to configure your orcharhino Proxy to sync content directly from Red Hat CDN.

Procedure
  1. In the orcharhino management UI, navigate to Content > Alternate Content Sources.

  2. Click Add Source and set the Source type as Simplified.

  3. Set the Content type to Yum.

  4. In the Name field, enter a name for the alternate content source.

  5. Optional: In the Description field, provide a description for the alternate content source.

  6. Select orcharhino Proxies that you want to sync directly from Red Hat CDN.

  7. Optional: Select Use HTTP proxies if you want the ACS to use the orcharhino Proxy Server’s HTTP proxy.

  8. Select the Red Hat products that should be synced to the orcharhino Proxy from Red Hat CDN.

  9. Review details and click Add.

  10. Navigate to Content > Alternate Content Sources, click the vertical ellipsis next to the newly created alternate content source, and select Refresh.

The orcharhino Proxy will now download content from Red Hat CDN and not the orcharhino.

Configuring RHUI alternate content sources

Prerequisites
Procedure
  1. In the orcharhino management UI, navigate to Content > Alternate Content Sources.

  2. Click Add Source and set the Source type as RHUI.

  3. Generate RHUI certificates using the command provided in the orcharhino management UI. Ensure that you pass the repo labels of the desired repositories.

  4. In the Name field, enter a name for the alternate content source.

  5. Optional: In the Description field, provide a description for the ACS.

  6. Select orcharhino Proxies to which the alternate content source is to be synced.

  7. Optional: Select Use HTTP proxies if you want the ACS to use the orcharhino Proxy’s HTTP proxy.

  8. Enter the Base URL of the Red Hat Update Infrastructure CDS node.

  9. Enter a comma-separated list of Subpaths.

  10. Provide the Content Credentials, if these are needed.

  11. If SSL verification is required, enable Verify SSL and select the SSL CA certificate.

  12. Review details and click Add.

  13. Navigate to Content > Alternate Content Sources, click the vertical ellipsis next to the newly created alternate content source, and select Refresh.

CLI procedure
  1. On orcharhino Server, enter the following command:

    # hammer alternate-content-source create \
    --alternate-content-source-type rhui \
    --base-url "https://rhui-cds-node/pulp/content" \
    --name "My_ACS_Name" \
    --smart-proxy-ids My_orcharhino_Proxy_ID \
    --ssl-client-cert-id My_SSL_Client_Certificate_ID \
    --ssl-client-key-id My_SSL_Client_Key_ID \
    --subpaths path/to/repo/1/,path/to/repo/2/ \
    --verify-ssl 1
  2. Check if the newly created alternate content source is listed:

    # hammer alternate-content-source list
  3. Refresh the alternate content source:

    # hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID
  4. Add the orcharhino Proxies to which the alternate content source is to be synced:

    # hammer alternate-content-source update \
    --id My_Alternate_Content_Source_ID \
    --smart-proxy-ids My_orcharhino_Proxy_ID
  5. Refresh the alternate content sources:

    # hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID

The text and illustrations on this page are licensed by ATIX AG under a Creative Commons Attribution Share Alike 4.0 International ("CC BY-SA 4.0") license. This page also contains text from the official Foreman documentation which uses the same license ("CC BY-SA 4.0").