Skip to main content

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:

Building from Source

If you have access to the source code:
This creates a .vsix file in the project directory.

Installation Methods

Method 1: Using VS Code UI

  1. Open VS Code
  2. Go to Extensions view (Ctrl+Shift+X)
  3. Click the menu at the top of Extensions view
  4. Select Install from VSIX…
  5. Browse to your .vsix file
  6. Select the file and click Install
  7. Reload VS Code when prompted

Method 2: Using Command Palette

  1. Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
  2. Type: Extensions: Install from VSIX…
  3. Select the command
  4. Browse to your .vsix file
  5. 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

  1. Open Extensions view (Ctrl+Shift+X)
  2. Search for “Koala”
  3. Verify “Koala Data Explorer” appears with correct version

Test Command Availability

  1. Open Command Palette (Ctrl+Shift+P)
  2. Type: “Koala”
  3. 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

  1. Uninstall current version
  2. Install desired version from VSIX
  3. 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:
On macOS/Linux:

Extension Not Loading After Install

  1. Fully restart VS Code (not just reload)
  2. Check for conflicts with other extensions
  3. Review errors in Help → Toggle Developer Tools
  4. Clear extension cache:

Dependency Issues

If the extension fails due to missing dependencies:
  1. Ensure VS Code version >= 1.74.0
  2. Install Visual C++ Redistributable (Windows)
  3. Check Node.js native modules are compatible

Deployment Automation

For IT Administrators

Deploy to multiple machines using scripts: PowerShell (Windows):
Bash (macOS/Linux):

Using Configuration Management

Ansible Playbook:

Post-Installation Configuration

After manual installation:
  1. Verify Installation: Check extension appears in list
  2. Configure Settings: Adjust timeout, logging, etc.
  3. Set Up Connection: Add Oracle Fusion credentials
  4. 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.

Verify File Integrity

Check SHA256 hash if provided:

Scan for Malware

Run security scans before installation:

Next Steps

After successful manual installation:

First Connection

Set up your Oracle Fusion connection

Configuration

Configure extension settings

License Activation

Activate your license

Troubleshooting

Resolve common issues