The STARFISH Parallel file-system simulator (Simulation Tool for Advanced Research in File Systems) David Kotz Dartmouth College Version 2.0 January 1995 STARFISH is a simulator for experimenting with concepts in parallel file systems. It is based on Eric Brewer's Proteus simulator from MIT, and runs only on (MIPS-based) DECstations. I have used this simulator in experiments for several research papers about disk-directed I/O, and am actively extending it and using it for further experiments. This package can be found via ftp at cs.dartmouth.edu in pub/pario/STARFISH via the WWW at https://www.cs.dartmouth.edu/~kotz/STARFISH/ although that web page just points to that ftp directory. WARNING: -------- I AM PROVIDING THE CODE AS-IS, WITH LITTLE CLEANUP OR ADDED DOCUMENTATION. SOME OF THE CODE IS OUT-OF-DATE AND HAS BUGS. OTHER PARTS ARE INCOMPLETE. MANY OF THE ANALYSIS SCRIPTS ARE FRAGILE. THE CODE IS CONSTANTLY EVOLVING, AND NEW PUBLIC RELEASES MAY BE RARE. See other warnings in the src/README file. USAGE RULES: ------------ You're welcome to look at the code and even try to run it, but I really don't have time to help you out much. If you publish any results based on this simulator, please cite me and provide the URL where people can find this code. COPYING RULES: -------------- This package may be freely copied as long as it is kept intact with my name on it. Please send me a note if you have a copy of this code, so I can keep track of how many copies there are, send you email about new versions, and so forth. Please ask me before you distribute any modified version. Other software you need: ------------------------ This package is based on Proteus version 3.01. You can get that from ftp to mintaka.lcs.mit.edu:/pub/brewer in proteus-V3.01.tar.Z. I have fixed several bugs in the 'stats' program; I supply a MIPS executable of the fixed program, and the patches needed to make my version from the original Eric Brewer sources. You can find those sources at the same ftp site, although I'm not sure that the ftable sources are identical to the version I picked up. If it's a big deal let me know and I'll make a new patch file. Related papers: see ./PAPERS.bib --------------- OSDI NOTE: ---------- The code included here has evolved since the experiments in some of those papers were run; in particular, the OSDI results are based on an earlier, buggier version of iopfs-cache. See the TR version of that paper for correct results. WHAT YOU CAN GET: ---------------- src.tar.Z: Sources (1.4 MB, 3.6 MB uncompressed): - starfish/README - starfish/bin (some new or changed executables from proteus) - starfish/PAPERS.bib (bibtex for related papers) - starfish/proteus (the proteus engine code, with my changes) - starfish/src (the source code, and compilation director) - starfish/stats.patch (patches to proteus 'stats' program) figs.tar.Z: Paper figures (0.1 MB, 0.6 MB uncompressed): - starfish/README - starfish/figs (figures and data from the kotz:jdiskdir paper) run.tar.Z: Experimental configurations and raw data (36 MB, 94 MB uncompressed): - starfish/README - starfish/run (the place where experiments are run) (This file is not available for ftp, until I find more disk space.) (Contact me or look on the Web page if you want this file.) THE NAME: --------- The name STARFISH is an acronym, but it fits with the maritime theme of the Proteus simulator on which it is based (Proteus was a Greek god of the sea), and of the FLEET lab, where we hope to implement some of the ideas which were developed using the STARFISH simulator. dmcache: You may note references to 'dmcache' in several places. ------- That's the old name for this simulator. David Kotz Assistant Professor Department of Computer Science Dartmouth College 6211 Sudikoff Laboratory Hanover, NH 03755-3510 USA email: dfk@cs.dartmouth.edu URL: https://www.cs.dartmouth.edu/~kotz/ 603-646-1439