Troubleshooting

Installing FlexMetal servers can be a straightforward process. This document seeks to provide valuable troubleshooting tips related to service setup, resource limitations, and resource availability, thereby enhancing your understanding and efficiency in managing these servers.

Error handling

Here are some common error messages you might encounter, along with guidance on how to resolve them.

• Requested instance type is not available in the selected location: When you receive this message, select a different location or instance type.

• Quota exceeded for selected location and instance type: This means that you have reached the limit of the amount of servers based on your contract. You can try to select a different location, or contact our support team to discuss about adjusting your quota.

• Failed to provision server: The installation of the Operating System encountered an issue, resulting in the cancellation of the server delivery. You can try to reorder the server. In the rare case that the problem continues, please reach out to our support team for assistance.

Server Request Error message examples

Here are some examples of potential errors you might encounter while submitting server requests using the API or working with Terraform are outlined below.

API

{
    "errorCode": 11001,
    "errorMessage": "Errors in form",
    "errors": [
        {
            "property": "location",
            "message": "invalid location"
        },
        {
            "property": "instanceType",
            "message": "invalid instanceType"
        }
    ]
}

Terraform

│ Error: Error creating server
│
│   with i3dnet_flexmetal_server.my-talos,
│   on main.tf line 15, in resource "i3dnet_flexmetal_server" "my-talos":
│   15: resource "i3dnet_flexmetal_server" "my-talos" {
│
│ Message: Invalid location
│ Message: Invalid instanceType

Server Delivery Error message examples

When a server delivery is pending but a failure is encountered, you can can identify this via the status and statusMessage fields in the server object.

When the status field displays failed, a more precise reason for failure is provided in the statusMessage field.

API

{
    "uuid": "f7b1b1b1-1b1b-1b1b-1b1b-1b1b1b1b1b1b",
    "name": "my-talos",
    "status": "failed",
    "statusMessage": "Failed to provision server",
    ...
}

Terraform

╷
│ Error: Server creation failed
│
│   with i3dnet_flexmetal_server.my-talos,
│   on main.tf line 15, in resource "i3dnet_flexmetal_server" "my-talos":
│   15: resource "i3dnet_flexmetal_server" "my-talos" {
│
│ Status message: Failed to provision server
╵