staging.inyokaproject.org

Snipe-IT

Status: Gelöst | Ubuntu-Version: Nicht spezifiziert
Antworten |
Dieses Thema ist die Diskussion des Artikels Snipe-IT.

krrhh

Anmeldungsdatum:
1. Juli 2019

Beiträge: 6

Hi,

ich denke, das Wesentliche sollte im Artikel stehen. Ist das verständlich geschrieben und nachvollziehbar oder habe ich irgendwo grob daneben gegriffen?

Ich bin die Anleitung gerade Schritt für Schritt in einer VM durchgegangen und habe danach den Verweis auf den erfolgreichen Test für 18.04 eingefügt, sollte also im Prinzip soweit passen.

Ich weiß, dass bei manuell installierter Software noch eine Anleitung für die Deinstallation dazu gehört, die liefere ich nach. Ich habe es bisher nur noch nie deinstalliert und muss das selbst erstmal ausklamüsern.

noisefloor Team-Icon

Ehemaliger
Avatar von noisefloor

Anmeldungsdatum:
6. Juni 2006

Beiträge: 28316

Hallo,

und willkommen bei ubuntuusers.de ☺

Beim 1. Überfliegen sind mir zumindest keine schwerwiegenden Fehler aufgefallen ☺ Deinstallation ist in der Tat Pflicht, wobei sich das ja hier denke ich auf das manuelle Löschen bestimmter Verzeichnisse, wo das Prog liegt sowie der Deinstallation der Pakete via Composer beschränken sollte.

Was aber definitiv fehlt der Teil Benutzung. Wo zumindest grob umrissen wird, wie das Programm grundlegend zu bedienen ist. Ohne Bedienung ist der Artikel unvollständig.

Gruß, noisefloor

krrhh

(Themenstarter)

Anmeldungsdatum:
1. Juli 2019

Beiträge: 6

Danke. ☺

Die Deinstallation sollte jetzt soweit beschrieben sein (nicht ganz sicher bin ich mir bei Composer, vielleicht weißt da zur Deinstallation von Paketen jemand mehr als ich?), ein Ansatz für die Verwendung ist auch da. Ich denke, an der Stelle würde es Sinn ergeben, beispielhaft durch das Einpflegen von Datensätzen in den einzelnen Kategorien zu führen, da wird dann alles einmal berührt. Das gehe ich in den kommenden Tagen mal durch.

noisefloor Team-Icon

Ehemaliger
Avatar von noisefloor

Anmeldungsdatum:
6. Juni 2006

Beiträge: 28316

Hallo,

in der Baustelle hier im Wiki entsteht gerade ja ein Artikel zu composer - vielleicht werden wir da schlauer ☺

Im Deinstallationsteil kannst du den Abschnitt der Pakete entfernen, dass muss nicht explizit erwähnt werden. Kann man sich selber aus der Installationsanleitung ableiten.

Gruß, noisefloor

krrhh

(Themenstarter)

Anmeldungsdatum:
1. Juli 2019

Beiträge: 6

Okay, die Deinstallation ist entrümpelt. Außerdem ist das versprochene Anwendungsbeispiel jetzt drin. Das sollte die Sache soweit veranschaulichen, denke ich.

Fehlt dann noch was? Aus meiner Sicht sollte das Wichtigste jetzt drinstehen.

Den Artikel über Composer halte ich im Auge und korrigiere dann bei Bedarf nachträglich den entsprechenden Abschnitt.

krrhh

(Themenstarter)

Anmeldungsdatum:
1. Juli 2019

Beiträge: 6

*bump*

Cranvil

Anmeldungsdatum:
9. März 2019

Beiträge: 990

Hallo,

ich habe die Gelegenheit mal genutzt, den Artikel zu testen und grundsätzlich funktioniert er. Nachfolgend ein paar Dinge, die mir aufgefallen sind.

Die Anforderungen 🇬🇧 von Snipe-IT informieren uns, dass PHP mindestens in Version 7.1.2 vorliegen muss, was einen Test unter 16.04 mit den distributionseigenen Paketen mangels Herstellerunterstützung aus meiner Sicht unnötig macht. Dieser Zusammenhang sollte im Wiki erwähnt werden.

