Powershield Troubleshooting Communications Software
“
Product Information
Specifications:
- Product Name: POWERSHIELD
- Model: TROUBLESHOOT_rev00
- Compatibility: Works with Hyper-V management
- Email Configuration: Supports SMTP settings with Gmail
Product Usage Instructions:
1. Secure Connection Setup:
To enable a secure connection, follow these steps:
- [Step 1 details]
- [Step 2 details]
2. SMTP Settings with Gmail:
To configure SMTP settings with Gmail:
- [Step 1 details]
- [Step 2 details]
3. Hyper-V Management:
To configure Hyper-V management:
- [Step 1 details]
- [Step 2 details]
- [Step 3 details]
FAQ (Frequently Asked Questions):
1. When should I enable the secure connection?
[Answer to when to enable secure connection]2. What are the SMTP settings with gmail?
[Answer to SMTP settings with Gmail]3. Is POWERSHIELD compatible with Hyper-V management?
[Answer regarding compatibility with Hyper-V management]“`
POWERSHIELD TROUBLESHOOTING
GUIDE
POWERSHIELD_TROUBLESHOOT_rev00
CONTENTS
1. When should I enable the secure connection? _____________________________3 2. What are the SMTP settings with gmail? __________________________________3 3. Is Poweshield compatible with Hyper-V management? ______________________6
3.1 How to configure Powershield to manage Hyper-V? ________________________ 6 3.2 UpsConfigHyper-V configuration__________________________________________ 7 3.3 Retireving the virutal machines inside each host __________________________ 10 3.4 Retireving the virutal machines inside each host __________________________ 12 3.5 Test Hyper-V shutdown _________________________________________________ 14 3.6 Hyper-V shutdown ______________________________________________________ 15 4. How to setup a USB connection over MAC? ______________________________17 5. How to run upsagent in debug? ________________________________________19 6. How to run upssetup in debug? ________________________________________20
2
POWERSHIELD_TROUBLESHOOT_rev00 ________________________________________________________________________________ 1. When should I enable the secure connection? The secure connection field is disabled by default. This function should only be used when using a NetMan certified for cybersecurity. It must not be used in any other cases. ________________________________________________________________________________ 2. What are the SMTP settings with gmail? To configure Gmail as the mail provider it is essential to follow specific steps Firstly, ensure that two-factor authentication (2FA) is enabled on the Gmail account:
3
POWERSHIELD_TROUBLESHOOT_rev00 4
POWERSHIELD_TROUBLESHOOT_rev00
Please note that the app password generated by Gmail may include spaces. When entering this password into the Powershield, make sure to remove all spaces for proper functionality. Next, use the app password generated in the Gmail account to enable the Powershield to send emails successfully ________________________________________________________________________________
5
POWERSHIELD_TROUBLESHOOT_rev00 ________________________________________________________________________________ 3. Is Poweshield compatible with Hyper-V management? Powershield3 can manage Hyper-V. It’s possible to shutdown the virtual machine and one or more host. An example of the configuration of UpsConfigHyper-V is described as following. 3.1 How to configure Powershield to manage Hyper-V? This is an example of the structure of a Hyper-V, where two or more hosts are available. This structure has been taken from the Hyper-V Manager that is running on the host Windows Server 2022 EN1:
Powershield3 has been installed in Windows Server 2022 EN1 (WIN-2022EN1) and UpsConfigHyper-V is present in this host. We can say that, for Powershield3, this is the local host. This is referred to as the local host because Powershield3 is running on it. The first goal of this installation is to shutdown the virtual machines present in the host WIN2022EN2 and then to shutdown the host itself. The second goal of this installation is to shutdown the virtual machines present in the host WIN2022EN1 and then to shutdown the host itself.
6
POWERSHIELD_TROUBLESHOOT_rev00 3.2 UpsConfigHyper-V configuration First, set the Hyper-V host information. The first host that should be added is the host where Powershield3 is running (local host) and the slider Local host has to be enabled:
NOTE: The username (user) must be a local administrator account or in case it’s not a local administrator account it must be added to the Hyper-V Administrator group
7
POWERSHIELD_TROUBLESHOOT_rev00 Press the “+” button to add it in the Host list:
Then add all the other hosts. In this example, there is only one host left to be added. It’s the WIN2022EN2 host. As it’s not a local host, the slider is not to be enabled:
NOTE: The username (user) must be a local administrator account or in case it’s not a local administrator account it must be added to the Hyper-V Administrator group
8
POWERSHIELD_TROUBLESHOOT_rev00 Press the “+” button to add it in the Host list:
Repeat the action to add the hosts for all the hosts you want to manage / shutdown
9
POWERSHIELD_TROUBLESHOOT_rev00 3.3 Retireving the virutal machines inside each host Select the host and press the button “Retrieve VM from host” to get the virtual machine(s) running on that host. Below WIN-2022EN1 is selected and VMs are retrieved from it. You can see that three virtual machines are present in that host:
10
POWERSHIELD_TROUBLESHOOT_rev00 Below WIN-2022EN2 is selected and VMs are retrieved from it. You can see that two virtual machines are present in that host:
Note: not all the virtual machines are running. Some of the virtual machines are off.
11
POWERSHIELD_TROUBLESHOOT_rev00 3.4 Retireving the virutal machines inside each host If it’s not possible to retrieve the virtual machines from a host, it may be necessary to run the UpsConfigHyperV in debug mode to determine the cause. To do so, you need to open command prompt and to set the proper directory where UpsConfigHyper-V is running. Then run the command “UpsConfigHyperV -d”:
You will get:
12
POWERSHIELD_TROUBLESHOOT_rev00 Select “Configuring Hyper-V VM Shutdown”, select the host, and select “Retrieve VM from host”:
In the prompt window a log will be written, and the same log will be written in the file “debugs.log”. In this file you will be able to determine the reason why the VMs cannot be retrieved. In case of further information, please send the file debugs.log to the service dept.
This procedure can be repeated for all the hosts. 13
POWERSHIELD_TROUBLESHOOT_rev00 3.5 Test Hyper-V shutdown It’s suggested to perform a test when the configuration have been completed. Enable the “Test Hyper-V shutdown” with the slide and save:
From the directory “C:ProgramDataUpsmon” run the file “ups_shut.bat” The test can be performed ONLY running the file “ups_shut.bat” The test cannot be performed removing the mains from the UPS. Once the file has been executed, you will find in the same directory a log file called “ups.log” where you can see the result of the test. Taking as reference the above configuration, here the content of the file ups.log:
Note: In the log there will be present only the virtual machines that, in the moment of the shutdown, were running.
14
POWERSHIELD_TROUBLESHOOT_rev00 3.6 Hyper-V shutdown To perform a real shutdown, the “Test Hyper-V shutdown” must be disabled:
Remove the mains on the UPS. The shutdown will be executed for all the virtual machines and for all the hosts. NOTE: The host where Powershield3 is running (local host) will be shutdown last. To shutdown the host (local host), enable the shutdown in Upssetup:
In the file ups.log you will find the log of the real shutdown: 15
POWERSHIELD_TROUBLESHOOT_rev00 ________________________________________________________________________________
16
POWERSHIELD_TROUBLESHOOT_rev00 ________________________________________________________________________________ 4. How to setup a USB connection over MAC? 1. Stop Powershield/Upsmon service from command line by typing:
sudo launchctl stop com.rps.upsmon and pressing enter key NOTE – It is recommended to use a user with root permissions 2. Verify if our application is allowed to load by following the steps shown in the screenshots below, it must be allowed:
17
POWERSHIELD_TROUBLESHOOT_rev00 3. Type cd /Library/Extensions and press enter 4. Type ls and press enter, for checking that in list appear USBUPSDriver items, and if so, do for each USBUPSDriver item command sudo kextload as below:
– If USBUPSDriver is present, type sudo kextload USBUPSDriver.kext and press enter – If USBUPSDriver2 is also present, type sudo kextload USBUPSDriver2.kext and press
enter – If USBUPSDriver3 is also present, type sudo kextload USBUPSDriver3.kext and press
enter … NOTE If kextload command not allowed, type sudo kextutil for each USBUPSDriver 5. Repeat step 2 6. If the USB cable is connected, disconnect and reconnect it 7. Restart the Powershield/Upsmon service from the command line by typing:
sudo launchctl start com.rps.upsmon and pressing enter ________________________________________________________________________________
18
POWERSHIELD_TROUBLESHOOT_rev00 ________________________________________________________________________________ 5. How to run upsagent in debug? If a communication issue occurs, you can run UpsAgent in debug mode to generate a debug file, which should then be sent to the service department for analysis. 1. Open prompt 2. Open C:Program FilesUpsmon directory or C:Program FilesPowershield3 3. Run the command upsag_nt -debug
This window will apperar:
4. Stop the debug after 20 or 30 seconds pressing ctrl+c 5. Open C:ProgramDataUpsmon 6. Locate the file debug.log and send it to your service contact ________________________________________________________________________________
19
POWERSHIELD_TROUBLESHOOT_rev00 ________________________________________________________________________________ 6. How to run upssetup in debug? If a mail issue occurs, you can run UpsSetup in debug mode to geenrate a debug file, which should then be sent to the service department for analysis. 1. Open prompt 2. Open C:Program FilesUpsmon directory or C:Program FilesPowershield3 3. Run the command upssetup -debug
This window will appear:
4. Open Mail and messages and perform a test mail command, this window will appear:
5. Leave the above window running till the end 7. Exit from the UpsSetup window 8. Open C:ProgramDataUpsmon 9. Locate the file debugmail.log and send it to your service contact ________________________________________________________________________________
20
POWERSHIELD_TROUBLESHOOT_rev00
Changelog
DocRev rev00
Data
Change
28/03/2025 First release
21
Documents / Resources
 |
RIELLO Powershield Troubleshooting Communications Software [pdf] User Guide Powershield Troubleshooting Communications Software, Troubleshooting Communications Software, Communications Software, Software |