KB 198 - Starting the PowerConnect Java Agent in Safe Mode
KB 198 (JAVA): Starting the PowerConnect Java Agent in Safe Mode
Category: Information | Priority: Normal |
---|---|
Platform: JAVA | Version: 1 from 01.04.2024 |
Description
There may be situations where you need to start the PowerConnect Java Agent and get access to it’s UI to alter configuration etc. without starting any of the extractors. To do this the PowerConnect Java Agent can be started in safe mode (available from version 8.1.0) by following the steps below:
Login to SAP NWA Console
Navigate to Configuration → Infrastructure → Java System Properties
![image-20240304-065119.png](../__attachments/3439263770/image-20240304-065119.png?inst-v=ac5eec74-b94c-4536-9f14-31cf6d61e6ba)
Click the ‘Applications’ tab
In the Vendor column search for ‘powerconnect’
![image-20240304-065326.png](../__attachments/3439263770/image-20240304-065326.png?inst-v=ac5eec74-b94c-4536-9f14-31cf6d61e6ba)
Click ‘spcj_app’
In the Properties tab scroll to the powerconnect.safemode property in the table
![image-20240304-065528.png](../__attachments/3439263770/image-20240304-065528.png?inst-v=ac5eec74-b94c-4536-9f14-31cf6d61e6ba)
Click ‘Modify’
Change the value from true to false
![image-20240304-065620.png](../__attachments/3439263770/image-20240304-065620.png?inst-v=ac5eec74-b94c-4536-9f14-31cf6d61e6ba)
Click ‘Set’
Click ‘Save’
![image-20240304-065720.png](../__attachments/3439263770/image-20240304-065720.png?inst-v=ac5eec74-b94c-4536-9f14-31cf6d61e6ba)
Safe mode is now enabled
Start or restart the PowerConnect Java Agent by following this guide - Start & Stop PowerConnect Java agent (PowerConnect Java - All Versions)
In the PowerConnect Java Agent logs you will see safe mode is activated
![image-20240304-073539.png](../__attachments/3439263770/image-20240304-073539.png?inst-v=ac5eec74-b94c-4536-9f14-31cf6d61e6ba)
In this mode no data will be collected except agent health stats and the only job that will run is the configuration refresh/update
Once you have made the required configuration changes to the PowerConnect Java Agent set the powerconnect.safemode application property back to false by following the steps above and restart the Agent