ADC

Resetting the default administrator password

August 20, 2024

Contributed by:

C C S

The administrator account provides complete access to all ADC features. Therefore, to preserve security, the administrator account must be used only if necessary and if you require full access to know the password for the nsroot account. It is recommended that you frequently change your password. If you lose the password, you must reset it to the default and then change it to a new one.

To reset your administrator password, you must log on to your appliance and change the password. However, if you do not remember the password, you can reboot the appliance in single user mode. Mount the file system in read/write mode and then remove the Citrix ADC entry from the ns.conf file. As a final step, reboot and log on to your appliance with the default password and set a new password.

To reset the administrator password

Connect a computer to the console port of the Citrix ADC and log on.

Note

You cannot log on by using SSH to perform this procedure; you must connect directly to the appliance.
Reboot the Citrix ADC.
Press CTRL+C when the following message appears:

Press [Ctrl-C] for command prompt, or any other key to boot immediately.

Booting [kernel] in # seconds.
Run the following command to start the Citrix ADC in a single user mode:

boot -s

Note

If boot -s does not work, then try reboot -- -s and appliance reboot in single user mode.

After the appliance boots, it displays the following message:

Enter full path name of shell or RETURN for /bin/sh:
Press the ENTER key to display the # prompt, and type the following commands to mount the file systems:
1. Run the following command to check the disk consistency:
  
  fsck_ufs /dev/ad0s1a
  
  Note
  
  Your flash drive has a specific device name depending on your Citrix ADC; hence, you have to replace ad0s1a in the preceding command with the appropriate device name.
2. You must access the dev directory and enter ‘ls’ to check the drive details.
3. Run the following command to display the mounted partitions:
  
  df
  
  If the flash partition is not listed, you must mount it manually.
4. Run the following command to mount the flash drive:
  
  mount/dev/ad0s1a /flash
Run the following command to change to the ns config directory:

cd/flash/nsconfig
Run the following commands to rewrite the ns.conf file and remove the set of system commands defaulting to the admin:
1. Run the following command to create a configuration file that does not have commands defaulting to the administrator:
  
  grep –v “set system user nsroot” ns.conf > new.conf
2. Run the following command to make a backup of the existing configuration file:
  
  mv ns.conf old.ns.conf
3. Run the following command to rename the new.conf file to ns.conf:
  
  mv new.conf ns.conf
Run the following command to reboot the Citrix ADC:

reboot
Log on using the default administrator credentials.
Run the following command to reset the administrator password:

set system user nsroot <New_Password>

Note

To use the “?” character in a password string, precede this character with the “\” character.

For example, yourexamplepasswd? is set for the administrator account after you perform the following operation:

> set system user nsroot yourexamplepasswd?

Note

For resetting a forgotten (nsroot) password in a high availability setup, Citrix recommends you to shut down the peer node. If the peer node is active, the password is overwritten, as the config sync is triggered when the node comes up after reboot.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Resetting the default administrator password

August 20, 2024

Contributed by:

C C S

August 20, 2024

Contributed by:

C C S

Resetting the default administrator password

To reset the administrator password

In this article