71 lines
2.6 KiB
Markdown
71 lines
2.6 KiB
Markdown
# BizTalk Platform Management Tool
|
|
|
|
WinForms tool for controlled Microsoft BizTalk Server 2020 platform operations during maintenance windows. The tool captures runtime snapshots, creates shutdown and restore plans, executes those plans in a safe order, and writes diff reports for validation.
|
|
|
|
## Current State
|
|
|
|
- Application: C# WinForms
|
|
- Target framework: .NET Framework 4.7.1
|
|
- Solution: `BizTalkPlatformManagementTool.sln`
|
|
- Project: `src/BizTalkPlatformManagementTool/BizTalkPlatformManagementTool.csproj`
|
|
- Primary namespace and assembly: `BizTalkPlatformManagementTool`
|
|
- Legacy PowerShell archive: `archive/powershell/BizTalkPlatformManagementTool.ps1`
|
|
|
|
## Features
|
|
|
|
- Snapshot before and after downtime as JSON, CSV and HTML
|
|
- Diff between `before.json` and `after.json`
|
|
- Controlled shutdown from the current runtime state
|
|
- Controlled restore from `before.json`
|
|
- Host instance handling for the selected BizTalk server
|
|
- Dry-run mode enabled by default
|
|
- WMI access through `root\MicrosoftBizTalkServer`
|
|
- No compile-time dependency on BizTalk ExplorerOM assemblies
|
|
|
|
## Safe Usage
|
|
|
|
1. Start the app on a BizTalk server or a management host with WMI access.
|
|
2. Keep **Dry run** enabled.
|
|
3. Click **Diagnose** to verify WMI access.
|
|
4. Click **Snapshot Before**.
|
|
5. Click **Shutdown** and review `shutdown-plan.json`.
|
|
6. Disable **Dry run** only when the plan is correct.
|
|
7. After maintenance, click **Restore** using the saved `before.json`.
|
|
8. Click **Snapshot After** and **Compare**.
|
|
|
|
## Operation Order
|
|
|
|
Shutdown:
|
|
- Disable receive locations that were enabled.
|
|
- Stop orchestrations that were started.
|
|
- Stop send ports that were started.
|
|
- Stop host instances that were started on the selected server.
|
|
|
|
Restore:
|
|
- Start host instances that were previously started.
|
|
- Restore send ports to Started, Stopped or Bound.
|
|
- Restore orchestrations where safe.
|
|
- Restore receive locations last.
|
|
|
|
Orchestrations that were `Bound` are deliberately left unchanged during restore to avoid accidentally making them `Unbound`.
|
|
|
|
## Outputs
|
|
|
|
- `before.json`, `after.json`
|
|
- `shutdown-plan.json`, `restore-plan.json`
|
|
- `shutdown-after.json`, `restore-after.json`
|
|
- `diff.json`, `diff.csv`, `diff.html`
|
|
- Snapshot sidecars: `*.csv`, `*.hosts.csv`, `*.html`
|
|
|
|
## Build
|
|
|
|
Open `BizTalkPlatformManagementTool.sln` in Visual Studio on Windows with the .NET Framework 4.7.1 Developer Pack installed, then build the `Release|Any CPU` configuration.
|
|
|
|
The app targets .NET Framework 4.7.1 because BizTalk Server 2020 commonly runs in that Windows/.NET Framework operational environment.
|
|
|
|
## Documentation
|
|
|
|
- [Installation](Installation.md)
|
|
- [Dokumentation](Dokumentation.md)
|
|
- [References](REFERENCES.md)
|