Übung 5 (optional): Einen eigenen ServiceManager für NOROOT4U vorbereiten ⚙️🚀

In dieser optionalen Übung machst du deinen Agenten NOROOT4U bootfest und bereit für einen produktionsnahen Betrieb. Dafür richtest du unter /opt/Automic/ADX02 einen eigenen ServiceManager ein, der auf Port 8872 läuft und den Agenten NOROOT4U aus /opt/Automic/ADX02/Agents/noroot4u verwaltet.

🧭 Ziel der Übung

• Du klonst den bestehenden ServiceManager nach /opt/Automic/ADX02/ServiceManager
• Du änderst den ServiceManager-Port von 8871 auf 8872
• Du erzeugst passende Einträge in uc4.smd und uc4.smc für die neue Instanz
• Du bereitest damit den späteren Start von NOROOT4U über einen eigenen ServiceManager vor

🧪 Schritt-für-Schritt-Anleitung

1. ServiceManager klonen
   • Kopiere zuerst den bestehenden ServiceManager und leere das temporäre Verzeichnis der Kopie:

cp -a /opt/Automic/Automation.Platform/ServiceManager /opt/Automic/ADX02/ServiceManager
find /opt/Automic/ADX02/ServiceManager/temp -mindepth 1 -delete

• Öffne danach die ServiceManager-Konfiguration:

gedit /opt/Automic/ADX02/ServiceManager/bin/ucybsmgr.ini

• Ändere in ucybsmgr.ini diese Werte, damit der kopierte ServiceManager eine eigene Destination und einen eigenen Port verwendet:

[Destination noroot4u]
port=8872
deffile=uc4.smd
cmdfile=uc4.smc

• Falls in deinem kopierten Abschnitt noch weitere Verweise auf 8871 stehen, ändere sie für diese neue Instanz ebenfalls auf 8872.
• Lege anschließend die Definitionsdatei für den Agenten an:

gedit /opt/Automic/ADX02/ServiceManager/bin/uc4.smd

• Trage in uc4.smd diese Zeile ein und speichere die Datei:

DEFINE NOROOT4U;*OWN/../../Agents/noroot4u/bin/ucxjlx6 -svc%port%;*OWN/../../Agents/noroot4u/bin/

• Lege danach die Kommandodatei für den Start an:

gedit /opt/Automic/ADX02/ServiceManager/bin/uc4.smc

• Trage in uc4.smc diese Zeilen ein und speichere die Datei:

WAIT 1
CREATE NOROOT4U

2. Ergebnis prüfen
   • Prüfe, ob die Konfiguration wie erwartet geschrieben wurde:

grep -n '8872\|NOROOT4U' /opt/Automic/ADX02/ServiceManager/bin/uc4.smd /opt/Automic/ADX02/ServiceManager/bin/uc4.smc
grep -n 'Destination noroot4u\|deffile=\|cmdfile=' /opt/Automic/ADX02/ServiceManager/bin/ucybsmgr.ini

3. ServiceManager starten
   • Starte den neuen ServiceManager zuerst manuell, um die Konfiguration zu verifizieren:

cd /opt/Automic/ADX02/ServiceManager/bin
./ucybsmgr noroot4u

4. Agent in Automic prüfen
   • Wechsle in Automic in die Administration Perspective
   • Prüfe, ob der Agent NOROOT4U dort wieder als aktiv sichtbar ist
5. Foreground-Prozess beenden
   • Wenn der Agent wieder als aktiv sichtbar ist, beende den laufenden ServiceManager-Prozess mit Ctrl + C
6. Systemd-Service-Datei anlegen
   • Für diesen Schritt brauchst du sudo, weil die Service-Datei unter /etc/systemd/system angelegt wird
   • Öffne die neue Service-Datei mit einem grafischen Editor aus der Kommandozeile:

sudo gedit /etc/systemd/system/automic-noroot4u.service

• Füge in die Datei diesen Inhalt ein und speichere sie:

[Unit]
Before=multi-user.target
Before=graphical.target
After=network-online.target
After=remote-fs.target
Wants=network-online.target
[Service]
Type=forking
Restart=no
TimeoutSec=5min
IgnoreSIGPIPE=no
KillMode=process
GuessMainPID=no
RemainAfterExit=yes
SuccessExitStatus=5 6
ExecStart=/opt/Automic/ADX02/ServiceManager/bin/automicsm start
ExecStop=/opt/Automic/ADX02/ServiceManager/bin/automicsm stop
User=automic
[Install]
WantedBy=multi-user.target

• Tipp: Die Zeile User=automic steuert, unter welchem OS-User der ServiceManager und damit auch der Agent gestartet werden

7. Systemd-Service aktivieren
   • Auch diese Kommandos führst du mit sudo aus:

sudo systemctl daemon-reload
sudo systemctl enable automic-noroot4u.service
sudo systemctl start automic-noroot4u.service
sudo systemctl status automic-noroot4u.service

8. Ergebnis festhalten
   • Halte für dich fest: Unter /opt/Automic/ADX02 gibt es jetzt einen eigenen ServiceManager für NOROOT4U, der für den späteren Betrieb als systemd-Service vorbereitet ist

🧩 Zusammenfassung

• Der zusätzliche ServiceManager liegt unter /opt/Automic/ADX02/ServiceManager
• Die neue Instanz verwendet Port 8872 statt 8871
• uc4.smd, uc4.smc und ucybsmgr.ini enthalten die vorbereiteten Einträge für den späteren Betrieb von NOROOT4U
• Der neue ServiceManager lässt sich mit ./ucybsmgr noroot4u testen und danach als eigener systemd-Service betreiben