1 2 Previous Next

SteelScript

20 Posts

Happy Holidays to all from the Riverbed SteelScript team!

 

This updated version of the SteelScript VM largely focuses on new AppResponse reports for App Framework, as well as a new column and source chooser under the help menu.

 

Here are the links to the updated images:

OVA image: steelscript-vm-1.5-20171214.ova (1.3 GB) (checksum)

VM Source Code: steelscript-vm-source-1.5-20171214.tar.gz (1.9 GB) (checksum)

 

As before, the logins are as follows:

     - via SSH using vagrant:vagrant

     - via Web UI on port 80 using admin:admin


The new AppResponse reports cover all of the available sources:

Screen Shot 2017-12-18 at 4.33.40 PM-2.png


And you can find the new Column Helper under Help->AppResponse:

Screen Shot 2017-12-18 at 4.32.57 PM.png

 


We have just released steelscript.appresponse 1.1 on GitHub and Python Package Repository, PyPI.

 

With an existing Python 2.7 environment, installation should be as simple as:

> pip install --upgrade steelscript.appresponse

 

After installation, you can collect all example scripts in your environment using the steel mkworkspace command.

 

The biggest update of the new release is adding reporting support for all non-packets data sources. In particular, the updates include:

  • Support for reporting against non-packets data sources
  • Support for traffic filters when creating a report
  • Per source support for the command 'steel appresponse columns'
  • New command 'steel appresponse sources'
  • New example script 'general_report.py'

 

Our SteelScript documentation on the Support Site has been updated and can be found here:

 

     https://support.riverbed.com/apis/steelscript/appresponse/toc.html

 

For any questions or requests, feel free to reach us by posting a comment below, or submitting a request to our GitHub page here.

We are releasing SteelScript VM 1.4 with support of AppResponse 11 and PCAP File Manager component in SteelScript Application Framework!

 

Links to the updated images:

OVA image: steelscript-vm-1.4-20170817.ova (1.3 GB) (checksum)

VM Source Code: steelscript-vm-source-1.4-20170817.tar.gz (1.9 GB) (checksum)

 

You can find new AppResponse example scripts inside directory /home/vagrant/steelscript-workspace/appresponse-examples after logging in the VM via SSH using vagrant:vagrant. These example scripts (as described here) largely cover the SDK support for AppResponse 11.


In addition, we have provided an example Appfwk report that allows users to easily run a report against a given packets data source, such as a packet capture job or an uploaded PCAP file. Connect to the web server via your browser, login with admin:admin and you can find the new report under Reports->appresponse->AppResponse Report.


To help you find column names when coding your own packets report script, a column helper page has been developed in SteelScript Appfwk, which is available at Help-> AppResponse columns.

 

Another important update is adding PCAP File Manager component in SteelScript Appfwk. With previous versions of SteelScript VM, to run a report against a PCAP file, the file needs to be uploaded to the server from disk every time, which can take a long time. With PCAP file manager, you just need to upload the file for the first time only. Besides, PCAP file manager provides a nice interface to manage all uploaded PCAP files. You can find the manager under the admin menu: admin->Edit PCAP files.

 

That sums up the new features! If you have developed your own reports or plugins in VM 1.3, and wish to continue using them in VM 1.4, we will publish another post about how to upgrade your VM to the latest.

We have just published our first version of SteelScript for AppResponse 11, surprisingly named steelscript-appresponse! As always, our code is open source and available on GitHub or for download from the Python Package Repository, PyPI

 

With an existing Python 2.7 environment, installation should be as simple as:

 

> pip install steelscript.appresponse

 

This initial version should cover a majority of the use cases you've used SteelScript for with NetShark, including:

 

  • Packet analysis and reporting
  • PCAP uploads and downloads
  • Capture Job management

 

In addition, we have support for Host Group management including creating, updating, and deleting new groups.

 

Our SteelScript documentation on the Support Site has been updated with the new module and can be found here:


     https://support.riverbed.com/apis/steelscript/appresponse/toc.html

 

Several example scripts have been included to help get you started, and we will be expanding on the documentation for developing your own scripts in the near future.

 

If you have particular use cases you'd like to see supported by this package, feel free to let us know by posting a comment below, or submitting a request to our GitHub page here:  https://github.com/riverbed/steelscript-appresponse/issues

Attached is a video that demonstrates how to bulk configure devices and run a customized command on multiple SteelHead devices with the latest SteelScript VM 1.3 release.

Wenxuan Guo

SteelScript VM 1.3 Release

Posted by Wenxuan Guo Apr 13, 2017

Welcome to SteelScript VM 1.3!

 

Links to the updated images:

OVA image: steelscript-vm-1.3-20170413.ova (1.3 GB) (checksum)

VM Source Code: steelscript-vm-source-1.3-20170413.tar.gz (1.9 GB) (checksum)

 

