When to Use Manual Installation
Manual installation using a VSIX file is useful when:- Your organization blocks VS Code Marketplace access
- You need to install a specific version
- You’re testing a pre-release version
- You’re in an air-gapped environment
- You want to distribute the extension internally
Obtaining the VSIX File
Download from Publisher
Contact BTSS Corp for the VSIX file:- Support Portal: Submit a request (recommended)
- Email: support@btsscorp.com (alternative)
- Subject: Request Koala Data Explorer VSIX
- Specify the version you need
Building from Source
If you have access to the source code:.vsix
file in the project directory.
Installation Methods
Method 1: Using VS Code UI
- Open VS Code
- Go to Extensions view (
Ctrl+Shift+X
) - Click the … menu at the top of Extensions view
- Select Install from VSIX…
- Browse to your
.vsix
file - Select the file and click Install
- Reload VS Code when prompted
Method 2: Using Command Palette
- Open Command Palette (
Ctrl+Shift+P
orCmd+Shift+P
) - Type: Extensions: Install from VSIX…
- Select the command
- Browse to your
.vsix
file - Confirm installation
Method 3: Using Command Line
Method 4: Manual Copy (Advanced)
For system-wide installation or automation:Verification
After installation, verify the extension:Check Extension List
- Open Extensions view (
Ctrl+Shift+X
) - Search for “Koala”
- Verify “Koala Data Explorer” appears with correct version
Test Command Availability
- Open Command Palette (
Ctrl+Shift+P
) - Type: “Koala”
- Verify you see “Koala Data Explorer: Open SQL Query Editor”
Check Installation Directory
Offline Installation
For completely offline environments:1. Prepare Installation Package
On a machine with internet access:2. Transfer and Install
On the offline machine:Managing Multiple Versions
Installing Specific Versions
Keep multiple VSIX files with version numbers:Switching Versions
- Uninstall current version
- Install desired version from VSIX
- Reload VS Code
Version Downgrade
Troubleshooting Manual Installation
VSIX File Not Recognized
If VS Code doesn’t recognize the VSIX file:- Ensure file extension is
.vsix
(not.zip
) - Check file isn’t corrupted (try re-downloading)
- Verify file permissions allow reading
Installation Permissions Error
On Windows:Extension Not Loading After Install
- Fully restart VS Code (not just reload)
- Check for conflicts with other extensions
- Review errors in Help → Toggle Developer Tools
- Clear extension cache:
Dependency Issues
If the extension fails due to missing dependencies:- Ensure VS Code version >= 1.74.0
- Install Visual C++ Redistributable (Windows)
- Check Node.js native modules are compatible
Deployment Automation
For IT Administrators
Deploy to multiple machines using scripts: PowerShell (Windows):Using Configuration Management
Ansible Playbook:Post-Installation Configuration
After manual installation:- Verify Installation: Check extension appears in list
- Configure Settings: Adjust timeout, logging, etc.
- Set Up Connection: Add Oracle Fusion credentials
- Activate License: Enter license key if you have one
Security Considerations
When installing manually:Only install VSIX files from trusted sources. Verify the publisher and file integrity before installation.