OE Manager GUI

A Visual Studio Code extension that provides a graphical interface to manage OpenEdge PASOE (Progress Application Server for OpenEdge) agents and sessions through the OpenEdge oemanager REST API.

Features

This extension provides a comprehensive dashboard for managing your PASOE AppServer environment:

Real-time Monitoring

• SessionManager Metrics - View key performance metrics with auto-refresh capability
• Agents Grid - Monitor all agents with their current status and properties
• Sessions Grid - View active sessions for selected agents
• Running Queries - Track active requests with auto-refresh (configurable interval)

Agent Management

• Add Agent - Create new agents with a single click
• Delete Agent - Remove agents with configurable wait times
• Enable/Disable ABL Objects - Control ABL object handling per agent
• Get ABL Objects Report - Export detailed ABL objects information to file
• View Agent Properties - Display comprehensive agent configuration

Configuration

• Flexible authentication (Basic Auth)
• SSL certificate validation control (supports self-signed certificates)
• Configurable API endpoints
• Auto-refresh intervals for real-time data
• Customizable wait times for agent operations

Requirements

• OpenEdge PASOE with oemanager application deployed and accessible
• VS Code version 1.105.0 or higher
• Network access to your PASOE server's oemanager REST API endpoints

Installation

1. Install the extension from the VS Code Marketplace (or manually via .vsix file)
2. Configure the extension settings (see Configuration section below)
3. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
4. Run OE Manager: Show Agents

Configuration

Configure the extension through VS Code settings (File > Preferences > Settings or Ctrl+,):

Required Settings

Password: For security, the password is stored securely using VS Code's Secret Storage API. Use the command palette to set it:

• Run OE Manager: Set Password to store your password securely
• Run OE Manager: Delete Password to remove the stored password

Optional Settings

Example Configuration

{
  "diabolo.oemanager.baseUrl": "https://base.url.to.pasoe.com",
  "diabolo.oemanager.applicationName": "PASOE_NAME",
  "diabolo.oemanager.username": "admin",
  "diabolo.oemanager.rejectUnauthorized": false,
  "diabolo.oemanager.requestsRefreshInterval": 5
}

Note: After setting the configuration, run OE Manager: Set Password from the command palette to securely store your password.

Usage

Opening the Dashboard

1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Type OE Manager: Show Agents
3. Press Enter

Managing Agents

Add an Agent:

• Click the "Add Agent" button in the toolbar

Agent Context Menu (Right-click on any agent):

• Enable ABL Objects - Enable ABL object handling
• Disable ABL Objects - Disable ABL object handling
• Get ABL Objects Report - Export report to JSON file
• Delete Agent - Remove the agent (with confirmation)

Viewing Sessions

• Click on any agent row to view its active sessions
• Sessions are displayed in the grid below the agents

Monitoring Running Queries

• The bottom grid shows all active requests across the application
• Toggle auto-refresh ON/OFF using the button in the grid header
• Refresh interval is configurable via settings

Auto-Refresh Controls

Both SessionManager Metrics and Running Queries grids have independent auto-refresh toggle buttons:

• Click "Refresh: ON" to disable auto-refresh
• Click "Refresh: OFF" to enable auto-refresh
• Both use the same interval from oemanager.requestsRefreshInterval

API Endpoints Used

This extension interacts with the following OpenEdge oemanager REST API endpoints:

• GET /oemanager/applications/{app}/agents - List agents
• GET /oemanager/applications/{app}/agents/{id}/sessions - Get agent sessions
• GET /oemanager/applications/{app}/agents - Get agent properties
• GET /oemanager/applications/{app}/metrics - Get SessionManager metrics
• GET /oemanager/applications/{app}/requests - Get active requests
• POST /oemanager/applications/{app}/addAgent - Create new agent
• DELETE /oemanager/applications/{app}/agents/{id} - Delete agent
• PUT /oemanager/applications/{app}/agents/{id}/ABLObjects/status - Enable/disable ABL objects
• GET /oemanager/applications/{app}/agents/{id}/ABLObjects - Get ABL objects report

Commands

Troubleshooting

Connection Issues

If you can't connect to the oemanager API:

1. Verify diabolo.oemanager.baseUrl is correct
2. Check that the oemanager application is running
3. Confirm network connectivity to the PASOE server
4. Verify username is correct and password is set using OE Manager: Set Password command

SSL Certificate Errors

For self-signed certificates:

• Set diabolo.oemanager.rejectUnauthorized to false

Authentication Failures

• Ensure diabolo.oemanager.username is correctly set
• Run OE Manager: Set Password command to securely store your password
• Verify the user has permissions to access oemanager APIs

Known Issues

• Large ABL Objects reports may take time to download and save
• Auto-refresh continues when extension is in background (by design)

Release Notes

0.0.3 (Current)

Features:

• Secure password storage using VS Code Secret Storage API
• Passwords no longer stored in clear text settings
• New commands: "Set Password" and "Delete Password"

0.0.1 (Initial Release)

Features:

• Real-time monitoring of PASOE agents, sessions, and requests
• SessionManager metrics dashboard
• Add/Delete agent operations
• Enable/Disable ABL Objects per agent
• Export ABL Objects reports
• Auto-refresh for metrics and running queries
• Basic authentication support
• SSL certificate validation control
• Context menu actions for agent management

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests to the GitHub repository.

License

See LICENSE file for details.

Note: This extension requires access to an OpenEdge PASOE server with the oemanager application properly configured and accessible.