View / Edit Bridge properties   

Follow the given steps to view or edit the properties of a bridge:

1. Click the settings gear icon  located in the left pane.

2. Navigate to Advanced >> Bridge >> choose Bridge.  

3. In the Bridge list page, choose the specific bridge you want to work with by clicking its name.
   
4. This action will display the details of the selected bridge.
5. On this page, you can make changes to the listed properties of the bridge.
   
6. After making the necessary modifications, click Save to apply the changes. 

      

The following sections provided on the Bridge page allow you to access additional details, view the corresponding configuration, and make further modifications to bridge properties.

Bridge Health Metrics: 

The performance of the bridge and any tasks that rely on it is largely influenced by the performance of the machine hosting the bridge. It’s crucial to regularly monitor the system's performance and take proactive steps if any issues arise. The following charts help with this monitoring:

By accessing this section, you can view real-time performance metrics like CPU usage, Memory usage, etc., of the computer on which the bridge agent is hosted. The displayed metrics include:

1. CPU Usage Live Stats
   
2. Bridge Availability Report

These metrics automatically update every 30 seconds, offering up-to-date insights into system performance. To view the latest graph updates, refresh the page.

CPU Usage Live Stats

The live CPU usage report is displayed in two formats:

1. Bar Chart - Displays CPU usage percentage over time.
   
2. Pie Chart - Shows the distribution of RAM, disk, swap memory, and JVM usage.

Bridge Availability Report

This report provides details on the active status of the bridge over a selected period. It includes filter options to customize the report by:

1. Time range (from 24 hours to 1 year)
   
2. Percentage-based analysis
   

 

Performance Metrics: 

Displays a historical metric chart that visually represents chosen parameter metrics over a specified time frame, aiding in easy data interpretation and informed decision-making for system performance and resource utilization.

 

Modules: 

Displays the modules associated with the bridge, click the Associate Modules button, and from the displayed list of modules select the modules you wish to associate with the bridge.

  

Messages: 

Click the Messages tab, to view the messages processed in the Bridge.        

Configuration: 

Under Configuration tab, you can get the Registration Key and Ping Interval details.      

 

Update History: 

View the version history of the bridge and update it to the latest version with a single click. When a new version of the bridge is available, the Update button will be enabled. By clicking on it, you can effortlessly upgrade the bridge to the most recent version.

 

Logs: 

Offers a convenient way to access log files in bridge agent. Simply click the Get Logs button to retrieve the most recent log files from bridge agent. To download the retrieved log files, hover over the file name, and click the Download button. A maximum of 10 log files will be maintained, log file requests beyond that will pop out the oldest file to accommodate the new one.      

 

Performance Settings:  

Enables you to define the processing limits for request and response threads in bridge agent. Users can set the count and maximum count of threads that can be executed by bridge in parallel, along with the queue size for various types of threads like Request, Response, Synchronous Request, Asynchronous Request, and SFTP Request.      

1. Thread count - Minimum number of threads that can be executed in parallel.
   
2. Maximum Thread Count - Maximum number of threads that can be executed in parallel.
   
3. Queue size  - Maximum number of tasks that can be assigned to the bridge. Tasks assigned beyond the queue size will be disregarded.   

The login page of a bridge agent associated with an active bridge can be invoked from the Bridge list page.  Hover on the name of an active bridge in the list, click mouse over action menu, and click Open Agent menu item.  The bridge agent's login page will open in the default browser.

Restart a Bridge

You can easily restart a bridge agent right within your Bridge module with a single click that aids in troubleshooting.

To restart a bridge:

1. Navigate to  >> Advanced >> Bridge >> select Bridge.
2. Hover over the name of the bridge you want to restart, click mouse over action menu, and select Restart.
   
3. Confirm restart action.

 

Delete a Bridge   

Step 1: Stop Active Bridge (Prerequisite)   

You can stop the service using any of the following commands.

• sc stop qntrl_bridge

• net stop qntrl_bridge

• <bridge_home>/bin/bridge.bat stop

To stop the Bridge on Linux, use any of the following commands:

• sudo service qntrl_bridge stop

• sudo systemctl stop ql_bridge

• sudo sh <bridge_home>/bin/bridge.sh stop

Step 2: Deregister the Bridge Agent   

To deregister the Bridge agent, execute either of the following commands in the terminal:

• sc delete qntrl_bridge

• <bridge_home>/bin/bridge.bat remove 

For Linux:  

To deregister the agent on Linux, use the following command:

• <bge_home>/bin/bge.sh remove

Using systemctl or service commands will remove the service, but residual system files will remain.

Step 3: Manually Delete the Installation Folder   

After stopping and deregistering the Bridge agent, manually delete the Bridge installation folder from the location where it was installed. This ensures no residual files remain.

Possible Installation Locations:  

For Windows:

• C:\Program Files\Bridge

For Linux:

• /Bridge

Step 4: Delete the Bridge from the UI   

1. Navigate to  (settings) >> Advanced >> Bridge >> select Bridge.

2. Hover over the name of the bridge you want to delete, click mouse over action menu, and select Delete.

3. Confirm your delete action. 

View / Modify / Execute Message properties   

1. Navigate to  (settings) >> Advanced >> Bridge >> Select Messages.
2. On the Message list page, click on the Message ID to view its properties.
3. The details of the selected Message will be displayed. You can view/edit the properties of the fields (Bridge, Type, Request Data, etc.) of the message here.  
4. If you wish to execute the message, Click Execute.  
5. The response of the last execution will be available in the Response tab.   

 

 Delete a Message   

1. Navigate to(settings) >> Advanced >> Bridge >> select Messages.
   
2. Hover next to the ID of the message you want to delete, click mouse over action menu, and select Delete.
   
3. Confirm your delete action. The configured bridge message will be deleted.