Registering Alibaba Cloud Linux Clients

This section contains information about registering traditional and Salt clients running Alibaba Cloud Linux operating systems.

  • Alibaba Cloud Linux repository URLs are available from SUSE Customer Center

  • Packages and metadata are provided by Alibaba Cloud, not by SUSE

  • For supported products, see the support table and the release notes

The traditional stack is available on Alibaba Cloud Linux 2 but it is not supported. Alibaba Cloud Linux 2 clients are only supported as Salt clients.

Some Alibaba Cloud Linux 2 instances will need two tries to register successfully.

1. Add Software Channels

Before you register Alibaba Cloud Linux clients to your SUSE Manager Server, you need to add the required software channels, and synchronize them.

In the following section, descriptions often default to the x86_64 architecture. Replace it with other architectures if appropriate.

The products you need for this procedure are:

Table 1. Alibaba Cloud Linux Products - WebUI
OS Version Product Name

Alibaba Cloud Linux 2

Alibaba Cloud Linux 2 x86_64

Procedure: Adding Software Channels
  1. In the SUSE Manager Web UI, navigate to Admin  Setup Wizard  Products.

  2. Locate the appropriate products for your client operating system and architecture using the search bar, and check the appropriate product. This will automatically check all mandatory channels. Also all recommended channels are checked as long as the include recommended toggle is turned on. Click the arrow to see the complete list of related products, and ensure that any extra products you require are checked.

  3. Click Add Products and wait until the products have finished synchronizing.

Alternatively, you can add channels at the command prompt. The channels you need for this procedure are:

Table 2. Alibaba Cloud Linux Channels - CLI
OS Version Base Channel

Alibaba Cloud Linux 2

alibaba-2-x86_64

Procedure: Adding Software Channels at the Command Prompt
  1. At the command prompt on the SUSE Manager Server, as root, use the mgr-sync command to add the appropriate channels:

    mgr-sync add channel <channel_label_1>
    mgr-sync add channel <channel_label_2>
    mgr-sync add channel <channel_label_n>
  2. Synchronization starts automatically. If you want to synchronize the channels manually, use:

    mgr-sync sync --with-children <channel_name>
  3. Ensure the synchronization is complete before continuing.

2. Check Synchronization Status

Procedure: Checking Synchronization Progress from the Web UI
  1. In the SUSE Manager Web UI, navigate to Admin  Setup Wizard and select the Products tab. This dialog displays a completion bar for each product when they are being synchronized.

  2. Alternatively, you can navigate to Software  Manage  Channels, then click the channel associated to the repository. Navigate to the Repositories tab, then click Sync and check Sync Status.

Procedure: Checking Synchronization Progress from the Command Prompt
  1. At the command prompt on the SUSE Manager Server, as root, use the tail command to check the synchronization log file:

    tail -f /var/log/rhn/reposync/<channel-label>.log
  2. Each child channel generates its own log during the synchronization progress. You need to check all the base and child channel log files to be sure that the synchronization is complete.

3. Create an Activation Key

You need to create an activation key that is associated with your Alibaba Cloud Linux channels.

For more information on activation keys, see Activation Keys.

4. Register Clients

To register your clients, you need a bootstrap repository. By default, bootstrap repositories are automatically created, and regenerated daily for all synchronized products. You can manually create the bootstrap repository from the command prompt, using this command:

mgr-create-bootstrap-repo

For more information on registering your clients, see Client Registration.

Some Alibaba Cloud Linux 2 instances will fail to register on the first try.

This is due to a to a known bug in the Alibaba Cloud Linux 2 image.

The python-urlgrabber3 package is provided both as a Python pip package and an RPM package, which can cause a conflict on the first attempt to register.

If your instance is based on one of the affected image versions, the client should register correctly on the second registration attempt.