Installation des Dienstprogramms „Mount Helper“

Installieren Sie Mount Helper auf Ihrem Rechenhost, um verschlüsselte Verbindungen zu File Storage for VPC zu automatisieren. Sie können das Paket unter GitHub herunterladen oder es aus dem Quellcode kompilieren.

Vorbereitende Schritte

Bevor Sie Mount Helper installieren, sollten Sie die Anforderungen und Einschränkungen prüfen, um sicherzustellen, dass Ihre Umgebung kompatibel ist.

Sie müssen eine Verbindung zu Ihrem Rechenhost herstellen:

Wenn Sie eine regionale Dateifreigabe auf einer VSI von „ IBM Power “ einbinden möchten, laden Sie das Installationspaket herunter und befolgen Sie die Schritte unter „Installation des Mount Helper“, um regionale Dateifreigaben einzubinden.

Installationspaket herunterladen

  1. Laden Sie das Mount-Helper-Paket von GitHub herunter.

    curl -LO https://github.com/IBM/vpc-file-storage-mount-helper/releases/download/latest/mount.ibmshare-latest.tar.gz

    Um eine verschlüsselte Verbindung zwischen einem Bare-Metal-Server und einer Dateifreigabe herzustellen, laden Sie Mount Helper in der Version 0.2.1 herunter.

  2. Extrahieren Sie die komprimierte Datei.

    tar -xvf mount.ibmshare-latest.tar.gz

    Die Datei enthält folgende Elemente: Installations- und Deinstallationsskripte, die Pakete „ rpm “ und „ deb “, Root-CA-Zertifikate sowie die Konfigurationsdatei.

    Geschlossene Umgebungen: Um Mount Helper auf einer virtuellen Serverinstanz ohne Internetverbindung zu installieren, erstellen oder aktualisieren Sie auf der VSI ein lokales Repository, das auf dem jeweiligen Betriebssystem basiert. Kopieren Sie das „Mount Helper“-Paket zusammen mit seinen Abhängigkeiten in das lokale Verzeichnis.

Installation des Mount Helpers zum Einbinden von Zonen-Dateifreigaben

  1. Um den Mount Helper und alle Abhängigkeiten zu installieren, verwenden Sie das folgende Skript und geben Sie die Region an, in der die Dateifreigabe eingebunden werden soll.

    ./install.sh region=us-south

    Das Argument „ region “ dient zum Kopieren des regionsspezifischen Root-CA-Zertifikats. Wird keine Region angegeben, kopiert das Dienstprogramm alle Zertifikate der Stammzertifizierungsstelle. Die folgende Tabelle enthält die Werte, mit denen Sie die Region angeben können.

    Von dem Skript akzeptierte Regionswerte
    Standort Neuer Wert Vorheriger Wert
    Australien – Sydney au-syd syd
    Brasilien – São Paulo br-sao sao
    Kanada – Montreal ca-mon
    Kanada – Toronto ca-tor tor
    Deutschland – Frankfurt eu-de fra
    Indien – Chennai – Airtel in-che
    Indien – Mumbai – Airtel in-mum
    Japan – Osaka jp-osa osa
    Japan – Tokio jp-tok tok
    Spanien – Madrid eu-es mad
    Vereinigtes Königreich – London eu-gb lon
    Vereinigte Staaten – Washington, D.C us-east wdc
    Vereinigte Staaten – Dallas, TX us-south dal

  2. Optional – Jedem Installationsimage liegt eine Datei bei, die den Prüfsummenwert für die Image-Datei enthält. Beispielsweise gehört zur Bilddatei „ ibmshare-0.0.1.tar.gz “ die Datei „ ibmshare-0.0.1.tar.gz.sha256 “, die den Prüfsummenwert enthält. Um die Integrität des heruntergeladenen Pakets zu überprüfen, verwenden Sie die folgenden Befehle.

    curl -LO https://github.com/IBM/vpc-file-storage-mount-helper/releases/download/latest/mount.ibmshare-latest.tar.gz.sha256

    sha256sum -c mount.ibmshare-latest.tar.gz.sha256

    Bei einer erfolgreichen Antwort wird „OK“ angezeigt. Die Ausgabe sieht wie im folgenden Beispiel aus.

    # sha256sum -c mount.ibmshare-latest.tar.gz.sha256