We have lots of exciting updates!

 

New SteelHead Reports

     - An Appfwk report (Reprots -> steelhead -> Single SteelHead Report) that shows current status for one SteelHead device

     - An Appfwk report (Reports -> steelhead -> SteelHead Batch Report) that shows the output of one customized command running on multiple tagged (see below) SteelHead devices

 

Device Config Features

     - Bulk configure devices by uploading a CSV file

     - Add tags to each device

 

NetShark Capture Job Report

      - This report (Reports -> netshark -> NetShark Capture Jobs) shows information of all capture jobs on all configured NetShark devices


New NetProfiler Reports

     - A script (/home/vagrant/steelscript-workspace/netprofiler-examples/template_report.py) to generate a PDF file from live report

     - An Appfwk report (Reports -> netprofiler -> NetProfiler Live Templates) that shows information of all widgets running in live templates


Static Files in Offline Mode

     This feature supports using static files from our latest user interface libraries in offline mode. In particular, if the SteelScript VM can not access internet, the static files are required to be manually uploaded to the SteelScript VM. Detailed steps are described here.

 

Django / Pandas Library Updates

     - Our SteelScript Appfwk Server is updated to use Django 1.8. Release notes of Django 1.8 are here.

     - We are supporting Pandas 0.19, which greatly improves installation and build times. Release notes of Pandas 0.19 are here.

 

This post covers Q&A's to get you started.

 

-----

Copyright (c) 2017 Riverbed Technology, Inc.

 

SteelScript VM is licensed under the terms and conditions of the MIT License accompanying the software ("License").  SteelScript VM is distributed "AS IS" as set forth in the License. SteelScript VM 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.

Our brand new image of the SteelScript VM is now available including an updated user interface for our SteelScript App Framework and many underlying improvements to our core code.   Take a look at the new look and feel along with our new widget types:

 

Screen Shot 2016-12-15 at 9.36.17 AM.png

 

The core OS has been updated to the latest CentOS 7.3 which takes advantage of the latest security features.


See the full usage document here:

     11.2. SteelScript VM Configuration and Usage — steelscript  documentation

 

Links to the updated images:

 

OVA image - steelscript-vm-1.2-20161215.ova (1.0 GB) (checksum)

VM Source Code - steelscript-vm-source-1.2-20161215.tar.gz (1.7 GB) (checksum)


The source code for the complete virtual machine isn't necessary unless you'd like to peek at the components of the core OS.


See below for some Q&A's which should help get you started:

 

Q: What are the login credentials?

A: Once installed and running, the primary system login/password is vagrant/vagrant.  This password should work both via SSH as well as console access.  For the App Framework the default login/pasword is admin/admin.

 

Q: How do I access the App Framework?

A: Determine the IP address of the VM, and access it directly using port 80.

 

Q: I've gotten it installed and running, what now?

A: See the README file when you first login at /home/vagrant/README, it contains lots of good information including how to access the server, and important security considerations.

 

Q: How do I deploy using the "ovftool" command?

A: An example using the command line ovftool:


> ovftool --diskMode=thin --net:"nat"="VM Network" <OVAFILENAME>.ova  vi://<esxi host>

 

Q: When importing the OVA, I get an error of incompatible hardware?

A: See this post for a reported workaround: SteelScript running after Riverbed FORCE (help)

 

Q: How can I build my own VM from scratch?

A: This VM was built using a vagrant configuration, and everything has been posted to github: riverbed/steelscript-vm-config · GitHub

 

 

 

-----

Copyright (c) 2016 Riverbed Technology, Inc.

 

SteelScript VM is licensed under the terms and conditions of the MIT License accompanying the software ("License").  SteelScript VM is distributed "AS IS" as set forth in the License. SteelScript VM 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.

We have collected all of the code updates since our latest VM released and packaged them together with a host of configuration optimizations for a brand new VM image.

 

The core OS has been updated from CentOS 7.0 to CentOS 7.2, which aligns to Red Hat Enterprise Linux version 7.2


See the full usage document here:

     11.2. SteelScript VM Configuration and Usage — steelscript  documentation

 

Links to the updated images:

 

OVA image - steelscript-vm-1.1-160902.ova (1.1 GB) (checksum)

VM Source Code - steelscript-vm-source-1.1-160902.tar.gz (1.7 GB) (checksum)


The source code for the complete virtual machine isn't necessary unless you'd like to peek at the components of the core OS.


See below for some Q&A's which should help get you started:

 

Q: What are the login credentials?

A: Once installed and running, the primary system login/password is vagrant/vagrant.  This password should work both via SSH as well as console access.  For the App Framework the default login/pasword is admin/admin.

 

Q: How do I access the App Framework?

A: Determine the IP address of the VM, and access it directly using port 80.

 

Q: I've gotten it installed and running, what now?

