SDO Installation Instructions

Overview

SDO (Simple DevOps) is installed using an isolated virtual environment to prevent dependency conflicts with other Python tools. This approach keeps the NTools distribution smaller by shipping only source code rather than pre-compiled executables.

Prerequisites

Before installing SDO, you must have NTools installed. See the main Installation documentation for NTools setup instructions.

Quick Installation

After installing NTools, run the SDO installer:

cd "C:\Program Files\NBuild"
python install-sdo.py

Verify installation:

sdo --version
sdo --help

What the Installation Does

1. Creates Virtual Environment: C:\Program Files\NBuild\venv\
2. Installs SDO: Installs SDO and dependencies in isolation
3. Creates Launcher: sdo.cmd script that activates venv and runs SDO
4. Maintains PATH: Since NBuild is in PATH, sdo works globally

Troubleshooting

Python Not Found

• Ensure Python 3.8+ is installed and in PATH
• Run: python --version to verify

Permission Errors

• Run command prompt as Administrator
• Or install to user directory: python install-sdo.py --nbuild-path "%USERPROFILE%\NBuild"

Installation Fails

• Check internet connection (pip downloads dependencies)
• Try dry-run first: python install-sdo.py --dry-run

SDO Command Not Found

• Ensure C:\Program Files\NBuild is in PATH
• Restart command prompt after installation
• Check that sdo.cmd exists in NBuild directory

Uninstalling SDO

To remove SDO completely:

# Remove virtual environment
rd /s "C:\Program Files\NBuild\venv"

# Remove launcher script
del "C:\Program Files\NBuild\sdo.cmd"

# Remove source files (optional)
rd /s "C:\Program Files\NBuild\sdo_package"
del "C:\Program Files\NBuild\install-sdo.py"
del "C:\Program Files\NBuild\pyproject.toml"