Eine Alternative hierzu wäre die Ergänzung des Artikels um eine Installation neuerer PHP-Versionen, z.B. aus Ondřej Surýs PPA. In diesem PPA werden die neuesten noch unterstützten Versionen von PHP für die neuesten noch unterstützten Versionen von Ubuntu bereitgestellt. Hier ist dann allerdings noch die obligatorische Fremdquellen-Warnung einzupflegen. Ich habe diese Möglichkeit nicht getestet, gehe jedoch davon aus, dass es genauso problemlos wie bei der 18.04er Version klappt. Vielleicht ergänze ich den Artikel dann später noch. ☺

Nach meinem Geschmack sollte die Paketliste tatsächlich eine Liste sein. Ich habe das hier mal exemplarisch eingefügt, damit meine Anmerkungen besser sichtbar werden.

{{{#!vorlage Paketinstallation
apache2
libapache2-mod-php7.2
php7.2
php7.2-mysql
mysql-server
git
composer
unzip
php7.2
mcrypt
php-curl
php-gd
php-ldap
php-zip
php-mbstring
php-xml
php-bcmath
}}}

Das Paket unzip ist nach meinem Kenntnisstand Teil der Grundinstallation, hier also nicht unbedingt zusätzlich zu installieren.

Darüber hinaus bin ich immer unentschlossen, ob nun die explizite Version angegeben werden soll oder nicht. Wie läuft das bei einem dist-upgrade? Würde der dann erstmal keine Aktualisierungen vornehmen und ich muss diese Pakete von Hand nachziehen?

Eines der php7.2 Pakete in der Liste ist nicht notwendig. Ich frage mich allerdings, ob das vielleicht von früher ein phpx.y-mcrypt-Artefakt ist, wobei es Pakete dieser Art auch nicht mehr gibt. Nicht getestet habe ich, was passiert, wenn ich das Paket mcrypt nicht installiere.

Ein Mangel, den ich auch in der Snipe-IT-Dokumentation sehe: Es wird ein simples git clone ... verwendet, ohne später eine bestimmte Version auszuchecken oder wenigstens darauf hinzuweisen. Wenn man nach dem klonen des Repositories in selbiges wechselt, lässt sich mit

git log 

sehr schnell feststellen, dass wir bereits jetzt ein paar Commits von der letzten als stabil markierten (getaggten) Version entfernt sind. Es mag sein, dass deren Entwicklungsmodell so gestrickt ist, dass der master-Branch immer stabil ist. Allerdings weiß dann der Leser, der gemäß Anleitung installiert, gar nicht, dass er eben nicht die aktuellste stabile Version hat - oder ggf. der Helfer, der drei Commits vorher installiert hat.

Zusätzlich zur Installation ist es hier ggf. auch nochmal wichtig, die Aktualisierung von Snipe-IT via

git pull 

zu behandeln. Und was da sonst noch so mitkommen muss (Aktualisierung von Abhängigkeiten via Composer z.B.).

Im Bereich der Anleitung vielleicht etwas besser Herausstellen, dass der Haken zum Aktivieren/Deaktivieren von Benutzern im Dialog/Bildschirm zur Erstellung oder Bearbeitung eines Benutzerkontos zu finden ist. Ich habe eine gute Zeit nach einem Menü gesucht.

Ich finde es sehr gut, dass es auch ein Kapitel zum Deinstallieren gibt - da sollte ich in Zukunft auch mal dran denken. Nachdem während der Installation so viel Wert darauf gelegt wurde, die Standardseite von Apache zu deaktivieren (ggf. ist dort auch nochmal ein Hinweis sinnvoll, was man da überhaupt mit welchen Folgen tut), ist es hier im Gegenzug sinnvoll, diese wieder zu aktivieren - nachdem man im Datenverzeichnis aufgeräumt hat.

Zusätzlich zum Löschen der Datenbank ist es gewiss auch nicht schlecht, den Datenbankbenutzer zu entfernen, um wirklich alles aufgeräumt zu haben. 😉

Das war es erstmal an Anmerkungen. Wie eingangs erwähnt, funktioniert der Artikel als solches sowohl technisch (Snipe-IT läuft in der 18.04-VM) als auch von dem kleinen Anwendungsbeispiel her.

BillMaier Team-Icon

Supporter

Anmeldungsdatum:
4. Dezember 2008

Beiträge: 6389

