TERRA Management

General

TERRA Management is used to manage physical systems (servers, PCs, and notebooks) running Windows operating systems via a central dashboard.
Currently available features include:

• View hardware
• View warranty status
• View system certificate
• Access driver database
• Install driver updates
• Install firmware updates
• Download operating system ISOs
• Create and download log files from the motherboard and RAID controller
• Servereye integration (not yet available)

Requirements

• You need TERRA Cloud access.
• The Wortmann serial number (Rxxxxxxx) must be stored in the motherboard firmware.
• It must be a physical system, not a VM.
• The server must be able to access the manage.terracloud API via Test-NetConnection:
  Test-NetConnection api-manage.terracloud.de -Port 443

TERRA Cloud Access

You need a TERRA Cloud account to log in to the Technical Center.
If you don't have a TERRA Cloud account yet, you can create one here: https://terracloud.de/

Click on "New here? Register now."

Enter all relevant fields, including your Wortmann AG customer number.

Click on "Create account."
After a short processing time, your Cloud Center account will be activated. At the same time, your Technical Center account will be created.
You will receive an automatically generated email in which you must confirm the account creation.

Installation

Einleitung

Der Agent Client ist eine essenzielle Komponente unseres TERRA Management Systems und wird auf den Serversystemen installiert, um eine zentrale Verwaltung und Steuerung zu ermöglichen. Die Installation erfolgt mittels unseres Installers, der unter dem Menüpunkt "TERRA Management" im Technical Center zur Verfügung steht. Diese Anleitung beschreibt detailliert den Installationsprozess, sowohl manuell als auch automatisiert (Silent Installation).

Voraussetzungen

Bevor Sie mit der Installation beginnen, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

• Das Serversystem hat Zugriff auf das Technical Center.
• Sie verfügen über einen gültigen Token zur Registrierung des Servers.
• Administratorrechte sind für die Installation erforderlich.

Herunterladen des Installers

Der Installer kann direkt über das Technical Center bezogen werden. Folgen Sie diesen Schritten:

1. Melden Sie sich im Technical Center an.
2. Navigieren Sie zu TERRA Management -> TERRA Management Agent Herunterladen.
3. Laden Sie die aktuelle Version des Installers herunter.

Erhalt des Tokens

Der Installationsprozess erfordert einen Token zur Identifizierung und Zuweisung des Serversystems.
Der Token hat beispielsweise folgendes Format: 49dd334bc63aea36383a8f4a96155fe8ca284923ea02c095d8d9a659c6b028f4

Dieser Token wird im TERRA Management System generiert, einem Kunden zugewiesen und hat eine Gültigkeit von 15 Minuten. Notieren Sie sich den Token für die Installation und verwenden Sie ihn innerhalb dieser Zeit.

Manuelle Installation

Um den Installer manuell auszuführen, gehen Sie folgendermaßen vor:

1. Doppelklicken Sie auf die heruntergeladene setup.exe.
2. Folgen Sie den Anweisungen im Installationsassistenten.
3. Geben Sie den erhaltenen Token ein, wenn Sie dazu aufgefordert werden.
4. Klicken Sie auf Installieren und warten Sie, bis der Prozess abgeschlossen ist.
5. Nach Abschluss der Installation ist kein Neustart des Systems erforderlich.

Silent Installation

Falls die Installation ohne Benutzerinteraktion durchgeführt werden soll, kann dies über die Kommandozeile erfolgen. Nutzen Sie dazu den folgenden Befehl:
".\TERRA Management Agent.exe“ /silent /v“/quiet /norestart TCTOKEN=YOURTOKEN"

Ersetzen Sie YOURTOKEN durch den tatsächlichen Token, den Sie erhalten haben.

Beispiel für eine vollständige Installation: ".\TERRA Management Agent.exe" /silent /v"/quiet /norestart TCTOKEN=35eca490b92fd93...

Erläuterung der Parameter:

• /silent - Führt die Installation im Hintergrund aus.
  
• /v"/quiet" - Verhindert die Anzeige des Installationsassistenten.
  
• /v"/norestart" - Verhindert einen automatischen Neustart des Systems.
  
• /v"TCTOKEN="YOURTOKEN"" – Übergibt den Token für die Serverzuweisung.

Überprüfung der Installation

