Add a chapter for manual plugin installation (#2112)

This commit is contained in:
René Pfeuffer
2022-09-02 11:04:28 +02:00
committed by GitHub
parent e0a56a1369
commit c2428a6df5
2 changed files with 24 additions and 0 deletions

View File

@@ -37,3 +37,16 @@ Auf der Übersicht für installierte Plugins werden alle auf der SCM-Manager Ins
Auf der Übersicht der verfügbaren Plugins werden alle kompatiblen Plugins, die über das SCM-Plugin-Center zur Verfügung stehen, aufgeführt. Die Plugins können über den Download-Icon heruntergeladen und mit einem Neustart des SCM-Manager-Servers installiert werden.
![Administration-Plugins-Available](assets/administration-plugins-available.png)
### Manuelle Installation
Plugins sind als `smp` Dateien gepackt. Um ein Plugin mithilfe einer solchen Datei zu installieren, muss diese Datei
einfach in den Ordner `plugins` im SCM-Home Verzeichnis kopiert werden (in diesem Verzeichnis liegen bereits
Verzeichnisse für andere Plugins, z. B. `scm-git-plugin`).
Beim nächsten Start des Servers findet dieser diese Dateien und schließt die Installation ab. Zu beachten ist hierbei,
dass die manuelle Installation gewisse Risiken birgt, da der Server im Vorfeld nicht prüfen kann, ob alle Voraussetzungen
wie z. B. andere Plugins vorhanden sind. Der Start kann bei fehlenden Voraussetzungen abbrechen. Daher sollte das Log
beim Start im Blick bleiben.
Zum manuellen Entfernen eines Plugins reicht es, das entsprechende Verzeichnis, in dem das Plugin vom Server entpackt wurde, zu
löschen. Auch hier ist zu beachten, dass hierdurch gewisse andere Plugins in Mitleidenschaft gezogen werden könne, wenn
diese von dem Plugin abhängen. Die sogenannten Core Plugins (Git, Mercurial, SVN und Legacy) können nicht gelöscht werden.

View File

@@ -38,3 +38,14 @@ The overview of all available plugins shows all plugins that are compatible with
Special myCloudogu-plugins can be installed the same way if your instance of SCM-Manager is connected to myCloudogu as described above.
![Administration-Plugins-Available](assets/administration-plugins-available.png)
### Manual Installation
Plugins are packaged as `smp` files. To install a plugin using such a file, simply copy it to the `plugins`
folder in your scm home directory (you should find directories for other plugins there, for example `scm-git-plugin`).
The server will find these files on startup and finish the installation. Keep in mind though, that manual installation
might have some risks, because the server cannot check for missing dependencies to other plugins or other requirements
beforehand, and therefore the startup may fail. So keep an eye on your log if you choose this way.
To remove a plugin, simply delete the directory created by the server for this plugin. Here, too, one has to be
cautious, because other plugins may depend on this plugin. The so-called core plugins (git, mercurial, svn und legacy)
cannot be deleted.