Hallo Cranvil, danke für deinen Einsatz im Wiki!

Wir sollten zunächst unterscheiden, was in diesem Artikel relevant ist für eine Verschiebung ins Wiki. Optimieren geht immer, das können wir als Wikiteam ein Lied davon singen ☺

noisefloor hatte den Artikel ja als ok fürs Wiki genannt. Mein Vorschlag wäre, das zunächst abzuschließen (hier gibt es IMHO keinen Show-Stopper mehr) und dir den Artikel danach in eine separate Baustelle zur Optimierung zu schieben. Wäre das ok für dich?

Zu deinen Anmerkungen:

Die Anforderungen 🇬🇧 von Snipe-IT informieren uns, dass PHP mindestens in Version 7.1.2 vorliegen muss, was einen Test unter 16.04 mit den distributionseigenen Paketen mangels Herstellerunterstützung aus meiner Sicht unnötig macht. Dieser Zusammenhang sollte im Wiki erwähnt werden.

Das hab ich jetzt leider nicht verstanden. Könntest du das bitte nochmal in kürzeren Sätzen schreiben, was du damit meinst?

Eine Alternative hierzu wäre die Ergänzung des Artikels um eine Installation neuerer PHP-Versionen, z.B. aus Ondřej Surýs PPA. In diesem PPA werden die neuesten noch unterstützten Versionen von PHP für die neuesten noch unterstützten Versionen von Ubuntu bereitgestellt. Hier ist dann allerdings noch die obligatorische Fremdquellen-Warnung einzupflegen. Ich habe diese Möglichkeit nicht getestet, gehe jedoch davon aus, dass es genauso problemlos wie bei der 18.04er Version klappt. Vielleicht ergänze ich den Artikel dann später noch. ☺

Das gehört dann aber bitte in den Artikel PHP mit entsprechender Verlinkung hier.

Nach meinem Geschmack sollte die Paketliste tatsächlich eine Liste sein.

Du meinst zeilengetrennt statt Leerzeichen-getrennt im Quelltext ? Wäre sicher gut lesbar.

Das Paket unzip ist nach meinem Kenntnisstand Teil der Grundinstallation, hier also nicht unbedingt zusätzlich zu installieren.

Stört aber auch nicht, wenn es für das Programm wichtig ist. Sowas ist z.B. für die Installation in einem Container interessant (auch wenn wir das bisher im Wiki nicht berücksichtigen).

Darüber hinaus bin ich immer unentschlossen, ob nun die explizite Version angegeben werden soll oder nicht.

Das kommt ganz darauf an. Wenn ein Programm bzw. Wiki-Artikel für mehrere Ubuntu-Versionen getestet ist und man die Installationsanleitung über die Metapakte abfangen kann (also ohne die Versionsnummer) ist diese Variante IMO zu bevorzugen. Aktuell ist das ja nicht der Fall, von daher so i.O. Wie gesagt, optimieren geht immer ☺

Wie läuft das bei einem dist-upgrade? Würde der dann erstmal keine Aktualisierungen vornehmen und ich muss diese Pakete von Hand nachziehen?

Das kann ich aktuell nicht sagen.

Eines der php7.2 Pakete in der Liste ist nicht notwendig.

Welches?

Ich frage mich allerdings, ob das vielleicht von früher ein phpx.y-mcrypt-Artefakt ist, wobei es Pakete dieser Art auch nicht mehr gibt. Nicht getestet habe ich, was passiert, wenn ich das Paket mcrypt nicht installiere.

mcrypt ist IMO nach Pecl 🇬🇧 oder sowas gewandert.

Ein Mangel, den ich auch in der Snipe-IT-Dokumentation sehe: Es wird ein simples git clone ... verwendet, ohne später eine bestimmte Version auszuchecken oder wenigstens darauf hinzuweisen. Wenn man nach dem klonen des Repositories in selbiges wechselt, lässt sich mit

git log 

sehr schnell feststellen, dass wir bereits jetzt ein paar Commits von der letzten als stabil markierten (getaggten) Version entfernt sind. Es mag sein, dass deren Entwicklungsmodell so gestrickt ist, dass der master-Branch immer stabil ist. Allerdings weiß dann der Leser, der gemäß Anleitung installiert, gar nicht, dass er eben nicht die aktuellste stabile Version hat - oder ggf. der Helfer, der drei Commits vorher installiert hat.

