netcup Help Center

https://www.netcup.com/en/helpcenter
Admin
netcup Help Center is a comprehensive documentation resource providing guides and information for...
Tokens:81,537
Snippets:1,624
Trust Score:10
Update:3 months ago
Show doc for...
Tokens:
Raw
### Start GDISK and List Partitions

Source: https://www.netcup.com/en/helpcenter/documentation/server/partitioning-kvm-server

Initiates the GDISK utility for partition management and displays the current partition table. Confirm all GDISK entries with ENTER.

```bash
gdisk /dev/Xda
```

```text
Disk /dev/Xda: 245366784 sectors, 117.0 GiB 
Logical sector size: 512 bytes 
Disk identifier (GUID): 2AE9B363-C537-4A7A-814E-E2ADBB5FA4BC 
Partition table holds up to 128 entries 
First usable sector is 34, last usable sector is 245366750 
Partitions will be aligned on 2-sector boundaries 
Total free space is 83 sectors (41.5 KiB) 

Number 	Start (sector) 		End (sector) 	Size 		 Code 	Name
  	1 				34 			 19531 	 9.5 MiB 	 EF02 	primary
  	2 			19584 			 8006783 	 3.8 GiB 	 8200 	primary
  	3 			8006784 			19530879 	 5.5 GiB 	 8300 	primary
  	4 			19530880 			245366719 	 107.7 GiB 	 0700 	primary
```

--------------------------------

### Install Client for NFS on Windows

Source: https://www.netcup.com/en/helpcenter/documentation/server/storagespace

Install the 'Client for NFS' feature on Windows Server through the Server Manager. This enables the Windows system to interact with NFS storage.

```powershell
Add Roles and Features
```

--------------------------------

### Modify Partition Table with FDISK

Source: https://www.netcup.com/en/helpcenter/documentation/server/partitioning-kvm-server

Interactive session to modify the partition table using `fdisk`. This example demonstrates changing display units to sectors, ensuring DOS compatibility is off, deleting partition 0, and creating a new primary partition 0 with default start and end sectors.

```bash
root@v123:~# fdisk /dev/Xda

WARNING: DOS-compatible mode is deprecated. It's strongly recommended to
 switch off the mode (command 'c') and change display units to
 sectors (command 'u').

Command (m for help): u
Changing display/entry units to sectors

Command (m for help): c
DOS Compatibility flag is not set

Command (m for help): d
Partition number (1-4): 0

Command (m for help): n
Command action
 e extended
 p primary partition (1-4)
p
Partition number (1-4): 0
First sector (526336-490733567, default 526336): 
Using default value 526336
Last sector, +sectors or +size{K,M,G} (526336-490733567, default 490733567): 
Using default value 490733567

Command (m for help): w
The partition table has been altered!

Calling ioctl() to re-read partition table.
Syncing disks.

```

--------------------------------

### Create Mount Point on Linux

Source: https://www.netcup.com/en/helpcenter/documentation/server/storagespace

Create a directory that will serve as the mount point for your storage space on a Linux system. This directory must exist before you can mount the storage.

```bash
mkdir /mnt/storagespace
```

--------------------------------

### Install nfs-common on Linux

Source: https://www.netcup.com/en/helpcenter/documentation/server/storagespace

Install the nfs-common package to enable access to NFS storages on Linux systems. This is a prerequisite for mounting NFS storage spaces.

```bash
apt-get install nfs-common
```

--------------------------------

### Configure Network Interface in Rescue System

Source: https://www.netcup.com/en/helpcenter/documentation/server/rescue-system

Execute this command to initiate network interface configuration within the rescue system. Follow the prompts to set up the interface, including VLAN and auto-enable settings.

```bash
grml-network
```

--------------------------------

### List All Hard Disks and Partitions

Source: https://www.netcup.com/en/helpcenter/documentation/server/filesystem-errors

Use this command to identify all available hard disks and their partitions on the system. This is a preliminary step before running fsck.

```bash
lsblk
```

