This extension adds a command button to each entry in the InterSystems Server Manager tree. Clicking the button creates a VS Code tab containing a WebTerminal connected to the chosen server.
The button is also available under the Namespaces tree of each server. Use it there to start your WebTerminal in the chosen namespace. This action also adds the namespace name to the label of the WebTerminal tab.
If you prefer to open a WebTerminal externally in your default web browser, use the context menu of the server row or namespace row.
The extension is competing in the InterSystems Grand Prix 2022 programming contest. Voting period: May 30 - June 5, 2022. If you like it please vote for it.
The extension is published on Marketplace. Either install it from there, or search for its identifier georgejames.webterminal-vscode
in the Extensions view of VS Code.
This extension depends on the InterSystems Server Manager extension, and will install it automatically if necessary.
WebTerminal must already be installed on the target InterSystems servers. See here for instructions. The current WebTerminal version (4.9.3) is documented as working on versions from 2014.1 upward.
If you only want to open WebTerminals in your browser using the context menu (see above), no further setup is required.
To launch them in VS Code tabs do the following:
This procedure has been verified with:
- IRIS 2020.1.1 and IIS 10.0 web server
- IRIS 2021.1.2 and Apache 2.4.29
Correct operation on other products and versions remains unproven.
/terminal
. Name the copy /terminal-vscode
. Suggested description is Copy of /terminal for use by georgejames.webterminal-vscode extension
Session Cookie Scope
of the new /terminal-vscode
application to the value None
.https
. As a minimum it needs to serve the following applications:
An open WebTerminal issue means these have to be served from the root of the web server (e.g. https://myserver.internal/terminal/). If placed under a subfolder (e.g. https://myserver.internal/dev/terminal/) the initial standalone WebTerminal authentication dialog will appear but connection will fail.
"http.proxyStrictSSL": false
at Workspace or User level.WebTerminal.Router.cls
in the namespace where you installed WebTerminal, adding these lines and recompiling the class after saving it: Parameter HandleCorsRequest = 1;
Parameter UseSession As BOOLEAN = 1;
CSPSystem
) has at least READ privilege on the security resource which protects WebTerminal's code database.See the CHANGELOG for changes in each release.
UseSession
line to README.Session Cookie Scope
setting./terminal-vscode
application.Initial release. Entered into the InterSystems Grand Prix 2022 programming contest.