Man könnte ja nach dem clone in den entsprechenden tag wechseln, wenn die stable-releases darüber abgebildet werden. Das könnte ich mir hier im Wiki als Ergänzung gut vorstellen.

Zusätzlich zur Installation ist es hier ggf. auch nochmal wichtig, die Aktualisierung von Snipe-IT via

git pull 

zu behandeln. Und was da sonst noch so mitkommen muss (Aktualisierung von Abhängigkeiten via Composer z.B.).

Hier wäre mein Anspruch, das möglichst kurz zu halten und dann auf die entsprechenden Abschnitte in Git und Composer verlinken. sobald es beide Artikel im Wiki gibt, sollten die wohl sowieso noch in die Wissensbox.

Im Bereich der Anleitung vielleicht etwas besser Herausstellen, dass der Haken zum Aktivieren/Deaktivieren von Benutzern im Dialog/Bildschirm zur Erstellung oder Bearbeitung eines Benutzerkontos zu finden ist. Ich habe eine gute Zeit nach einem Menü gesucht.

Darfst du dann gerne machen.

Ich finde es sehr gut, dass es auch ein Kapitel zum Deinstallieren gibt - da sollte ich in Zukunft auch mal dran denken. Nachdem während der Installation so viel Wert darauf gelegt wurde, die Standardseite von Apache zu deaktivieren (ggf. ist dort auch nochmal ein Hinweis sinnvoll, was man da überhaupt mit welchen Folgen tut), ist es hier im Gegenzug sinnvoll, diese wieder zu aktivieren - nachdem man im Datenverzeichnis aufgeräumt hat.

+1

Zusätzlich zum Löschen der Datenbank ist es gewiss auch nicht schlecht, den Datenbankbenutzer zu entfernen, um wirklich alles aufgeräumt zu haben. 😉

+1

Das war es erstmal an Anmerkungen. Wie eingangs erwähnt, funktioniert der Artikel als solches sowohl technisch (Snipe-IT läuft in der 18.04-VM) als auch von dem kleinen Anwendungsbeispiel her.

... und kann damit wohl ins Wiki, was ich jetzt gleich mache, da ihm sowieso schon der Baustellen-Hinweis geklaut wurde.

@Cranvil willst du dann den Artikel für eine Ergänzung gleich wieder in der Baustelle? Oder @krrhh wollt ihr euch da ggf. gar zusammen tun?

Viele Grüße

BillMaier

BillMaier Team-Icon

Supporter

Anmeldungsdatum:
4. Dezember 2008

Beiträge: 6389

Artikel ist im Wiki. Vielen Dank an krrhh fürs Erstellen! Ich habe eben noch die Verwendung genauer durchgelesen und konnte mir sehr gut vorstellen, wie die Software so tickt. Da hast du dir echt Mühe gegeben, das liest sich sehr gut.

Eine Kleinigkeit ist mir noch aufgefallen: Es tauchen hin und wieder englische Worte aus dem Programm auf. Insofern die auf deutsch verfügbar sind, sollten sie auch hier im Artikel so benannt sein.

Gibt es Ideen, wo wir den Artikel verlinken könnten, damit er auch gefunden wird? Dann bitte gerne machen. Wenn auf Übersichtsseiten die Berechtigungen dazu fehlen, bitte in der dortigen Diskussion zum Artikel kurz posten, dann übernimmt das jemand vom Wikiteam.

Viele Grüße

BillMaier

Cranvil

Anmeldungsdatum:
9. März 2019

Beiträge: 990

BillMaier schrieb:

noisefloor hatte den Artikel ja als ok fürs Wiki genannt. Mein Vorschlag wäre, das zunächst abzuschließen (hier gibt es IMHO keinen Show-Stopper mehr) und dir den Artikel danach in eine separate Baustelle zur Optimierung zu schieben. Wäre das ok für dich?

Deshalb war mir mein Schlusssatz auch so wichtig: Der Artikel funktioniert. ☺

Die Anforderungen 🇬🇧 von Snipe-IT informieren uns, dass PHP mindestens in Version 7.1.2 vorliegen muss, was einen Test unter 16.04 mit den distributionseigenen Paketen mangels Herstellerunterstützung aus meiner Sicht unnötig macht. Dieser Zusammenhang sollte im Wiki erwähnt werden.

