# System Information

The Server Administration module for WHM API 1.

## Return server's drive partition information

 - [GET /getdiskusage](https://api.docs.cpanel.net/specifications/whm.openapi/system-information/getdiskusage.md): This function retrieves the server's drive partition information.

## Return server's hostname

 - [GET /gethostname](https://api.docs.cpanel.net/specifications/whm.openapi/system-information/gethostname.md): This function retrieves the server's hostname.

## Restart server

 - [GET /reboot](https://api.docs.cpanel.net/specifications/whm.openapi/system-information/reboot.md): This function reboots the server.

## Update server's primary virtual host

 - [GET /set_primary_servername](https://api.docs.cpanel.net/specifications/whm.openapi/system-information/set_primary_servername.md): This function sets the primary domain hosted on an IP address and web server port. The primary domain refers to the virtual host that the server returns when a visitor directly accesses the IP address.

For example, if both  and  are name-based virtual hosts on IP address , the primary virtual host appears when the visitor accesses the  location.



When you disable the Web Server role, the system  this function.

## Update server's hostname

 - [GET /sethostname](https://api.docs.cpanel.net/specifications/whm.openapi/system-information/sethostname.md): This function changes the server's hostname.



* Do  select a hostname that begins with  or a number, or a
hostname that ends with a hyphen () character.
* You  use a fully-qualified domain name (FQDN) that contains two periods
(for example, ).
* Do  choose a hostname that a cPanel account on your server will use.
* Do  choose a potential service subdomain (proxy subdomain) as a hostname
(for example,  or ).



If you update your hostname, the system blocks user access to cPanel's  interface ().

The system restores access to this interface after the hostname update finishes.
For more information, read our
Interface Lock Scripts
documentation.



Whenever you change the server's hostname, you  use one of the following methods:
  * Use WHM's
  
  interface ().
  * Call WHM API 1's  function.
  * Run the
   utility
  as the  user.
These methods ensure that all of the necessary system and service changes occur.

## Return whether system needs reboot

 - [GET /system_needs_reboot](https://api.docs.cpanel.net/specifications/whm.openapi/system-information/system_needs_reboot.md): This function determines if your system requires a reboot to apply quotas, software package updates, or kernel updates.



This function  detect whether your system needs a reboot if you use cPanel & WHM inside of a Linux Container (LXC).

## Return system load average

 - [GET /systemloadavg](https://api.docs.cpanel.net/specifications/whm.openapi/system-information/systemloadavg.md): This function retrieves the system's load average.



The values the function returns represent a percentage of the CPU's processor capacity.