Issue:
- Want PowerChute Network Shutdown to trigger OS shutdown using a remote command.
- Want to test the PowerChute configuration to verify the OS shuts down correctly.
Product:
PowerChute Network Shutdown
Environment:
All supported Operating Systems
Cause:
Informational
Solution:
PowerChute Network Shutdown offers a REST API. The REST API is used to command the operating system to shut down without requiring APC UPS intervention.
On a Windows system, open a command prompt as an administrator, or on a Linux system, open a terminal window as root and enter the command:
curl --user PowerChute Username:PowerChute Password -k -X POST "https://PowerChute System Hostname or IP address:6547/REST/remoteShutdown?source=test&reason=shutdownTest&active=true"
Replace PowerChute username:PowerChute Password with the username and password assigned when PowerChute was installed. Also, replace the PowerChute System Hostname or IP address with the host's FQDN or system IP address.
Example: curl --user PCNStester:Schneider1234! -k -X POST "https://192.168.0.100:6547/REST/remoteShutdown?source=test&reason=shutdownTest&active=true"
NOTE 1: Starting with Windows 10 version 1803 or later, curl.exe is included. You may need to install curl on your Linux system.
NOTE 2: Running the API will simulate how PowerChute responds during a power event that requires an operating system shutdown. When executed, the API will initiate the OS shutdown.
NOTE 3: If PowerChute is configured to send a shutdown signal to the UPS or outlet group, the command will be sent, causing the UPS or outlet group to power off after the set delay.