From Scratch

Alright. You have a fresh install based on instructions here depending on your OS. From here on out, the OS should not matter.

If you are a developer, check out the specific Helpful Tips page for some little tricks you can do as a powerful code wizard.

Ok. Open up OCCAM in a web-browser. From here, we will create an account. Press "sign up" at the top right and enter in a username and a password. From here, we will want to import a simulator.

Make sure you have at least one occam-worker running in the background. The occam-worker is the actual program that does the work of installing and building the objects.

Click 'import' at the top-left once you have logged in. To import DRAMSim2, put this in as the url:

https://bitbucket.org/occam/occam-simulator-dramsim2

And press the button. You should get a page describing DRAMSim2 and you can press 'Install'. Now you will be on the DRAMSim2 landing page. The occam-worker should now be doing its work. The first thing it does is creates a directory inside of "occam-web" called "occam/objects/dramsim2" where it puts the occam scripts and eventually pulls in the source for DRAMSim2. The second thing occam-worker does is builds a vm image with a working copy of DRAMSim2.

Once occam-worker has successfully done both install and build, it will be available. Go to your user profile (click on your username at the top-right) and create a workset. Type in some name and press enter and you should go to the workset page. From here, scroll down to Groups, which should be empty at this point, and type in a group and press enter.

From within the group, you can now create and organize experiments. Press the "Build from Configuration Range" button. This gives you a form to create a set of experiments. Let's look at sweeping the JEDEC_DATA_BUS_BITS configuration parameter. In that field, type "64 to 512" and press "Create" at the bottom of the form.

This should create 8 experiments in this group. Now you can press "Run All" and the occam-worker will spawn jobs to run DRAMSim2 within our VM on each of the 8 configurations and save the eventual results in the group. When you refresh the group page, you'll see the experiments complete in turn. You can press "Results" to see the data and "New Graph" to bring up a graph builder.