New versions of Market Runner are released every two or three weeks. Generally, they include changes to the API which may or may not prevent your existing strategies from running. We recommend upgrading your local copy of Market Runner regularly.

There is unfortunately no easy way to upgrade Market Runner. Being used as a programming library, it makes it hard to automate the process.

Upgrade Process

The exact update process will depend on how your code has been organized, but the safest way is to start from the new Eclipse project provided with the Market Runner bundle.

• Follow the instructions in our page on installing Market Runner for the first time. You should end up with a fresh install of Market Runner in a new directory.
• From the directory of your previous Eclipse project (MarketRunner/eclipse/MyStrategies/src, if you haven't changed the names), copy your strategies' source files into the new MarketRunner/eclipse/MyStrategies/src directory.
  • Take care not to copy the old samples along. This won't have serious effects, but you might overwrite the newer samples and get compilation errors that you would then need to fix manually yourself.
• Open Eclipse. At this point, you might get compilation errors. In general, the API is backward-compatible; however, we occasionally remove obsolete methods. This is a good time to change your code.
• Check out any warning provided by Eclipse. This would warn you if methods that you are currently using have been marked deprecated, making them candidates for future removal.
• Finally, review the changes listed on the Download page and check if there are any new feature you might want to integrate in your strategies.

More details

The instructions are virtually the same for any IDE. The essential points are that you must:

• update the libraries: replace the existing libraries with those from the MarketRunner/eclipse/MyStrategies/libs directory, and update your classpath
• update the market data: overwrite the existing market data with files from the MarketRunner/eclipse/MyStrategies/marketData directory