Das hab ich jetzt leider nicht verstanden. Könntest du das bitte nochmal in kürzeren Sätzen schreiben, was du damit meinst?

16.04 bringt von Haus aus PHP 7.0.x mit und der Snipe-IT-Entwickler will mindestens Version 7.1.2. Wenn also nur die offiziellen Paketquellen Verwendung finden, kann Snipe-IT unter 16.04 nicht in Betrieb genommen werden. Außer die Applikation funktioniert doch noch mit der älteren Version.

Eine Alternative hierzu wäre die Ergänzung des Artikels um eine Installation neuerer PHP-Versionen, z.B. aus Ondřej Surýs PPA. In diesem PPA werden die neuesten noch unterstützten Versionen von PHP für die neuesten noch unterstützten Versionen von Ubuntu bereitgestellt. Hier ist dann allerdings noch die obligatorische Fremdquellen-Warnung einzupflegen. Ich habe diese Möglichkeit nicht getestet, gehe jedoch davon aus, dass es genauso problemlos wie bei der 18.04er Version klappt. Vielleicht ergänze ich den Artikel dann später noch. ☺

Das gehört dann aber bitte in den Artikel PHP mit entsprechender Verlinkung hier.

Stimmt wohl. Ich werde mir das in den nächsten Tagen nochmal ansehen und wenn ich soweit bin, melde ich mich. 😉

Eines der php7.2 Pakete in der Liste ist nicht notwendig.

Welches?

Ich habe mich missverständlich ausgedrückt: php7.2 taucht in der Liste doppelt auf. Entweder kann eine Nennung weg oder statt eines Leerzeichens sollte da mal ein Bindestrich hin.

Hier wäre mein Anspruch, das möglichst kurz zu halten und dann auf die entsprechenden Abschnitte in Git und Composer verlinken. sobald es beide Artikel im Wiki gibt, sollten die wohl sowieso noch in die Wissensbox.

Oder so. Die Anmerkung zielt hauptsächlich auf meine Annahme ab, dass jemand, der Ubuntu gewohnt ist, vielleicht nicht direkt daran denkt, dass er bei Updates für diese Art der Software-Installation selbst verantwortlich ist.

@Cranvil willst du dann den Artikel für eine Ergänzung gleich wieder in der Baustelle? Oder @krrhh wollt ihr euch da ggf. gar zusammen tun?

Ich warte erstmal, ob @krrhh den Artikel selbst ergänzen will.

krrhh

(Themenstarter)

Anmeldungsdatum:
1. Juli 2019

Beiträge: 6

Danke für das sehr ausführliche Feedback und die Veröffentlichung. ☺

Ich schaue mir den Artikel dieses Wochenende nochmal an und ergänze ihn entsprechend.

BillMaier Team-Icon

Supporter

Anmeldungsdatum:
4. Dezember 2008

Beiträge: 6389

Wenn du das nochmal in einer Baustelle machen willst, bitte kurz hier bemerkbar machen.

Gruß BillMaier

Beforge Team-Icon

Ehemalige

Anmeldungsdatum:
29. März 2018

Beiträge: 2007

Die Installation der Abhängigkeiten ist jetzt doppelt drinnen. Ich habe das jetzt aufgeräumt und korrigiert und dabei auch eine Liste draus gemacht. Ist im Wiki üblich und einfach deutlich besser zu lesen.

BillMaier Team-Icon

Supporter

Anmeldungsdatum:
4. Dezember 2008

Beiträge: 6389

Beforge schrieb:

Die Installation der Abhängigkeiten ist jetzt doppelt drinnen. Ich habe das jetzt aufgeräumt und korrigiert

Oh, danke, das hatte ich dann wohl übersehen.

krrhh

(Themenstarter)

Anmeldungsdatum:
1. Juli 2019

Beiträge: 6

Ich habe jetzt die Notwendigkeit von Ubuntu 18.04LTS aufgrund der PHP-Abhängigkeiten erwähnt. Info zum PPA bitte ich andere einzupflegen, die davon mehr wissen als ich.

Außerdem die Deinstallation um das Entfernen des MySQL-Users sowie das Reaktivieren der Apache-Defaultseite ergänzt und einen Satz zum Update geschrieben.

Antworten |