Best Practices

Publication Date: 2018-05-22
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 Mirroring Tool (RMT) and Disconnected Setup (DMZ)
2.2.2 Subscription Management Tool (SMT) and Disconnected Setup (DMZ)
2.2.3 Updating Repositories on SUSE Manager From Storage Media
2.2.4 Refreshing Data on the Storage Medium
3 Expanded Support
3.1 Managing RES Clients
3.1.1 Server Configuration for RES Channels
3.1.2 RES Channel Management Tips
3.1.3 Mirroring RHEL Media into a Channel
3.1.4 Registering RES Salt Minions with SUSE Manager
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 SUSE Manager
4 Salt Formulas and SUSE Manager
4.1 What are Salt Formulas?
4.2 Installing Salt Formulas via RPM
4.3 File Structure Overview
4.4 Editing Pillar Data in SUSE Manager
4.4.1 Simple edit-group Example
4.5 Writing Salt Formulas
4.6 Separating Data
4.7 SUSE Manager Generated Pillar Data
4.8 Formula Requirements
4.9 Using Salt Formulas with SUSE Manager
5 Configuration Management with Salt
5.1 Configuration Management Overview
5.2 State Data
5.3 Salt States Storage Locations
5.4 SUSE Manager States
5.5 Pillar Data Exposed by SUSE Manager
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 SUSE Manager Daemon rhnsd)
8.2.1 Configuring SUSE Manager 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 Configuring and Enabling osad
8.5.2 osad Configuration and Logging Files
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 SUSE Manager Server Migration
11.1 Service Pack Migration Introduction
11.2 Service Pack Migration
11.3 Upgrading PostgreSQL to Version 9.6
11.4 Updating SUSE Manager
11.5 Migrating SUSE Manager version 3.0 to 3.1
11.5.1 Using YaST
11.5.2 Using zypper
12 SUSE Manager Migration from Version 2.1 to Version 3
12.1 Prerequisites
12.2 Setup the Target Machine
12.3 Performing the Migration
12.4 Speeding up the Migration
12.5 Packages on External Storage
12.6 Troubleshooting a Broken Web UI after Migration
12.7 Example Session
13 Client Migration
13.1 Migrating SUSE Linux Enterprise Server  12 or later to version 12 SP3
13.2 Migrating SUSE Linux Enterprise  11 SPx to version 12 SP3
14 Sample Autoinstallation Script for System Upgrade (SLES 11 SP4 to SLES 12 SP3)
15 Postgresql Database Migration
15.1 New SUSE Manager Installations
15.2 Migrating an Existing Installation
15.3 Performing a Fast Migration
15.4 Typical Migration Sample Session
16 Database Backup and Restoration
16.1 Files and Directories Requiring Backup
16.2 Administering The SUSE Manager Database with (smdba)
16.3 Starting and Stopping the Database
16.4 Backing up the Database
16.5 Automatic Backup with cron
16.6 Restoring a Database Backup
16.7 Archive Log Settings
16.8 Retrieving an Overview of Occupied Database Space
16.9 Moving the Database
16.10 Recovering from a Crashed Root Partition
16.11 Database Connection Information
17 Authentication Methods
17.1 Authentication Via PAM
17.2 Authentication Via eDirectory and PAM
17.3 Example Quest VAS Active Directory Authentication Template
18 Using a Custom SSL Certificate
18.1 Prerequisites
18.2 Setup
18.3 Using a Custom Certificate with SUSE Manager Proxy
19 Troubleshooting
19.1 Registering Cloned Salt Minions
19.2 Registering Cloned Traditional Systems
19.3 Typical OSAD/jabberd Challenges
19.3.1 Open File Count Exceeded
19.3.2 jabberd Database Corruption
19.3.3 Capturing XMPP Network Data for Debugging Purposes
19.3.4 Engineering Notes
19.4 RPC Connection Timeout Settings
20 Additional Resources
20.1 Learning YAML Syntax for Salt States
20.2 Getting Started with Jinja Templates
20.3 Salt Best Practices
21 A SUSE Manager 2.1 and 3.2 Product Comparison
A GNU Licenses
22 GNU Free Documentation License
Print this page