Oracle ZFS Storage Appliance: How to Change/Rename the Hostname on a ZFS Storage Appliance

Asset ID:	1-71-1546342.1
Update Date:	2018-04-27
Keywords:

Solution Type Technical Instruction Sure

Solution 1546342.1 : Oracle ZFS Storage Appliance: How to Change/Rename the Hostname on a ZFS Storage Appliance

Applies to:

Oracle ZFS Storage ZS3-2 - Version All Versions and later
Sun Storage 7210 Unified Storage System - Version All Versions and later
Sun ZFS Storage 7120 - Version All Versions and later
Sun Storage 7310 Unified Storage System - Version All Versions and later
Oracle ZFS Storage ZS5-2 - Version All Versions and later
7000 Appliance OS (Fishworks)

Goal

To discuss this information further with Oracle experts and industry peers, we encourage you to review, join or start a discussion in the My Oracle Support Community - Disk Storage ZFS Storage Appliance

Step By Step Instructions on how to change the Hostname on a ZFS Storage Appliance

Solution

Note: Definition of 'System Name':

A single canonical identifying name for the appliance that is shown in the user interface.

This name is separate from any DNS names that are used to connect to the system (which would be configured on remote DNS servers).

This name can be changed at any time

Changing the Hostname using BUI

Login to appliance [ https://(appliance.ip.address):215 ]
Key in the User Name (root) / Password
Select Context 'Configuration'
Under context 'Configuration' select context 'Service'
Under context 'Service' select Context 'System Identity'
Key in the desired host-name
Hit the 'Apply' Tab

Changing The Hostname Using CLI

SSH to the appliance kit ApplianceKit-a-node3:>

ApplianceKit-a-node3: > configuration                            # Type configuration to get-into configuration context
ApplianceKit-a-node3: configuration> service                     # Type service to get into Service Context
ApplianceKit-a-node3: configuration services> identity           # Type identity to get into Identity context

ApplianceKit-a-node3: configuration services identity> show      # Type show to see the available properties.
       Properties:
                      <status>:= online
                       nodename = ApplianceKit-a-node3
                       syslocation = test

ApplianceKit-a-node3:configuration services identity> set nodename=ApplianceKit-a-node1
ApplianceKit-a-node1 ((uncommitted)) commit

ApplianceKit-a-node1:configuration services identity> show

Properties:
                    <status>:= online
                    nodename = ApplianceKit-a-node1
                    syslocation = test

ApplianceKit-a-node1:configuration services identity>

NOTE: When the Storage Administrator changes the hostname, it is recommended that ASR is de-activated and then re-activated.
This will ensure that the support information held on the Oracle Support servers is correctly associated with the 'new' hostname.

NOTE: Changes in the hostname are immediate in the BUI and CLI.
However, internal log files in /var/ak/logs will continue showing the 'old' hostname until the next reboot.

Attachments

This solution has no attachment