Uyuni Documentation › Best Practices
ContentsContents
Best Practices
  1. 1 Introduction
  2. 2 Managing Your Subscriptions
  3. 3 Expanded Support
  4. 4 Salt Formulas and Uyuni
  5. 5 Configuration Management with Salt
  6. 6 Salt Minion Scalability
  7. 7 Activation Key Management
  8. 8 Contact Methods
  9. 9 Advanced Patch Lifecycle Management
  10. 10 Live Patching with SUSE Manager
  11. 11 Uyuni Server Migration
  12. 12 Client Migration
  13. 13 PostgreSQL Database Migration
  14. 14 Backup and Restore
  15. 15 Authentication Methods
  16. 16 Using a Custom SSL Certificate
  17. 17 Troubleshooting
  18. 18 Additional Resources
  19. 19 A Uyuni 2.1 and 3.2 Product Comparison
  20. A GNU Licenses
  21. 20 GNU Free Documentation License
Navigation←→
Uyuni Documentation › Best Practices
Top
←→

Best Practices

Publication Date: 2018-10-25
1 Introduction
1.1 What’s Covered in this Guide?
1.2 Prerequisites
1.3 Network Requirements
1.4 Hardware Recommendations
2 Managing Your Subscriptions
2.1 SUSE Customer Center (SCC)
2.2 Disconnected Setup with RMT or SMT (DMZ)
2.2.1 Repository Management Tool (RMT) and Disconnected Setup (DMZ)
2.2.2 Repository Management Tool (SMT) and Disconnected Setup (DMZ)
2.2.3 Updating Repositories on Uyuni From Storage Media
2.2.4 Refreshing Data on the Storage Medium
3 Expanded Support
3.1 Managing Red Hat Enterprise Linux Clients
3.1.1 Server Configuration for Red Hat Enterprise Linux Channels
3.1.2 Red Hat Enterprise Linux Channel Management Tips
3.1.3 Mirroring RHEL Media into a Channel
3.1.4 Registering RES Salt Minions with Uyuni
3.1.5 Register a Salt Minion via Bootstrap
3.1.6 Manual Salt Minion Registration
3.2 Preparing Channels and Repositories for CentOS Traditional Clients
3.3 Registering CentOS Salt Minions with Uyuni
4 Salt Formulas and Uyuni
4.1 What are Salt Formulas?
4.2 Installing Salt Formulas via RPM
4.3 File Structure Overview
4.4 Editing Pillar Data in Uyuni
4.4.1 Simple edit-group Example
4.5 Writing Salt Formulas
4.6 Separating Data
4.7 Uyuni Generated Pillar Data
4.8 Formula Requirements
4.9 Using Salt Formulas with Uyuni
5 Configuration Management with Salt
5.1 Configuration Management Overview
5.2 State Data: Levels of Hierarchy
5.3 Salt States Storage Locations
5.4 Uyuni States
5.5 Pillar Data
5.6 Group States
6 Salt Minion Scalability
6.1 Salt Minion Onboarding Rate
6.2 Minions Running with Unaccepted Salt Keys
6.3 Salt Timeouts
6.3.1 Background Information
6.3.2 A Presence Ping Mechanism for Unreachable Salt Minions
6.3.3 Overriding Salt Presence Timeout Values
6.3.4 Salt SSH Minions (SSH Push)
7 Activation Key Management
7.1 What are Activation Keys?
7.2 Provisioning and Configuration
7.3 Activation Keys Best Practices
7.3.1 Key Label Naming
7.3.2 Channels which will be Included
7.4 Combining Activation Keys
7.5 Using Activation Keys and Bootstrap with Traditional Clients (Non-Salt)
7.6 Using Activation Keys when Registering Salt Minions
7.6.1 Using an Activation Key and Custom Grains File
7.6.2 Using an Activation Key in the Minion Configuration File
8 Contact Methods
8.1 Selecting a Contact Method
8.2 Default (the Uyuni Daemon rhnsd)
8.2.1 Configuring Uyuni rhnsd Daemon
8.2.2 Viewing rhnsd Daemon Status
8.3 Push via SSH
8.3.1 Configuring the Server for Push via SSH
8.3.2 Using sudo with Push via SSH
8.3.3 Client Registration
8.3.4 API Support for Push via SSH
8.3.5 Proxy Support with Push via SSH
8.4 Push via Salt SSH
8.4.1 Overview
8.4.2 Requirements
8.4.3 Bootstrapping
8.4.4 Configuration
8.4.5 Action Execution
8.4.6 Known Limitation
8.4.7 For More Information
8.5 OSAD
8.5.1 Enabling and Configuring OSAD
9 Advanced Patch Lifecycle Management
10 Live Patching with SUSE Manager
10.1 Introduction
10.2 Initial Setup Requirements
10.3 Live Patching Setup
10.4 Cloning Channels
10.5 Removing Non-live Kernel Patches from the Cloned Channels
10.6 Promoting Channels
10.7 Applying Live Patches to a Kernel
11 Uyuni Server Migration
11.1 Service Pack Migration Introduction
11.2 Service Pack Migration
11.3 Upgrading PostgreSQL to Version 9.6
11.4 Updating Uyuni
11.5 Migrating Uyuni version 3.1 to 3.2
11.5.1 Using YaST
11.5.2 Using zypper
11.6 Uyuni Migration from Version 2.1 to Version 3
11.6.1 Prerequisites
11.6.2 Setup the Target Machine
11.6.3 Performing the Migration
11.6.4 Speeding up the Migration
11.6.5 Packages on External Storage
11.6.6 Troubleshooting a Broken Web UI after Migration
11.6.7 Example Session
12 Client Migration
12.1 Upgrading SLE 12 SPx to version 15
12.1.1 System Upgrade Preparation
12.1.2 Sample Autoinstallation Script for System Upgrade (SLES 12 SP3 to SLES 15)
12.2 Migrating SLE 12 or later to version 12 SP3
13 PostgreSQL Database Migration
13.1 New Uyuni Installations
13.2 Migrating an Existing Installation
13.3 Performing a Fast Migration
13.4 Typical Migration Sample Session
14 Backup and Restore
14.1 Backing up Uyuni
14.2 Administering the Database with smdba
14.3 Database Backup with smdba
14.3.1 Performing a Manual Database Backup
14.3.2 Scheduling Automatic Backups
14.4 Restoring from Backup
14.5 Archive Log Settings
14.6 Retrieving an Overview of Occupied Database Space
14.7 Moving the Database
14.8 Recovering from a Crashed Root Partition
14.9 Database Connection Information
15 Authentication Methods
15.1 Authentication Via PAM
15.2 Authentication Via eDirectory and PAM
15.3 Example Quest VAS Active Directory Authentication Template
16 Using a Custom SSL Certificate
16.1 Prerequisites
16.2 Setup
16.3 Using a Custom Certificate with SUSE Manager Proxy
17 Troubleshooting
17.1 Registering Cloned Salt Minions
17.2 Registering Cloned Traditional Systems
17.3 Typical OSAD/jabberd Challenges
17.3.1 Open File Count Exceeded
17.3.2 jabberd Database Corruption
17.3.3 Capturing XMPP Network Data for Debugging Purposes
17.3.4 Engineering Notes: Analyzing Captured Data
17.4 RPC Connection Timeout Settings
17.5 Client/Server Package Inconsistency
17.6 Corrupted Repository Data
17.7 Unable to Get Local Issuer Certificate
18 Additional Resources
18.1 Learning YAML Syntax for Salt States
18.2 Getting Started with Jinja Templates
18.3 Salt Best Practices
19 A Uyuni 2.1 and 3.2 Product Comparison
A GNU Licenses
20 GNU Free Documentation License
List of Figures
4.1 edit-group Example in the Web UI
4.2 pxe formula
4.3 branch network formula
4.4 saltboot formula
4.5 saltboot formula partitions
4.6 Bind Formula
4.7 bind-02-zones
4.8 bind-03-records
4.9 bind-03-records2
4.10 bind-04-reverse
4.11 dhcpd formula
4.12 tftpd formula
4.13 vsftpd formula
7.1 Provisioning and Configuration Overview
7.2 Combining Activation Keys
7.3 Combining Activation Keys 2
8.1 rhnsd Contact Method
8.2 Push via SSH Contact Method
8.3 Push via Salt SSH Contact Method
List of Tables
1.1 Required Server Ports
19.1 Comparing Traditional Management and Salt Management
19.2 Comparing Uyuni 2.1 and 3.2 Functionality
→Chapter 1 Introduction
Print this page

© 2018 SUSE