TERRA Management/en

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 information
• View warranty status
• View system certificate
• Retrieve driver database
• Install driver updates
• Download operating system ISOs
• Create remote backups
• Create and download log files from the motherboard and RAID controller
  
• Servereye integration

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

Introduction

The Agent Client is an essential component of our TERRA Management System and is installed on the server systems to enable centralized administration and control. Installation is performed using our installer, which is available under the "TERRA Management" menu item in the Technical Center. This guide describes the installation process in detail, both manually and automatically (silent installation).

Requirements

Before you begin the installation, ensure that the following requirements are met:

• The server system has access to the Technical Center.
• You have a valid token to register the server.
• Administrator rights are required for installation.

Download the installer

The installer can be obtained directly from the Technical Center. Follow these steps:

1. Log in to the Technical Center.
2. Navigate to TERRA Management -> Download TERRA Management Agent.
3. Download the latest version of the installer.

Receiving the token

The installation process requires a token to identify and assign the server system.
For example, the token has the following format: 49dd334bc63aea36383a8f4a96155fe8ca284923ea02c095d8d9a659c6b028f4

This token is generated in the TERRA Management System, assigned to a customer, and is valid for one year. Make a note of the token for the installation and use it within this timeframe.
Vorlage:Note

Manual Installation

To run the installer manually, follow these steps:

1. Double-click the downloaded setup.exe file.
2. Follow the instructions in the installation wizard.
3. Enter the received token when prompted.
4. Click Install and wait for the process to complete.
5. After the installation is complete, no system reboot is required.

Silent Installation

If the installation is to be performed without user interaction, this can be done via the command line. Use the following command:
"[DownloadPath]\TERRA Management Agent.exe" /silent /v" /quiet /norestart TCTOKEN="YOURTOKEN""

Replace YOURTOKEN with the actual token you received.

Example of a complete installation: "C:\Users\Admin\TERRA Management Agent.exe" /silent /v" /quiet /norestart TCTOKEN="35eca490b92fd93...""

Vorlage:Note Explanation of parameters:

• /silent - Runs the installation in the background.
  
• /v" /quiet" - Prevents the installation wizard from appearing.
  
• /v" /norestart" - Prevents the system from restarting automatically.
  
• /v" TCTOKEN="YOURTOKEN"" – Passes the token for server assignment.

Verifying the installation

After successful installation, you can check whether the Agent Client has been registered correctly:

1. Open the command line and enter the following command: sc query "AgentService"
2. If the service is running, an output with STATE: RUNNING should appear.
3. Alternatively, you can log in to the Technical Center and check the system in the list of registered devices.

Troubleshooting

If you experience problems during installation, please note the following:

• Installer does not start:
  
  • Ensure the installer is running with administrator privileges.
    
  • Check that the token is still valid and has not expired.
    
• Error processing token:
  
  • Check that the token was entered correctly.
    
  • Check that the token is still valid and has not expired.
    
• Agent Client is not registered:
  
  • Ensure the system has an internet connection.
    
  • Check if firewall settings are blocking communication.
    

Support

If you have any further questions regarding the installation or use of the Agent Client, please contact WORTMANN AG's server support team: support@terracloud.de or +49 5744 944 392.

Deinstallation

If the agent client needs to be removed, this can be done via the Control Panel or the command line:

Manual uninstallation:
1. Open the Control Panel.
2. Navigate to Programs and Features.
3. Search for TERRA Management Agent and click Uninstall.

Silent uninstallation (automated):
"[Download path]\TERRA Management Agent.exe" /x /v"/quiet /norestart"

Update

If the agent client needs to be updated, this can be done using the current installer or via the command line:

Manual update:
1. Download the current installer from the Technical Center.
2. Open the new agent installer.
3. Run the installer just as you would for the initial installation.

Silent update (automated):
"[Download path of the new agent]\TERRA Management Agent.exe" /silent /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.

Operating systems

On the Operating Systems tab, you can download selected operating system ISOs. Vorlage:Note

TERRA Backup

In the TERRA Management hardware overview, you can find the current system backup status under "TERRA Backup".


To create a system backup via the Technical Center, navigate to the desired system and open the "TERRA Backup" tab.
An existing backup account is required for this process.
Enter your backup account credentials and a new backup job password, then click "Provision backup".
The backup agent will then be automatically installed on your system, and your system will be registered with us.

Attention

Please make a note of the job password, as it will be required later.

Troubleshooting

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

Servereye

Activation/Installation

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

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

Check connection to the Technical Center

Please check the connection to the Technical Center via PowerShell using the following command:
Test-NetConnection api-manage.terracloud.de -Port 443

Check serial number in BIOS

You can check whether a serial number is stored in the BIOS using the command wmic bios get serialnumber.
If you are using Windows 11 or Windows Server 2025, the following command must be executed via PowerShell:
powershell -command "Get-CimInstance Win32_BIOS | Select-Object SerialNumber"

If no serial number is stored, it can be entered using the Serial Number Editor.
You can find this tool at https://www.wortmann.de/treiber. Search for your TERRA device's serial number there.

Log files

You can find the registration data in RegistrationData.txt at the following path:
[Installation path]\WortmannAG\TERRAManagementAgent

You can find the log files at the following path:
[Installation path]\WortmannAG\TERRAManagementAgent\logs