Renaming a ZFSSA nodename
This article provides a step-by-step guide on how to change the
nodename of a ZFS Storage Appliance.
nodename is separate from any DNS names that are used to connect to this storage appliance which you would change remotely on the DNS services directly.
Changing the nodename via CLI
sshto connect to the ZFS Storage Applicance
configurationto access the configuration context
serviceto access the service context
identityto access the identity context You can achieve the above on a single command
fishworks:> configuration service identity
showto see the available properties, for example:
fishworks:configuration services identity> show Properties: <status> = online nodename = fishworks syslocation =
- Use the
setkeyword for the
nodenameproperty to change the nodename and commit the changes, for example:
As you can see from the last line in the above example, changes in the CLI are immediate, however the logfiles will not show the new
fishworks:configuration services identity> set nodename="zfssa1" nodename = zfssa1 (uncommitted) fishworks:configuration services identity> commit zfssa1:configuration services identity>
nodenameuntil the appliance is restarted.
- You can issue another
showcommand to review the changes.
If you want a one-liner to perform the above via cli, you can type the following:
confirm configuration services identity set nodename="newname"
Changing the hostname via BUI
- Login to appliance [ https://(appliance.ip.address):215 ]
- Enter your
username(typically root) and the associated
- Under context 'Configuration' select
- Under context 'Services', scroll down to
System Settingsand select
- Enter your new
Changes in the BUI are immediate, however the logfiles will not show thw new
nodename until the appliance has been restarted.
One final thought ... You may want to consider de-activating ASR and re-activating after the changes, this will ensure that the support information held on the Oracle Support servers is correctly associated with the 'new' nodename.