Riverbed SteelScript is a collection of libraries and scripts written in Python for interacting with Riverbed solutions and appliances, and other network infrastructure devices.

If you have git and Docker installed. Open your shell (bash or PowerShell), build SteelScript from the latest source code and run it locally in a Docker container as follows:

# Build a docker image from latest code
docker build --tag steelscript:latest https://github.com/riverbed/steelscript.git

# Run the image in an interactive container
docker run -it steelscript:latest /bin/bash

From here you can start to use the SteelScript framework. You can try some script examples.

1. Print the Host Groups of an AppResponse appliance:

python examples/appresponse-examples/print_hostgroups-formatted.py {appresponse fqdn or IP address} -u {admin account} -p {password}

2. Get the licenses and services of a Client Accelerator Controller appliance:

python examples/cacontroller-examples/cacontroller-rest_api.py {client accelerator controller fqdn or IP address} --access_code {access_code}

3. List the devices from NetIM Core:

python examples/netim-examples/print-netim-devices-raw.py {netim core fqdn or IP address} --username {account} --password {password}

Build a steelscript container image that includes the Jupyter Notebook server.

# Build the steelscript base image
docker build --tag steelscript:latest https://github.com/riverbed/steelscript.git

# Build the steelscript image for Jupyter Notebook
docker build --tag steelscript.notebook -f Dockerfile.notebook https://github.com/riverbed/steelscript.git

Run the container with Jupyter Notebook server, by default on port 8888

# Start the steelscript.notebook container with built-in Jupyter Notebook
docker run --init --rm -p 8888:8888 --name=steelscript.notebook steelscript.notebook

In the output, grab the url containing the token, for example http://127.0.0.1:8888/tree?token=123456 , and open it in your browser to log into the Jupyter web-console.

From there, in the Notebooks folder you can find some notebook examples based on SteelScript.

For a complete guide with installation details, see https://support.riverbed.com/apis/steelscript

The doc needs a good refresh

The recommendation is to use SteelScript in a Docker container or install directly from the python code publicly available in Github. In the SteelScripts docs there are more details about other installation methods but Docker is the easiest.

The goal is to be able to release each new version (corresponding to a tag in the master branch) at least in a Docker public repository: SteelScript on Docker Hub

For contribution for alternative distribution methods and packaging (like pypi, rpm, .deb, rpm, tgz,...), artifacts will be organized inside /packaging and /test subfolders. We might need to dedicate another repo.

Feel free to use, enhance and contribute by creating issues, sending pull requests (PR), extending with new modules ...

The common module for SteelScript is in the SteelScript repo It contains common code but also it is the entrypoint for Documentation, Build, Test and releases.

Other SteelScript modules have their own repository which can be found in the Riverbed GitHub org, the name is prefixed by "steelscript".

Modules for Riverbed products and appliances:

• AppResponse
• NetIM
• NetProfiler
• SteelHead
• SteelHead Controller (a.k.a SCC)
• Client Accelerator Controller (formerly called SteelHead Mobile controller, SMC or SCCM)

Extra modules

• Wireshark
• NetShark
• Packets
• Command line Access

Other repos for components and SteelScript extensions:

• known issues, pending maintenance Application Framework
• known issues, pending maintenance - Business hour reporting plugin for Application Framework
• known issues, pending maintenance - Stock report demo with Application Framework
• known issues, pending maintenance VM Config

SteelScript is based on Python 3. The repos of SteelScript modules have a common structure

steelscript-module-name     # for example: steelscript-appresponse
├── README.rst
├── LICENSE
├── CHANGELOG
├── .gitignore
├── docs
├── examples
├── steelscript
│   ├── __init__.py
│   └── module-name          # for example: appresponse
│       ├── core
│       │   └── __init__.py
│       ├── commands
│       │   └── __init__.py
│       └── __init__.py
├── tests
├── setup.py
├── notebooks
└── tox.ini

Mandatory:

