This document (7018123) is provided subject to the disclaimer at the end of this document.
Environment
SUSE Manager 3 (salt client)
Situation
The SUSE Manager 3 has just been installed. What preparations/steps are needed in order to connect a salt client to SUSE Manager?
Resolution
1. Generate desired activation key.
a. Enter the webUI tool for SUSE Manager.
a. Enter the webUI tool for SUSE Manager.
b. Select the Systems tab at the top of the page.
c. Select the Activation keys tab on the left-hand side of the page.
d. Click the Create Key link in the upper right-hand corner.
i. Description – Enter a description to identify the generated activation key.
ii. Key – Choose either automatic generation by leaving this field blank or enter the key name that is wanted for generation.
iii. Usage – Determine the maximum amount of systems that may be simultaneously registered to the SUSE Manager with this key, or leave blank for unlimited use.
iv. Base Channels – Specify the channels accessible to the client using this key. If a system using this key is not compatible with the selected channel, it will fall back to the default channel. The default channel will automatically assign channels to the client based on installed products.
v. Add-On System Types – Select any additional entitlements for the clients to receive with this key.
vi. Contact Method – Select how clients communicate with the SUSE Manager. (Not applicable to salt clients)
vii. Universal Default – Select whether or not this key should be the primary activation key for this organization.
e. Click Create Activation Key to create the key.
2. Select product(s) to make into channels.
a. Select the Admin tab at the top of the page.
b. Select the SUSE Products sub-tab.
c. Check the boxes of the products you want to be mirrored by the SUSE Manager.
d. Click the Add Products button at the bottom of the page after selecting the desired products to mirror.
e. Wait for mirroring to complete.
3. Create bootstrap repository.
a. Run the following command on the SUSE Manager:
# mgr-create-bootstrap-repo
b. Enter the desired product label.
c. Repeat for all products you need your clients to use.
4. Add the SUSE Manager Tools repository to the client.
a. Run the following command on the client. (The path in the repo will vary slightly based on version and service pack. e.g. below is specific to SLE 11 SP4)
# zypper ar http://<fqdn of SUSE Manager>/pub/repositories/11/4/bootstrap/ spacewalk-tools-repo
5. Refresh the client’s repositories.
a. Run this command on the client:
# zypper ref -s
6. Install all available salt packages on the client.
a. Run this command on the client:
# zypper in salt*
7. Point the client to the SUSE Manager as salt master.
a. Open the /etc/salt/minion file on the client
b. Uncomment (remove # symbol at the beginning of the line) and adjust the following line:
master: <fqdn of suse manager>
8. Create salt grains file telling client which activation key to use.
8. Create salt grains file telling client which activation key to use.
a. Create /etc/salt/grains file
b. Open /etc/salt/grains file
c. Add the following: (spacing and indentation is important)
susemanager:
activation_key: 1-<key>
9. Restart and enable the salt-minion service.
a. Run matching client version’s commands:
SLE11:
# service salt-minion restart
# chkconfig salt-minion on
SLE12:
# systemctl restart salt-minion.service
# systemctl enable salt-minion.service
# systemctl enable salt-minion.service
10. Onboard the Salt Client from the SUSE Manager
a. Enter the webUI tool for SUSE Manager again.
b. Select the Salt tab at the top of the page
c. Your new machine should be listed as pending. Click accept on the machine you want to accept.
11. Deploy the SUSE Manager certificate to the client
a. Run this command on the SUSE Manager:
For a SLE11 client:
# salt ‘<client minion name>’ state.apply certs.SLES11
For a SLE12 client:
# salt ‘<client minion name>’ state.apply certs
b. At the end of the output from the command above you should see something like this:
Succeeded: 2 (changed=2)
Failed:0
———–
Total states run:2
Additional Information
Further Documentation:
https://www.suse.com/documentation/suse-manager-3/singlehtml/book_suma3_quickstart_3/book_suma3_quickstart_3.html#preparing.and.registering.clients
For rhnsd clients, further details can be found in TID 7017577 – Steps to Creating a SUSE Manager Client
Disclaimer
This Support Knowledgebase provides a valuable tool for NetIQ/Novell/SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented “AS IS” WITHOUT WARRANTY OF ANY KIND.