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
• 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

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.
The token has the following format, for example: 49dd334bc63aea36383a8f4a96155fe8ca284923ea02c095d8d9a659c6b028f4

This token is generated in the TERRA Management System, assigned to a customer, and is valid for one year. Please note the token for installation and use it within this time.

Token management will be available soon.

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 you want to perform the installation without user interaction, you can do so via the command line. Use the following command:
".\TERRA Management Agent.exe" /silent /v" /quiet /norestart TCTOKEN=YOURTOKEN"

Replace YOURTOKEN with the actual token you received.

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

Explanation of the parameters:

• /silent - Runs the installation in the background.
  
• /v"/quiet" - Prevents the installation wizard from appearing.
  
• /v"/norestart" - Prevents the system from automatically rebooting.
  
• /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):
".\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

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

Log files

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