• README.rst: simple description using reStructured Text (rst) file format
• LICENSE: Riverbed Technology copyright, terms and conditions based on MIT
• CHANGELOG: Simple text file tracking major changes
• /docs: Documentation using reStructured Text (rst) file format.
• /examples: Python scripts samples showing how to use the module.
• /steelscript: The actual code, written in Python. Must be Python3 only.
• /tests: Test plans and unit test. Can be organized in subfolders. Test plan are ideally documented and easy to run scripts but can be anything defining a test plan (script, text, ...), for example a python script based on pytest.
• setup.py: Python setup file containing meta descriptions and requirements. Based on setuptools, distutils, gitpy-versioning (custom versioning tool https://github.com/riverbed/gitpy-versioning) and pytest. Should NOT contain unit test (use Tox and put unit test inside /tests folder instead)

Optional:

• /tox.ini: standardized python testing definition based on Tox
• /notebooks: Notebooks based on Jupyter

Builds are defined in the SteelScript repo

Prebuild test-plans validations

todo

Execute test-plans with tox

pip install tox
tox

Building Docker containers

Some Dockerfile are provided to build different flavors of the SteelScript container image:

• Dockerfile: standard build
• Dockerfile.slim: optimized build
• Dockerfile.notebook: build for demo and learning with Notebooks
• Dockerfile.dev: build development and testing container from master or fork/branch

Standard:

docker build --tag steelscript -f Dockerfile .

Slim:

docker build --tag steelscript.slim -f Dockerfile.slim .

Notebook

docker build --tag steelscript.notebook -f Dockerfile.notebook .

Dev from master

git clone https://github.com/riverbed/steelscript --depth 1 --recurse-submodules
git clone https://github.com/riverbed/steelscript-netprofiler --depth 1 --recurse-submodules
git clone https://github.com/riverbed/steelscript-wireshark --depth 1 --recurse-submodules
git clone https://github.com/riverbed/steelscript-cmdline --depth 1 --recurse-submodules
git clone https://github.com/riverbed/steelscript-scc --depth 1 --recurse-submodules
git clone https://github.com/riverbed/steelscript-appresponse --depth 1 --recurse-submodules
git clone https://github.com/riverbed/steelscript-netim --depth 1 --recurse-submodules
git clone https://github.com/riverbed/steelscript-client-accelerator-controller --depth 1 --recurse-submodules
git clone https://github.com/riverbed/steelscript-steelhead --depth 1 --recurse-submodules
git clone https://github.com/riverbed/steelscript-packets.git --depth 1 --recurse-submodules

docker build --tag steelscript.dev --progress=plain -f steelscript/Dockerfile.dev .

Dev from your_fork/your_branch

git clone https://github.com/your_fork/steelscript --depth 1 --recurse-submodules -b your_branch
git clone https://github.com/your_fork/steelscript-netprofiler --depth 1 --recurse-submodules -b your_branch
git clone https://github.com/your_fork/steelscript-wireshark --depth 1 --recurse-submodules -b your_branch
git clone https://github.com/your_fork/steelscript-cmdline --depth 1 --recurse-submodules -b your_branch
git clone https://github.com/your_fork/steelscript-scc --depth 1 --recurse-submodules -b your_branch
git clone https://github.com/your_fork/steelscript-appresponse --depth 1 --recurse-submodules -b your_branch
git clone https://github.com/your_fork/steelscript-netim --depth 1 --recurse-submodules -b your_branch
git clone https://github.com/your_fork/steelscript-client-accelerator-controller --depth 1 --recurse-submodules -b your_branch
git clone https://github.com/your_fork/steelscript-steelhead --depth 1 --recurse-submodules -b your_branch
git clone https://github.com/your_fork/steelscript-packets.git --depth 1 --recurse-submodules -b your_branch

docker build --tag steelscript.dev --progress=plain -f steelscript/Dockerfile.dev .

Copyright (c) 2021-2024 Riverbed Technology, Inc.

SteelScript is licensed under the terms and conditions of the MIT License accompanying the software ("License"). SteelScript is distributed "AS IS" as set forth in the License. SteelScript also includes certain third party code. All such third party code is also distributed "AS IS" and is licensed by the respective copyright holders under the applicable terms and conditions (including, without limitation, warranty and liability disclaimers) identified in the license notices accompanying the software.