--------------------------------

### Decompress Snapshot

Source: https://www.netcup.com/en/helpcenter/documentation/server/media

Use this command to decompress a downloaded snapshot file. Ensure you have zstd installed.

```bash
zstd -d snapshot.raw.zst -o snapshot.raw
```

--------------------------------

### Configure Permanent Mount in /etc/fstab on Linux

Source: https://www.netcup.com/en/helpcenter/documentation/server/storagespace

Add an entry to the /etc/fstab file to automatically mount the storage space on system startup. Ensure to replace placeholders with your actual IP address and storage path.

```bash
IP:/STORAGEPATH/mnt/storagespace nfs nolock,nfsvers=3,defaults 0 0
```

--------------------------------

### Server Images API

Source: https://www.netcup.com/en/helpcenter/documentation/servercontrolpanel/api

Endpoints for managing server images, including setup, listing available image flavors, and uploading user images.

```APIDOC
## POST /api/v1/servers/{serverId}/image

### Description
Setup an image for a server. Attention: All data will be lost during formatting on the selected disk!

### Method
POST

### Endpoint
/api/v1/servers/{serverId}/image

### Parameters
#### Path Parameters
- **serverId** (string) - Required - The ID of the server.

## GET /api/v1/servers/{serverId}/imageflavours

### Description
Get available image flavors for server image setup. Images whose storage driver is not supported by the server's machine type are not shown.

### Method
GET

### Endpoint
/api/v1/servers/{serverId}/imageflavours

### Parameters
#### Path Parameters
- **serverId** (string) - Required - The ID of the server.

## POST /api/v1/servers/{serverId}/user-image

### Description
Setup a user image for a server.

### Method
POST

### Endpoint
/api/v1/servers/{serverId}/user-image

### Parameters
#### Path Parameters
- **serverId** (string) - Required - The ID of the server.

## GET /api/v1/users/{userId}/images

### Description
Get all available user images.

### Method
GET

### Endpoint
/api/v1/users/{userId}/images

### Parameters
#### Path Parameters
- **userId** (string) - Required - The ID of the user.

## POST /api/v1/users/{userId}/images/{key}

### Description
Prepares an upload for an image.

### Method
POST

### Endpoint
/api/v1/users/{userId}/images/{key}

### Parameters
#### Path Parameters
- **userId** (string) - Required - The ID of the user.
- **key** (string) - Required - The key for the image.

## DELETE /api/v1/users/{userId}/images/{key}

### Description
Delete an image.

### Method
DELETE

### Endpoint
/api/v1/users/{userId}/images/{key}

### Parameters
#### Path Parameters
- **userId** (string) - Required - The ID of the user.
- **key** (string) - Required - The key for the image.

## GET /api/v1/users/{userId}/images/{key}

### Description
Get download information for an image.

### Method
GET

### Endpoint
/api/v1/users/{userId}/images/{key}

### Parameters
#### Path Parameters
- **userId** (string) - Required - The ID of the user.
- **key** (string) - Required - The key for the image.

## PUT /api/v1/users/{userId}/images/{key}/{uploadId}

### Description
Completes a multipart upload for an image.

### Method
PUT

### Endpoint
/api/v1/users/{userId}/images/{key}/{uploadId}

### Parameters
#### Path Parameters
- **userId** (string) - Required - The ID of the user.
- **key** (string) - Required - The key for the image.
- **uploadId** (string) - Required - The upload ID.

## GET /api/v1/users/{userId}/images/{key}/{uploadId}/parts/{partNumber}

### Description
Get a presigned upload URL for a single part of an image upload.

### Method
GET

### Endpoint
/api/v1/users/{userId}/images/{key}/{uploadId}/parts/{partNumber}

### Parameters
#### Path Parameters
- **userId** (string) - Required - The ID of the user.
- **key** (string) - Required - The key for the image.
- **uploadId** (string) - Required - The upload ID.
- **partNumber** (string) - Required - The part number.
```
Tokens:
Raw