As an Appliance Administrator, you can use the Factory Reset feature to reset a Safeguard for Privileged Passwords Appliance to recover from major problems or to clear the data and configuration settings on the appliance.
Factory reset is not an option for virtual appliances. You will need to redeploy the appliance.
Caution: Care should be taken when performing a factory reset against a physical appliance, because this operation removes all data and audit history, returning it to its original state when it first came from the factory. Performing a factory reset will NOT reset the BMC/IPMI interface or the IP address. However, the BMC/IPMI interface will need to be reenabled after the reset has completed (for more information, see Lights Out Management (BMC)). The appliance must go through configuration again as if it had just come from the factory. For more information, see Setting up Safeguard for Privileged Passwords for the first time.
In addition, performing a factory reset may change the default SSL certificate and default SSH host key.
The appliance resets to the current Long Term Support (LTS) version. For example, if the appliance is running version 6.6 (feature release) or 6.0.6 LTS (maintenance Long Term Support release) and then factory reset, the appliance will reset down to 6.0 LTS and you will have to patch up to your desired version. For more information, see Long Term Support (LTS) and Feature Releases.
Factory reset on a clustered appliance
Performing a factory reset on a clustered hardware appliance will not automatically remove the appliance from a cluster. The recommended best practice is to unjoin an appliance from the cluster before performing a factory reset on the appliance. After the unjoin and factory reset, the appliance must be configured again. For more information, see Setting up Safeguard for Privileged Passwords for the first time.
To perform a factory reset from the web client
- Go to Factory Reset on hardware (not virtual machine):
- Navigate to Appliance Management > Appliance > Factory Reset.
- Click Factory Reset.
In the Factory Reset confirmation dialog, enter the words Factory Reset and click Factory Reset.
The appliance will go into Maintenance mode to revert the appliance. If the appliance was in a cluster, you may need to unjoin the factory reset appliance. The factory reset appliance must be configured again. For more information, see Setting up Safeguard for Privileged Passwords for the first time. In addition, when you log in to the appliance, you will be prompted to add your Safeguard for Privileged Passwords licenses.
You can also perform a factory reset from the Recovery Kiosk or Support Kiosk. For more information, see Performing a factory reset.
The Lights Out Management feature allows you to remotely manage the power state and serial console to Safeguard for Privileged Passwords using the baseboard management controller (BMC). When a LAN interface is configured, this allows the Appliance Administrator to power on an appliance remotely or to interact with the Recovery Kiosk.
The Appliance Administrator can enable and configure the Lights Out Management feature. When Lights Out Management is enabled, the Appliance Administrator can set or change the password and modify the network information for the baseboard management console (BMC). When disabled, Safeguard for Privileged Passwords immediately resets the password to a random value and resets the network settings to default values.
Lights Out Management is only available using hardware (not a virtual machine):
LAN interface required
This feature requires a LAN interface to be enabled and configured. Safeguard for Privileged Passwords's BMC supports the following LAN interfaces to provide this functionality:
- IPMI v2
- Serial over Lan
It is strongly recommended that the LAN interface only be enabled in trusted environments.
To enable Lights Out Management
A static IP address will need to be assigned and a network cable will need to be connected to the IPMI ethernet port on the back of the appliance. This is in addition to the standard X0 network interface.
- Navigate to Lights Out Management (BMC).
- Click the Enable Lights Out Management toggle to enable or disable this feature. Set toggle on or toggle off.
- Once enabled, enter the following information about the BMC:
- IP address: The IPv4 address of the host machine.
- Netmask: The network mask IPv4 address.
- Default Gateway: The default gateway IPv4 address.
Use Set BMC Admin Password to set the password for the host machine.
Maximum password length: 20 characters.
NOTE: If this feature was previously enabled, you will see an Update BMC Admin Password button instead. Optionally, click the Update BMC Admin Password button to reset the password for the host machine.
- Click OK to save the settings on the host machine.
Accessing the BMC
Once Lights Out Management is enabled in Safeguard for Privileged Passwords, you can access the BMC via:
- SSH to connect to the IPMI port to remotely manage the power state and serial console to Safeguard for Privileged Passwords
- Web browser
The SPP Kiosk Console can be accessed via Putty, Linux command line, or your preferred SSH Client.
- Connect to the IP assigned to the IPMI interface and login with the Admin user. (Default credentials are ADMIN/admin)
- At the prompt run: start /system1/sol1. There may be a delay. Please wait for the connection. A message like the following gives you the instructions to proceed:
->start / system1soll
press <Enter>, <Esc>, and then <T> to terminate session
(press the keys in sequence, one after the other)
- On the menu shown below, navigate using the arrow keys. Press the right arrow to select a menu option, press the left arrow to return to the menu list, press up or down to select a different menu option.
Appliance Information >
Power Options >
Admin Password Reset >
Factory Reset >
Support Bundle >
If the screen freezes, or displays distorted information, you can press CTRL+R or CTRL+D to refresh the screen.
To exit the Kiosk press Enter, then press ESC, then press SHIFT+T. At the prompt, type in exit.
If the appliance is in Quarantine, please generate a Quarantine Bundle from the Kiosk menu and copy the file to a network share. After the bundle is retrieved, perform a Reboot via the Kiosk, to see if the appliance will recover on its own. If it remains in Quarantine, a Factory Reset will likely be necessary. For more information, see Performing a factory reset.
Web browser interface
If you experience difficulty logging in through SSH, web access is also available.
- In your browser, go to the IP address of your IPMI interface. (that is, https://10.10.10.10), and login with your BMC admin account. The default is ADMIN/admin.
- You can attempt to fix the SSH connection, by navigating to Maintenance > Unit Reset > Select Reset. After 60 seconds re-attempt the SSH connection.
- Login to the Kiosk via the web by navigating to Remote Control > Select Launch SOL. (Java is required for this method, the Kiosk will launch in a JNLP window.)
- Use the cursor keys and return to navigate. Page Up is used for backspace. It is not possible to copy and paste when using the Java viewer.
A reboot from the BMC web browser interface is only a hardware level reboot.
If you need to reboot using the web browser interface:
- Log into the BMC web browser interface.
- Open the Serial over Lan emulator, which opens the Kiosk interface.
- Select reboot from the menu.
See KB 263835: How to remotely access the Kiosk via the Lights Out Management / BMC / IPMI interface.
Safeguard for Privileged Passwords makes these diagnostic tests available for the Appliance Administrator and Operations Administrator.
NOTE: When you run these diagnostic tests, they are run on the appliance.
- Go to Network Diagnostics:
- web client: Navigate to Appliance > Network Diagnostics.
- Choose the type of test to perform and complete the steps.
- ARP: Use Address Resolution Protocol (ARP) to discover the Interface, Internet Address, Physical Address, and Type (dynamic or static).
- Netstat: Use netstat to display the active connection protocol, local address, foreign address, and state.
- NS Lookup: To obtain your domain name or IP address.
- Ping: To verify your network connectivity and response time.
- Show Routes: To retrieve routing table information.
- Telnet: To access remote computers over TCP/IP networks like the internet.
- Throughput: Test throughput to other appliances in the cluster.
- Trace Route: To obtain your router information; trace route determines the paths packets take from one IP address to another.
Use Address Resolution Protocol (ARP) to discover the Interface, Internet Address, Physical Address, and Type (dynamic or static).
- Navigate to Appliance > Network Diagnostics.
- Click ARP.
- Click Display ARP Table to run the test. The test results display in the Output window and may include the Interface, Internet Address, Physical Address, and Type.