About: This readme is intended to be used as a quick getting-started guide for using Stream Mill Miner (SMM) virtual machine. For detailed documentations please visit SMM's official site at http://wis.cs.ucla.edu/wis/stream-mill/. Quick getting started guide: 0) Stream Mill consists of a client and a server. To install the server, one can install a Linux virtual machine which already has the server pre-installed. Alternatively, if one already has linux installed, then we also provide a binary package which only contains the server. Installing server from a binary package (32-bit Linux): 1) Download SMMbin.tar, unpack and run "./install" Installing server from a VM 1) Download SMM_VM.tar from http://yellowstone.cs.ucla.edu/~nlaptev/StreamMillServer.tar. To run the VM you will need to install VM player, or VirtualBox (both free). 2) Launch the VM and login as training/training 2aFAQ) To run our VM from VMWare Player simply double click on Ubuntu.vmx and open it with VMWare Player. To run our VM from VirtualBox, follow the same instructions as you would when installing a new operating system. Select Linux/Ubuntu as the operating system type and version. DO NOT select any hard disks when prompted. Select settings of the new OS and click on storage. Add IDE storage by selecting "Ubuntu.vmdk" as the virtual disk. Running SMM: 1) Download http://yellowstone.cs.ucla.edu/~nlaptev/StreamMill.tar and untar it. 2) The client requires Java 1.6 to run. 3) Before launching the client, modify the "StreamServer" properties in StreamMill.properties to correspond to the IP of your VM. 4) Launch the client with command "java -jar StreamMill.jar" 5) Switch to the location of the server and go to bin directory (/home/training/bin) 6) Launch the server with command "./esl_start -p 5455" which will start the SMM server on port 5455 7) Let's now create a simple stream query. First we need to create a user by going into User->Create New User option. 8) Let's create a simple stream. In the text box type: stream traffic(speed int, station int) source 'port5678'; and the click create stream(s) 9) Lastly, create a query that will call the mining model by entering the following and clicking create->querie(s) select speed from traffic; 10) Now, go to view->stream(s) and view->querie(s) and activate the stream and query we created. 11) Once activated, click on the monitoring engine window by selecting view->Monitoring Engine. 12) Activate the last query in the "unactivated" box by right clicking and selecting activate->TextViewer. 13) Start a new shell. If VM is used, then click "alt->F2" to switch to a new session. Login as before and cd into /home/training/bin/ios 14) Now let's send input data to our query and see the output in the monitoring engine. Type "./ss.pl YOURUSERNAME__traffic localhost 5678 1 1" Notes: a) This is a single-user version. If you want to erase all declarations you have created, cd to the bin directory and type "rm __*" which will remove tables, streams, and your user account you created.