SUSHI Tools & Other Aids

SUSHIStarters client from JISC
The SUSHIStarters client is a 'beginners', free, open source programme with a web-based user interface to support the downloading/retrieval of COUNTER-compliant SUSHI reports. The SUSHI client consists of a series of web-forms and guidance notes that 'walk' users through the steps and parameters needed to connect successfully to the SUSHI servers and download the reports of a number of major vendors. The client is configurable to make it possible to extend the range of included vendors over time. Installation and usage procedures for the client have been kept simple and documented to ensure its widest possible use. The SUSHIStarters code is available from

MISO: Serials Solutions' Open-Source Code for SUSHI Client
Supporting NISO's Standard Usage Statistics Harvesting Initiative Protocol (, the Serials Solutions open source SUSHI client code will enable libraries to build consistent, stable, and standards-based tools. It is the first release of what the maintenance committee hopes will be many open source toolkits for libraries.

Content providers must implement SUSHI by the end of August 2009 in order to remain compliant with Release 3 of the COUNTER Code of Practice for Journals and Databases. Libraries or content providers interested in the Serials Solutions open source SUSHI client can access the code at See the full press release here.

EBSCO's SUSHI Software Development Kit (SDK): Open-Source Code for SUSHI Server and Client
This SUSHI SDK (software development kit), from EBSCOs developer Richard Carruthers, is now available on Google Code and is available for use under the new BSD license. The project description is: "This SDK includes .Net classes that will facilitate working with COUNTER 3.0 data and SUSHI 1.6 services. Whether the intended solution is a SUSHI client or server, these classes will provide the groundwork to allow developers to focus on the logic rather than implementing the standard."
The package contains documentation, source code, a sample client, and a sample server.  As the documentation suggests, the sample client is "the simplest of samples" - it does basic request and viewing of a COUNTER report and does not have the validation and error handling provided by the MISO client (see below).
The sample server allows pre-formatted COUNTER reports to be delivered from a folder (it works with the MISO client).  While the sample server is not intended to be used as a production tool, the source code does provide a framework that should help with more rapid development of a production server.

Open Source Functional Testing Tool for SUSHI Servers 
SoapUI by SmartBear, a free Open Source Functional Testing tool for APIs, offers a quick and easy way to test SUSHI servers.  This tool can act as a simple SUSHI client to provide an effective means to test and troubleshoot a SUSHI Server.  SoapUI can also be used to “rapidly create and execute automated functional, regression, compliance, and load tests.”

SUSHI Harvester for Consortia
The SUSHI Harvester for Consortia is a free Microsoft Access application from EBSCO that leverages the MISO SUSHI client (see above) to help consortia automate gathering their COUNTER compliant usage statistics. With SUSHI Harvester a consortium can: organize the usage-related details of their content providers and consortium members; and, harvest all consortium members usage reports from a content provider with a single click of a button. A zip file containing the SUSHI Harvester and documentation is available for download here.

Understanding Infrastructure: Dynamics, Tensions, and Design
This NSF final report of the workshop, "History and Theory of Infrastructure: Lessons for New Scientific Cyberinfrastructures" creates a nice big context (and some handy vocabulary, too) for standards efforts such as SUSHI.

COUNTER-Compliant Vendors
With Release 3 of COUNTER, compliance with COUNTER also requires the ability to send reports via SUSHI. The deadline for compliance with Release 3 was August 31, 2009. The Release 3 COUNTER-compliant vendors list hosted at COUNTER will therefore also indicate those vendors who have implemented and are compliant with SUSHI.

Stepwise Guide to COUNTER Compliance
This guide is designed to take content providers step-by-step through the process of becoming COUNTER compliant.