Nach erfolgreicher Installation kann überprüft werden, ob der Agent Client korrekt registriert wurde:

1. Öffnen Sie die Kommandozeile und geben Sie folgenden Befehl ein: sc query "AgentService"
2. Falls der Dienst läuft, sollte eine Ausgabe mit STATE: RUNNING erscheinen.
3. Alternativ können Sie sich im Technical Center anmelden und das System in der Liste der registrierten Geräte überprüfen.

Fehlerbehebung

Falls Probleme bei der Installation auftreten, beachten Sie folgende Punkte:

• Installer startet nicht:
  
  • Stellen Sie sicher, dass der Installer mit Administratorrechten ausgeführt wird.
    
  • Prüfen Sie, ob der Token noch gültig ist und nicht abgelaufen ist.
    
• Fehler bei der Token-Verarbeitung:
  
  • Überprüfen Sie, ob der Token korrekt eingegeben wurde.
    
  • Prüfen Sie, ob der Token noch gültig ist und nicht abgelaufen ist.
    
• Agent Client wird nicht registriert:
  
  • Stellen Sie sicher, dass das System eine Internetverbindung hat.
    
  • Prüfen Sie, ob Firewalleinstellungen die Kommunikation blockieren.
    

Support

Falls weitere Fragen zur Installation oder Nutzung des Agent Clients auftreten, wenden Sie sich bitte an den Serversupport der WORTMANN AG: support@terracloud.de oder +49 5744 944 392.

Deinstallation

Falls der Agent Client entfernt werden muss, kann dies über die Systemsteuerung oder über die Kommandozeile erfolgen:

Manuelle Deinstallation:
1. Öffnen Sie die Systemsteuerung.
2. Navigieren Sie zu Programme und Funktionen.
3. Suchen Sie nach TERRA Management Agent und klicken Sie auf Deinstallieren.

Silent Deinstallation (automatisiert):
".\TERRA Management Agent.exe" /x /v"/quiet /norestart"

Filter

A filter consists of three components: a column, an operator, and a value.

Multiple filters are also possible simultaneously.

TERRA Management

Overview / Add System

The overview shows all currently added systems with information about the name, working name, status, serial number, type, and agent version.
Additionally, the agent for new servers can be downloaded and the token for the initial agent registration can be generated on this page.

Details

In the detail view, you can see more detailed information about the currently selected system.
In addition to the information in the overview, you can also see data such as the service period or the service description.

Driver

In the driver view, you can centrally update various system drivers, such as chipset or VGA drivers.

Firmware

In the firmware view, you can update the motherboard firmware for selected server models.
To do this, you must enter the remote management credentials in the detailed view.

Operating systems

You can download selected operating system ISOs on the operating system tab.
Currently, Server 2019, 2022, 2025, VMware ESXi 7.0, and Windows 11 are available there.

Troubleshooting

You can create log files from the server using the Troubleshooting tab.
Mainboard and RAID controller log files are supported.

Servereye

Activation/Installation

This feature is not yet available, but will be available soon. To activate the Servereye component of TERRA Management, you must first link your Servereye account. Click on "Reseller Management"

Click on "Edit"

Create an account using your credentials or create a new customer.

After clicking Save, Servereye should now have a green check mark.

Now you can return to the Servereye section of your system and click Install Agent there.

General

This feature is not yet available, but will be available in the near future. '

Servereye functions as a versatile IT monitoring solution that maximizes the ease of monitoring and maintaining entrusted IT systems while ensuring optimal security. The intelligent remote monitoring and management platform automates many routine tasks and enables you to take immediate action and quickly resolve problems in the event of server outages.

By clicking on the individual agents, you can view the detailed view of each agent.

Troubleshooting

If you experience problems during registration or installation, please check the following points:

Check programs

Check under Programs and Features whether the following programs are still installed:

• TERRA Management
• Server Manager

→ If present, uninstall these programs

Check services

Check if the following services are running:

• Terra Management Service
• Terra Management Agent Updater Service
• ServerManager Service

→ If the ServerManager Service is running, stop this service

Check Registry

Check whether the TC token is entered in the registry:
Path:
HKEY_LOCAL_MACHINE\SOFTWARE\WortmannAG\Terra Management\Agent\TC Token

Log files

The log files can be found at the following path:
Path:
C:\Program Files (x86)\WortmannAG\TERRAManagementAgent