A: See the README file when you first login at /home/vagrant/README, it contains lots of good information including how to access the server, and important security considerations.

 

Q: How do I deploy using the "ovftool" command?

A: An example using the command line ovftool:


> ovftool --diskMode=thin --net:"nat"="VM Network" <OVAFILENAME>.ova  vi://<esxi host>

 

Q: When importing the OVA, I get an error of incompatible hardware?

A: See this post for a reported workaround: SteelScript running after Riverbed FORCE (help)

 

Q: How can I build my own VM from scratch?

A: This VM was built using a vagrant configuration, and everything has been posted to github: riverbed/steelscript-vm-config · GitHub

 

 

 

-----

Copyright (c) 2016 Riverbed Technology, Inc.

 

SteelScript VM is licensed under the terms and conditions of the MIT License accompanying the software ("License").  SteelScript VM is distributed "AS IS" as set forth in the License. SteelScript VM 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.

Wireshark is one of the most widely used open source projects. Being open source contributors ourselves, the SteelScript team is proud to announce the SteelScript-Wireshark plugin update!

 

What's new in this update

  • Understand the applications of the SteelScript-Wireshark with the new official SteelScript-Wireshark documentation
  • Quickly get setup with `steel install`, now including the SteelScript-Wireshark plugin
  • Leverage the clearer and more powerful SteelScript-Wireshark example scripts.
  • Start boosting your Wireshark productivity using the new SteelScript-Wireshark Getting Started guide

 

Check out the docs and get started with SteelScript-Wireshark!

 

We want your feedback

With each SteelScript plugin comes new possibilities. Let us know what features this plugin is missing! Post here on Splash, or open a GitHub issue with your feature request.

 

Have fun with this new wave of SteelScript-Wireshark functionality!

The SteelScript documentation just got a makeover. We are now using the super-clear, super-shiny Read the Docs theme. That means a persistent navigation sidebar, responsive UI, and clearer content.

 

ui_refresh.png

 

Documentation 2.0 Features

  • Persistent Navigation - The persistent sidebar displays a full table of contents. Never get lost again.
  • Responsive UI - When viewing SteelScript Docs on a small device, the navigation bar hides to put content first. No more wasted space on mobile.
  • Redesigned Styles - We gave our docs a true Riverbed feel with big orange highlights. It's easy on the eyes.

 

The documentation UI got a refresh and soon content is getting a refresh too! We have some great new tutorials coming down the pipeline, so stay tuned!

 

Click to View Documentation 2.0!

A small version of SteelScript-NetProfiler has just been posted, version 1.0.2.  Don't worry about the missing version 1.0.1 - we just skipped right past that one!

 

This minor version includes support for a new report type, HostTimeSeriesReport which provides a simple count of hosts seen over time.  We also fixed some bugs and had some minor cleanup.

 

If you have steelscript installed already, you can get the new version by running the command: steel install --upgrade.

 

We also included an example script in the package, so if you create a new workspace with 1.0.2 installed, you should see traffic_host_timeseries.py included.

 

For an example of how to get this example, see the following shell sequence:

 

> steel mkworkspace

...

> cd steelscript-workspace/netprofiler-examples

> python traffic_host_timeseries.py <<netprofiler host>> -u <<user>> -p <<password>> --timefilter="last 24 hour"

 

Time            Total Hosts

-------------------------------

1454860800.0    400

1454864400.0    400

1454868000.0    400

1454871600.0    400

1454875200.0    400

1454878800.0    400

1454882400.0    400

1454886000.0    400

1454889600.0    400

1454893200.0    400

1454896800.0    400

1454900400.0    400

1454904000.0    400

1454907600.0    400

1454911200.0    399

1454914800.0    400

1454918400.0    400

1454922000.0    400

1454925600.0    398

1454929200.0    400

1454932800.0    400

1454936400.0    400

1454940000.0    400

1454943600.0    400

Over the last few weeks we received a number of great ideas on the SteelScript ideas page.  Thanks to all the folks that took the time to put their ideas out there.


Now for the rest of you!  We need you to VOTE!  Step on over, browse the list of ideas and vote for the idea you would most like to see make it in to our next release of SteelScript.


The judges will factor in the community votes on this along with originality, creativity, applicability and feasibility. 


Let's choose the grand prize winner of $250!

What widgets would you add to the SteelScript Application Framework?

What would you automate with a Python script? Like the Shark Inventory Report?

 

Share your ideas by September 15 and get 250 points, a badge, a t-shirt, and a chance to win an easy $250 Visa gift card!

 

Learn more:

SteelScript Contest

Talks from the Boston Python Lightning Presentations night on Tuesday.  My quick 7-min talk on the FlyScript Portal is toward the end at 2:29:30.  Slides from my talk are attached.

 

Filter Blog

By date:
By tag: