This page shows documentation for version 15.5.4 of AlloyDB Omni.
See the latest AlloyDB Omni documentation.

Diese Seite wurde von der Cloud Translation API übersetzt.

Von AlloyDB Omni-Version 15.5.2 und niedriger zur neuesten Version migrieren

Ab AlloyDB Omni 15.5.4 wird AlloyDB Omni mit gängigen Tools zur Paketverwaltung gesteuert.

Wenn Sie bereits eine Installation von AlloyDB Omni haben, folgen Sie der Anleitung auf dieser Seite, um zur neuen Installation mit einem einzelnen Image zu migrieren.

Vorbereitung

Bevor Sie mit dem Upgrade auf die neueste Version von AlloyDB Omni beginnen können, müssen Sie die folgenden Voraussetzungen erfüllen, falls Sie dies noch nicht getan haben.

Upgrade auf AlloyDB Omni 15.5.2

Die neueste AlloyDB Omni-Version, die die AlloyDB Omni-Befehlszeile unterstützt, ist 15.5.2. Führen Sie den folgenden Befehl aus, um die Version von AlloyDB Omni zu prüfen:

sudo alloydb version

Die Ausgabe sieht dann ungefähr so aus:

AlloyDB Omni CLI version: 1.6
AlloyDB Omni database server version: 15.5.2

Wenn in der Ausgabe eine Datenbankversion angezeigt wird, die älter als 15.5.2 ist, führen Sie den folgenden Befehl aus, um ein Upgrade durchzuführen:

sudo alloydb database-server upgrade

Informationen zur vorhandenen Installation einholen

Führen Sie dazu diesen Befehl aus:
```
cat /var/alloydb/config/dataplane.conf
```
Notieren Sie sich aus der Ausgabe des Befehls cat die Werte der folgenden Variablen:
- DATADIR_PATH, z. B. /var/alloydb/main
- ENABLE_ALLOYDB_AI, z. B. FALSE
- PGPORT, z. B. 5432
- INSTANCE_TYPE, z. B. PRIMARY/READ_REPLICA

Direktes Upgrade ausführen

Beenden Sie die vorhandene Datenbank:
```
sudo alloydb database-server stop
```
Starten Sie die neue AlloyDB Omni-Instanz mit einem einzelnen Image und stellen Sie das vorhandene Datenverzeichnis bereit:
```
docker run --name CONTAINER_NAME \
    -e POSTGRES_PASSWORD=PASSWORD \
    -e PGDATA=/var/lib/postgresql/data \
    -v /var/alloydb/main/data:/var/lib/postgresql/data \
    -v /dev/shm:/dev/shm \
    -p PGPORT:5432 \
    --network=host \
    --ulimit=nice=-20:-20 \
    --ulimit=core=-1:-1 \
    --log-driver=journald \
    -d google/alloydbomni:15.5.4
```
Ersetzen Sie Folgendes:
- CONTAINER_NAME: Der Name, der diesem neuen AlloyDB Omni-Container in der Containerregistrierung Ihres Hosts zugewiesen werden soll, z. B. my-omni.
- PASSWORD: Das Passwort, das dem postgres-Nutzer des neuen Containers nach der Erstellung zugewiesen wurde.
- PGPORT: Die IP-Adresse des Ports, auf dem AlloyDB Omni ausgeführt wird. Dies ist der Wert, den Sie in Schritt 2 unter Informationen zur vorhandenen Installation erfassen notiert haben.
Die Argumente für docker run entsprechen denen in früheren Versionen von AlloyDB Omni. Sie können sie jedoch weiter anpassen. Weitere Informationen finden Sie unter AlloyDB Omni-Installation anpassen.

Wenn der Typ Ihrer Datenbankinstanz PRIMARY ist, führen Sie den folgenden Befehl aus, um die folgenden Nutzer zu erstellen. Dies sind derzeit nicht verwendete Nutzernamen, die aber für zukünftige Erweiterungen reserviert sind.

for name in alloydbagent alloydbexport alloydbiamgroupuser alloydbiamuser alloydbimportexport alloydbobservability alloydbsqllogical alloydbsuperuser; do
  echo docker exec -it CONTAINER_NAME psql -h localhost -U postgres alloydbadmin \
    -c "CREATE ROLE ${name} NOLOGIN;" \
    -c "CREATE TABLE ${name}_table();" \
    -c "ALTER TABLE ${name}_table OWNER TO ${name};"
done

Wenn ENABLE_ALLOYDB_AI auf TRUE festgelegt ist, folgen Sie der Anleitung unter AlloyDB Omni mit AlloyDB AI installieren, um AlloyDB AI einzurichten.
Stellen Sie eine Verbindung zur Datenbank her, um zu prüfen, ob die Daten unverändert sind:
```
docker exec -it CONTAINER_NAME psql -h localhost -U postgres
```
So deinstallieren Sie die AlloyDB Omni-Befehlszeile:
```
sudo alloydb database-server uninstall
```
Die Deinstallation der AlloyDB Omni-Befehlszeilenschnittstelle hat keine Auswirkungen auf die in AlloyDB Omni gespeicherten Daten.