# Setting the hostname of a system controller

<main id="bkmrk-the-hostnamectl-tool" role="main"><article aria-labelledby="ariaid-title1" role="article">The hostnamectl tool is provided for administering the three classes of hostnames that can be used on a system controller or license server running RHEL 7.

<div><section class="section">### **Scope**

<div class="p"><dl><dt class="dlterm">***RHEL 7***</dt><dd>The following tips are applicable for RHEL 7. For more information about configuring host names, refer to the Red Hat documentation: [https://access.redhat.com/documentation/en-us/red\_hat\_enterprise\_linux/7/html/networking\_guide/ch-configure\_host\_names](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/networking_guide/ch-configure_host_names).</dd><dt class="dlterm"> ***RHEL 9***</dt><dd>For information about changing hostnames on RHEL 9 using the **<span class="keyword">nmcli</span>** or **<span class="keyword">nmtui</span>** tools, refer to the Red Hat documentation: [https://access.redhat.com/documentation/en-us/red\_hat\_enterprise\_linux/9/html/configuring\_and\_managing\_networking/assembly\_changing-a-hostname\_configuring-and-managing-networking#proc\_changing-a-hostname-using-nmcli\_assembly\_changing-a-hostname](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/configuring_and_managing_networking/assembly_changing-a-hostname_configuring-and-managing-networking#proc_changing-a-hostname-using-nmcli_assembly_changing-a-hostname)

</dd></dl></div></section><section class="section">### **View all hostnames**

To view all the current hostnames, enter the command:

<kbd class="userinput"><span class="keyword">`<kbd class="userinput">hostnamectl status </kbd>`</span></kbd>

The <kbd class="userinput"><span class="keyword">`<kbd class="userinput">status</kbd>` </span></kbd>option is implied by default if no option is given.

</section><section class="section">### **Set all hostnames**

To set all the hostnames on a system, as root, enter the command:

<var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput">hostname<kbd class="userinput">ctl set-hostname</kbd> name </kbd>`</span></kbd></var>

This command changes the pretty, static, and transient hostnames to the name specified in *<var class="varname">name</var>*. The static and transient hostnames are simplified forms of the pretty hostname. Spaces are replaced with "-" and special characters are removed.

</section><section class="section">### **Set a particular hostname**

To set a particular hostname, as root, enter the command with the relevant option:

<var class="varname"> <kbd class="userinput"><span class="keyword">`<kbd class="userinput">hostname<kbd class="userinput">ctl set-hostname</kbd> name [option...] </kbd>`</span></kbd></var>

Where <var class="varname">option</var> is one or more of: <var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput">--pretty</kbd></kbd>`</span></kbd></var>, <var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput">--static</kbd></kbd>`</span></kbd></var>, and <var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput">--transient</kbd></kbd>`</span></kbd></var>.

If either the <var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput">--static</kbd></kbd>`</span></kbd></var> or <var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput">--transient</kbd></kbd>`</span></kbd></var> options are used with the <var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput">--pretty</kbd></kbd>`</span></kbd></var> option, the static and transient hostnames are simplified forms of the pretty hostname. Spaces are replaced with "<kbd class="userinput">-</kbd>" and special characters are removed. If the <var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput">--pretty</kbd></kbd>`</span></kbd></var> option is not specivied, no simplification takes place.

If the pretty hostname to be set contains spaces or a single quotation mark, use quotation marks around the <var class="varname">name</var> entry. For example:

<kbd class="userinput"><var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput">hostname<kbd class="userinput">ctl set-hostname "Advantest's SmarTest 8.2 system controller" <kbd class="userinput"><kbd class="userinput"><kbd class="userinput">--pretty</kbd></kbd></kbd></kbd></kbd>`</span></kbd></var> </kbd>

</section><section class="section">### **Check a hostname**

To check if the hostname is set correctly as a fully qualified domain name, as root, enter the command:

<kbd class="userinput"><var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput">hostname -f</kbd>`</span></kbd></var></kbd>

An example of a correct response is: `server123.mycompany.com`

Incorrect response example: `localhost.localdomain`

</section><section class="section">### **Clear a particular hostname**

To clear a particular hostname and revert to the default, as root, enter the command with the relevant option:

<var class="varname"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput">hostname<kbd class="userinput">ctl <kbd class="userinput">set-hostname ""</kbd> [option...] </kbd></kbd>`</span></kbd></kbd></var>

Where:

<var class="varname"><kbd class="userinput"><kbd class="userinput"><span class="keyword">`<kbd class="userinput">""</kbd>`</span></kbd></kbd></var> is a quoted empty string.

<var class="varname">option...</var> is one or more of: <var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput">--pretty</kbd></kbd>`</span></kbd></var>, <var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput">--static</kbd></kbd>`</span></kbd></var>, and <var class="varname"><kbd class="userinput"><span class="keyword">`<kbd class="userinput"><kbd class="userinput">--transient</kbd></kbd>`</span></kbd></var>.

</section></div></article></main><footer id="bkmrk-" role="contentinfo"><div class="fo"><div class="-share"><div class="-sharem">  
</div><div class="-shared" style="display: none;">  
</div></div></div></footer>