Sie können ein Upgrade von SaltStack Config von einer vorherigen Version auf die neueste stabile Version durchführen.
Empfohlene Vorgehensweise beim Upgrade
Folgen Sie diesen Richtlinien, während Sie das Upgrade planen:
- Führen Sie das Upgrade nicht mithilfe des Installationsprogramms oder der Anweisungen für die manuelle Installation durch.Wenn Sie ein Upgrade Ihrer SaltStack Config-Installation durchführen, lesen Sie die folgenden Upgrade-Anweisungen.
- Um optimale Ergebnisse zu erzielen, erhöhen Sie schrittweise von einer Hauptversion zur nächsten. Es wird empfohlen, immer ein Upgrade von der neuesten Hauptversion von SaltStack Config auf die neue Version durchzuführen. Wenn Sie mit einer älteren Version arbeiten, führen Sie inkrementell ein Upgrade von einer Version zur nächsten durch.
- Sichern Sie Ihre Daten.Sichern Sie Ihre Daten, um Datenverlust zu verhindern.
- Führen Sie Upgrades während Zeiten mit langsamer Netzwerkaktivität durch.Datenbank-Upgrades erfordern eine Neuindizierung der Daten. Je nach der Komplexität Ihrer Daten kann ein Datenbank-Upgrade möglicherweise mehrere Stunden dauern. Um Dienstunterbrechungen zu vermeiden, sollten Sie ein Upgrade der Datenbank während Geschäftszeiten mit wenig Auslastung durchführen oder Ihre Datenbank vor einem Upgrade kürzen.
- Überprüfen Sie die Datenbank auf alle alten Befehle, die gespeichert sind.In einigen Fällen speichert die PostgreSQL-Datenbank alte Befehle, die nicht ausgeführt wurden. Diese Befehle werden möglicherweise während des Upgrade-Vorgangs ausgeführt, wenn Sie das Master-Plug-In neu starten. Um dies zu verhindern, überprüfen Sie, ob alte Befehle in der Datenbank gespeichert sind, und aktivieren Sie das Überspringen von Aufträgen, die älter als eine festgelegte Zeit sind.
- Testen Sie das Upgrade vor der Bereitstellung. Falls möglich, könnten Sie versuchen, eine Probe in einer Testumgebung durchzuführen. So können Sie ermitteln, wie lange das Upgrade dauern könnte.
- Lesen Sie zuerst die gesamte Anleitung durch. Sie sollten diese Anleitung einmal komplett durchlesen, bevor Sie ein Upgrade implementieren. Auf diese Weise erhalten Sie einen Überblick über die erforderlichen Aufgaben haben und können entscheiden, ob diese von Ihrem Team geplant werden müssen oder ob die Beteiligten über ausstehende Änderungen benachrichtigt werden müssen.
Upgrade von älteren Versionen
Es wird empfohlen, immer ein Upgrade von der neuesten Hauptversion von SaltStack Config auf die neue Version durchzuführen. Wenn Sie ein Upgrade von einer früheren Version als der neuesten Version durchführen, werden möglicherweise die besten Ergebnisse angezeigt, wenn Sie ein Upgrade von einer Hauptversion zur nächsten durchführen.
Anweisungen zum Upgrade auf frühere SaltStack Config-Versionen finden Sie in den spezifischen Upgrade-Anweisungen für die Versionen, von denen Sie das Upgrade durchführen. Die Upgrade-Anweisungen für vorherige Versionen sind in der PDF-Datei des Installationshandbuchs für die nachfolgende Version enthalten. Wenn Sie beispielsweise ein Upgrade von 5.5 auf 6.0 durchführen müssen, lesen Sie die Upgrade-Anweisungen in der PDF-Datei zur Installation von 6.0.
Verwenden Sie für SaltStack Config Version 8.4 und höher die Versionsauswahl oben auf dieser Seite, um den richtigen Upgrade-Leitfaden für Ihre Produktversion auszuwählen. Verwenden Sie für Versionen 8.3 und älter die PDF-Handbücher in der folgenden Tabelle:
Version | Installations- und Upgrade-Leitfaden (PDF) |
---|---|
8.3 | 8.3 Installations- und Upgrade-Leitfaden |
6.4 | 6.4 Installations- und Upgrade-Leitfaden |
6.3 | 6.3 Installations- und Upgrade-Leitfaden |
6.2 | 6.2 Installations- und Upgrade-Leitfaden |
6.1 | 6.1 Installations- und Upgrade-Leitfaden |
6.0.1 | 6.0.1 Installations- und Upgrade-Leitfaden |
6.0 | 6.0 Installations- und Upgrade-Leitfaden |
Vorgehensweise zum Durchführen eines Upgrades von SaltStack Config
- Sichern Sie Ihre Daten, einschließlich bestimmter Dateien und Verzeichnisse, die für Ihre spezifische Installation von SaltStack Config wichtig sind.
- Führen Sie ein Upgrade von PostgreSQL durch (optional, aber empfohlen)
- Führen Sie ein Upgrade Ihrer Salt-Infrastruktur durch (optional, aber empfohlen)
- Laden Sie die Upgrade-Dateien herunter
- Führen Sie ein Upgrade des RaaS-Knotens durch
- Führen Sie ein Upgrade von Salt-Mastern mithilfe des Master-Plug-Ins durch
Weitere Informationen zum Upgrade von SSC über Lifecyle Manager finden Sie unter Upgrade vRealize Automation SaltStack Config in der LCM-Dokumentation.
Sichern von SaltStack Config-Dateien und -Verzeichnissen
Die folgenden Dateien und Verzeichnisse enthalten Ihre benutzerdefinierten SaltStack Config-Konfigurationen und müssen vor der Aktualisierung gesichert werden:
- Sichern Sie auf dem RaaS-Knoten die folgenden gesamten Verzeichnisse:
/etc/raas/raas
/etc/raas/raas.secconf
/var/log/raas
/etc/raas/pki/
Hinweis:Das
pki
-Verzeichnis enthält ausgeblendete Dateien. Stellen Sie daher sicher, dass Sie das gesamte Verzeichnis sichern. Das Sichern der Protokolldateien im/var/log/raas
-Verzeichnis ist optional. Während des Upgrade-Vorgangs löschen Sie die Protokolldateien, um eine bereinigte Protokolldatei bereitzustellen, falls eine Fehlerbehebung erforderlich ist. - Sichern Sie die
/etc/salt/master.d/raas.conf
- und/etc/salt/master.d/eAPIMasterPaths.conf
-Dateien auf jedem Salt-Master.Hinweis:Je nachdem, wie Sie SaltStack Config installiert haben, können sich die eAPI Salt-Master-Pfade stattdessen in der
/etc/salt/master.d/raas.conf
-Datei befinden.
Sichern Ihres Datenbankschemas
Beim Aktualisieren Ihres RaaS-Knotens wird das Datenbankschema aktualisiert. Stellen Sie aus diesem Grund sicher, dass Sie vor der Aktualisierung eine Sicherung Ihrer Datenbank erstellen.
Um Ihre Datenbank zu sichern, müssen Sie zuerst Ihren PostgreSQL-Datenbanknamen suchen und dann den Inhalt kopieren:
- Sichern Sie diese Dateien auf dem PostgreSQL-Server:
postgres.conf
pg_hba.conf
- Melden Sie sich mit dem folgenden Befehl als
postgres
-Benutzer an:sudo su - postgres
- Rufen Sie Ihren Datenbanknamen mit den folgenden Befehlen auf, um auf PostgreSQL zuzugreifen. Listen Sie dann die Datenbanken auf:
psql \l
- Drücken Sie zum Beenden von PostgreSQL und zum Abmelden als
postgres
-Benutzer die Tastenkombination Strg+D und führen Sie dann den folgenden Befehl aus:exit
- Kopieren Sie den Datenbankinhalt in eine Datei. Der folgende Befehl zeigt ein Beispiel:
pg_dump -U salt_eapi raas_db_name > postgres_raas_backup_$(date +%Y-%m-%d).sql
Upgrade einer PostgreSQL-Datenbank
Für SaltStack Config ist eine PostgreSQL 9.6-Datenbank erforderlich, aber PostgreSQL 12.4 wird empfohlen. Die empfohlene Version von PostgreSQL ist im SaltStack Config-Installationsprogramm enthalten.
Ein Upgrade auf die neueste Version von PostgreSQL ist nicht erforderlich. Ein Upgrade von PostgreSQL kann jedoch möglicherweise die Leistung verbessern. Anweisungen zum Upgrade auf die neueste Version von PostgreSQL finden Sie unter PostgreSQL-Upgrade.
Upgrade einer Redis-Datenbank
Für SaltStack Config ist eine Redis 5.x-Datenbank erforderlich, aber Redis 5.0.4 wird empfohlen. Die empfohlene Version von Redis ist im Lieferumfang des SaltStack Config-Installationsprogramms enthalten.
Ein Upgrade auf die neueste Version von Redis 5.x ist nicht erforderlich. Ein Upgrade von Redis kann jedoch möglicherweise die Leistung verbessern. Anweisungen zum Upgrade von Redis finden Sie unter Redis-Verwaltung.
Upgrade von Salt
Stellen Sie für eine optimale Leistung sicher, dass die Salt-Komponenten in Ihrer Infrastruktur auf der neuesten Hauptversion von Salt ausgeführt werden. Stellen Sie z. B. sicher, dass Ihre Minions die neueste Salt-Version verwenden.
Anweisungen zum Upgrade Ihrer Salt-Master und anderer Salt-Komponenten finden Sie unter Upgrade Ihrer Salt-Infrastruktur.
Anweisungen zum Upgrade des Salt Crystal-Pakets finden Sie unter So führen Sie ein Upgrade von Salt Crystal durch.
Führen Sie ein Upgrade des RaaS-Knotens durch
Nach dem Upgrade auf die neueste Version von PostgreSQL, Redis und Salt können Sie den RaaS-Knoten von der vorherigen Version auf die neueste Version aktualisieren.
Vor dem Upgrade Ihres RaaS-Knotens müssen Sie Ihre Systemdaten sichern, um Datenverlust zu vermeiden.
So führen Sie ein Upgrade des RaaS-Knotens durch:
- Laden Sie die Upgrade-Dateien von Customer Connect herunter.
- Speichern Sie alle Änderungen, die Sie am Standarddateisystem, an Pfeilerdaten und Aufträgen vorgenommen haben, als neue Dateien oder Aufträge.
- Beachten Sie alle Pfeilerzuweisungen, die für die Standardziele vorgenommen wurden. Diese müssen nach dem Upgrade erneut zugewiesen werden.
- Beenden Sie den RaaS-Dienst mit dem folgenden Befehl:
sudo systemctl stop raas
- Entfernen Sie die Protokolldatei(en) im
/var/log/raas
-Verzeichnis. Durch das Löschen der Protokolldateien wird eine fehlerfreie Protokolldatei zur Verfügung gestellt, falls eine Fehlerbehebung erforderlich ist. - Entfernen Sie die aktuell installierte Version der API (RaaS) mit dem folgenden Befehl:
sudo yum remove raas
- Führen Sie ein Upgrade des RaaS-Knotens durch, indem Sie das neueste RPM installieren. Verwenden Sie den folgenden Beispielbefehl und ersetzen Sie den genauen Dateinamen des RPM:
sudo yum install raas-rpm-file-name.rpm
- WICHTIG: Stellen Sie die Sicherung der folgenden Dateien wieder her:
/etc/raas/raas
/etc/raas/raas.secconf
/etc/raas/pki/
- Aktualisieren Sie die Berechtigungen für den
raas
-Benutzer mit dem folgenden Befehl:sudo chown -R raas:raas /etc/pki/raas/certs
- OPTIONAL: Wenn Sie über eine SaltStack SecOps-Lizenz verfügen und die Konformitätssbibliothek hinzufügen möchten, fügen Sie den folgenden neuen Abschnitt zur
/etc/raas/raas
-Datei hinzu:sec: ingest_override: true locke_dir: locke post_ingest_cleanup: true username: 'secops' content_url: 'https://enterprise.saltstack.com/secops_downloads' download_enabled: true download_frequency: 86400 stats_snapshot_interval: 3600 compile_stats_interval: 10 ingest_on_boot: True content_lock_timeout: 60 content_lock_block_timeout: 120
Hinweis:Dieser Schritt ist optional und gilt nur für Organisationen, die über eine gültige SaltStack SecOps-Lizenz verfügen. Dieses Add-On-Modul ist für SaltStack Config-Versionen ab 6.0 verfügbar. Die vorherigen Konfigurationsoptionen in der
/etc/raas/raas
-Konfigurationsdatei sind spezifisch für diese Add-On-Module. - OPTIONAL: Wenn Sie über eine SaltStack SecOps-Lizenz verfügen und die Schwachstellenbibliothek hinzufügen möchten, fügen Sie der Datei
/etc/raas/raas
einen neuen Abschnitt hinzu:vman: vman_dir: vman download_enabled: true download_frequency: 86400 username: vman content_url: 'https://enterprise.saltstack.com/vman_downloads' ingest_on_boot: true compile_stats_interval: 60 stats_snapshot_interval: 3600 old_policy_file_lifespan: 2 delete_old_policy_files_interval: 86400 tenable_asset_import_enabled: True tenable_asset_import_grains: ['fqdn', 'ipv4', 'ipv6', 'hostname', 'mac_address', 'netbios_name', 'bios_uuid', 'manufacturer_tpm_id', 'ssh_fingerprint', 'mcafee_epo_guid', 'mcafee_epo_agent_guid', 'symantec_ep_hardware_key', 'qualys_asset_id', 'qualys_host_id', 'servicenow_sys_id', 'gcp_project_id', 'gcp_zone', 'gcp_instance_id', 'azure_vm_id', 'azure_resource_id', 'aws_availability_zone', 'aws_ec2_instance_ami_id', 'aws_ec2_instance_group_name', 'aws_ec2_instance_state_name', 'aws_ec2_instance_type', 'aws_ec2_name', 'aws_ec2_product_code', 'aws_owner_id', 'aws_region', 'aws_subnet_id', 'aws_vpc_id', 'installed_software', 'bigfix_asset_id' ]
Hinweis:Dieser Schritt ist optional und gilt nur für Organisationen, die über eine gültige SaltStack SecOps-Lizenz verfügen. Dieses Add-On-Modul ist für SaltStack Config-Versionen ab 6.0 verfügbar. Die vorherigen Konfigurationsoptionen in der
/etc/raas/raas
-Konfigurationsdatei sind spezifisch für diese Add-On-Module. - RaaS hat derzeit ein bekanntes Problem im Zusammenhang mit veralteten Aufträgen. Beim Upgrade bemerken einige Benutzer möglicherweise eine Warteschlange veralteter Aufträge, die im Status „Ausstehend“ hängenbleiben. Das Upgrade des RaaS-Knotens kann dazu führen, dass diese Aufträge ausgeführt werden, es sei denn, sie werden zuerst gelöscht.
Um dies zu verhindern, überprüfen Sie zunächst, ob alte Befehle in der Datenbank gespeichert sind. Überprüfen Sie auf Ihrem PostgreSQL-Knoten, ob ausstehende Aufträge vorhanden sind. Verwenden Sie dazu den folgenden Befehl:
select count(1) from commands where state='new';
Das Ergebnis ist die Anzahl der ausstehenden Aufträge. Wenn die Anzahl der Aufträge
0
beträgt, fahren Sie mit dem Rest des Upgrade-Vorgangs fort. - Führen Sie ein Upgrade der RaaS-Dienst-Datenbank mit dem folgenden Befehl durch:
sudo su - raas raas upgrade
Hinweis:Je nach Größe Ihrer Datenbank kann das Upgrade mehrere Minuten bis über eine Stunde dauern. Wenn Fehler auftreten, überprüfen Sie die
/var/log/raas/raas
-Protokolldatei, um weitere Informationen zu erhalten. - Beenden Sie nach dem Upgrade die Sitzung für den
raas
-Benutzer mit dem folgenden Befehl:exit
- Starten Sie den RaaS-Dienst mit dem folgenden Befehl:
sudo systemctl enable raas sudo systemctl start raas
Upgrade des Master-Plug-Ins
Nachdem Sie das Upgrade des RaaS-Knotens erfolgreich durchgeführt haben, können Sie anschließend alle Salt-Master aktualisieren, die das Master-Plug-In verwenden, um eine Verbindung zu SaltStack Config herzustellen.
Stellen Sie vor dem Upgrade des Salt-Masters bzw. der Salt-Master sicher, dass die pip3-Anwendung auf den Salt-Mastern installiert ist. Wenn Sie ein Upgrade von der neuesten Version des Master-Plug-Ins durchführen, ist diese Anwendung bereits installiert.
So führen Sie ein Upgrade des Master-Plug-Ins auf einem Salt-Master durch:
- Beenden Sie den Dienst
salt-master
mit dem folgenden Befehl:sudo systemctl stop salt-master
- Überprüfen Sie, welche Version von Python auf dem Salt-Master ausgeführt wird. Wenn Python 3.6 oder höher ausgeführt wird, sind keine Änderungen erforderlich. Löschen Sie andernfalls die vorherige Version des SSEAPE-Moduls. (SSEAPE ist das SaltStack Config-Plug-In für den Salt-Master). Beispiel:
RHEL/CentOS
sudo rm -rf /usr/lib/python3.6/site-packages/SSEAPE*
Ubuntu
sudo rm /usr/lib/python3.6/dist-packages/SSEAPE*
- Führen Sie ein Upgrade des Master-Plug-Ins durch, indem Sie das aktualisierte Python-Wheel manuell installieren. Verwenden Sie die folgenden Beispielbefehle, ersetzen Sie dabei den genauen Namen der Wheel-Datei:
RHEL/CentOS
sudo pip3 install SSEAPE-file-name.whl --prefix /usr
Ubuntu
sudo pip3 install SSEAPE-file-name.whl
Hinweis:Einige Benutzer müssen möglicherweise die Syntax für ihre Betriebssysteme in
pip3.6
oderpip36
ändern. - Aktualisieren Sie die API (RaaS)-Modulpfade, indem Sie die
/etc/salt/master.d/eAPIMasterPaths.conf
-Datei bearbeiten, um die Pfade zu den verschiedenen Modulen zu referenzieren. Sie können z. B. allepython2.7
-Referenzen in dieser Datei ändern aufpython3.6
ändern.Hinweis:Je nachdem, wie Sie SaltStack Config installiert haben, können sich die eAPI Salt-Master-Pfade stattdessen in der
/etc/salt/master.d/raas.conf
-Datei befinden. - Überprüfen Sie den
engines
-Abschnitt in/etc/salt/master.d/raas.conf
, um zu bestätigen, dass er den folgenden Bedingungen entspricht:engines: - sseapi: {} - eventqueue: {} - rpcqueue: {} - jobcompletion: {} - keyauth: {}
Hinweis:Wenn ein Problem aufgetreten ist, müssen Sie möglicherweise Ihre Sicherungen der Dateien
/etc/salt/master.d/raas.conf
und/etc/salt/master.d/eAPIMasterPaths.conf
wiederherstellen. - Stellen Sie bei Verwendung der Salt-Master-Schlüsselauthentifizierung (empfohlen) sicher, dass
sseapi_pubkey_path
konfiguriert ist undsseapi_username
undsseapi_password
in/etc/salt/master.d/raas.conf
auskommentiert wurden.sseapi_pubkey_path: /etc/salt/pki/master/sseapi_key.pub #sseapi_username: #sseapi_password:
- Überprüfen Sie, ob für die Einträge
master_job_cache
undevent_return
die Einstellungsseapi
festgelegt wurde. Derpgjsonb
-Returner ist nicht mehr verfügbar. - Starten Sie den Dienst
salt-master
mit dem folgenden Befehl:sudo systemctl start salt-master
Der Upgrade-Prozess ist jetzt abgeschlossen. Falls weitere Fehler auftreten, erhalten Sie unter Fehlerbehebung weitere Informationen.