./mount.ibmshare-latest.tar.gz: OK

  3. Optional – Standardmäßig ist ein Zertifikat 1 Stunde lang gültig, und alle 45 Minuten werden neue Zertifikate abgerufen. Sie können jedoch die Option „ certificate_duration_seconds “ in der Konfigurationsdatei „ /etc/ibmcloud/share.conf “ auf ein anderes Zeitintervall ändern. Der neue Wert muss zwischen 5 Minuten und 1 Stunde liegen und in Sekunden angegeben werden.

    certificate_duration_seconds = 600

    Der gültige Bereich für den Wert „ certificate_duration_seconds “ liegt zwischen 300 und 3600 Sekunden. Die Zertifikate werden erneuert, sobald die aktuellen Zertifikate 70 % ihrer Gültigkeitsdauer erreicht haben.

  4. Optional – Wenn Sie die Zertifikate sofort mit dem neuen Ablaufdatum erneuern möchten, führen Sie den folgenden Befehl aus.

    /sbin/mount.ibmshare -RENEW_CERTIFICATE_NOW

Installation des Mount Helpers zum Einbinden regionaler Dateifreigaben

Standardinstallation mit stunnel

  1. Um den Mount Helper und alle Abhängigkeiten zu installieren, verwenden Sie das folgende Skript und geben Sie die Option „ --stunnel “ an.
    ./install.sh --stunnel
  2. Optional – Jedem Installationsimage liegt eine Datei bei, die den Prüfsummenwert für die Image-Datei enthält. Beispielsweise gehört zur Bilddatei „ ibmshare-0.0.1.tar.gz “ die Datei „ ibmshare-0.0.1.tar.gz.sha256 “, die den Prüfsummenwert enthält. Um die Integrität des heruntergeladenen Pakets zu überprüfen, verwenden Sie die folgenden Befehle.
    curl -LO https://github.com/IBM/vpc-file-storage-mount-helper/releases/download/latest/mount.ibmshare-latest.tar.gz.sha256

    sha256sum -c mount.ibmshare-latest.tar.gz.sha256
    Bei einer erfolgreichen Antwort wird „OK“ angezeigt. Die Ausgabe sieht wie im folgenden Beispiel aus.
    # sha256sum -c mount.ibmshare-latest.tar.gz.sha256
./mount.ibmshare-latest.tar.gz: OK

Installation ohne EPEL- und „ StrongSwan “-Abhängigkeiten

Wenn Sie regionale Dateifreigaben mit Verschlüsselung während der Übertragung einbinden müssen, aber die Installation der EPEL- und „ StrongSwan “-Pakete vermeiden möchten, können Sie die Umgebungsvariable „ DO_NOT_INSTALL_IPSEC “ verwenden. Bei diesem Ansatz werden nur die stunnel-Komponenten installiert, die für das Einbinden regionaler Dateifreigaben benötigt werden.

  1. Installieren Sie das Dienstprogrammepaket „ NFS “.
    dnf install nfs-utils
  2. Laden Sie das Mount-Helper-Paket von GitHub herunter.
    curl -LO https://github.com/IBM/vpc-file-storage-mount-helper/releases/download/latest/mount.ibmshare-latest.tar.gz
  3. Extrahieren Sie die komprimierte Datei.
    tar -xvf mount.ibmshare-latest.tar.gz
  4. Setzen Sie die Umgebungsvariable, um die IPsec-Installation zu überspringen.
    export DO_NOT_INSTALL_IPSEC=true
  5. Installieren Sie den Mount Helper mit der Option „stunnel“.
    ./install.sh --stunnel
  6. Stellen Sie sicher, dass „ StrongSwan “ und „EPEL“ nicht installiert wurden.
    rpm -q strongswan epel-release && dnf repolist enabled | grep -i epel
    Eine erfolgreiche Antwort zeigt an, dass die Pakete nicht installiert sind:
    package strongswan is not installed
package epel-release is not installed

Nach der Installation können Sie regionale Dateifreigaben einbinden, indem Sie die Anweisungen unter „Einbinden einer regionalen Dateifreigabe“ befolgen. Der Datenverkehr zwischen dem Client und dem Dateispeicherdienst wird mithilfe von stunnel verschlüsselt.

Kompilieren des Dienstprogramms „Mount Helper“ aus dem Quellcode

  • Führen Sie auf Instanzen auf Basis von „ Debian “ die folgenden Befehle aus:
    apt-get update -y
apt-get install git make python3 -y
git clone https://github.com/IBM/vpc-file-storage-mount-helper.git
cd vpc-file-storage-mount-helper
make build-deb
  • Führen Sie auf rpm-basierten Instanzen die folgenden Befehle aus:
    yum update -y
dnf install git make python3 rpm-build -y
git clone https://github.com/IBM/vpc-file-storage-mount-helper.git
cd vpc-file-storage-mount-helper
make build-rpm

Aktualisierung des Mount-Helpers

Um das Installationspaket zu aktualisieren, führen Sie das Skript „ install.sh “ erneut aus.

./install.sh

Verwenden Sie die Option „ --stunnel “, wenn Sie auch das stunnel-Paket aktualisieren möchten.

Deinstallation des Mount Helper

Mit dem folgenden Befehl wird das Dienstprogramm deinstalliert.

./uninstall.sh

Nächste Schritte