Marketcetera Linux Client Version 0.5.0 Installation Instruction

  1. The browser will prompt you to save the installation file. Save marketcetera-client-linux-0.5.0.tar.gz to your hard disk. Once the download is finished, untar + unzip the file to /opt directory:
    sudo tar -zxvf marketcetera-client-linux-0.5.0.tar.gz -C /opt
    
  2. Make sure the file is unzipped to /opt/marketcetera (you should see in that directory two sub-directories called photon and orderloader). If you use a different directory you will need to change configs in a few files (such as setEnv.sh and files in the photon/conf directory).
  3. To use Photon or OrderLoader which are included in this package you will need to connect to a running Order Routing Server (ORS) which is one of Marketcetera Server Components. Instructions of how to configure Photon to connect to ORS can be found here. Instructions of how to configure OrderLoader to connect to ORS can be found here.
  4. Start ORS and make sure it is running. Instructions on how to start ORS in the Windows Installer version can be found here and the VMWare appliance version can be found here

Running Photon

  1. To run Photon, open a console window, cd to /opt/marketcetera/photon and run the file called photon. NOTE: You need X-Windows and JRE 6.0 or later (as indicated in the Photon Installation and Configuration) installed on that machine to run Photon:
    > cd /opt/marketcetera/photon
    > ./photon
    
  2. When Photon starts, it'll ask you to log in to the ORS. The default user name is enduser and password is enduser_password. You can get more instructions on how to modify that if you want in the Authentication writeup.
    http://repo.marketcetera.org/images/screenshots/ors-login.png
  3. You can start trading against the Marketcetera Exchange Simulator

Note:

The Order Routing Server (ORS) must be running before Photon can connect and send any orders.

Running OrderLoader

You can use runOrderLoader.sh to bulk-load orders into the ORS. The runOrderLoader.sh command (in /opt/marketcetera/orderloader/bin) expects the following arguments:

%> runOrderLoader.sh 
Usage: java OrderLoader <CSV input file>

where CSV input file is the path to the input file.

The samples/ directory contains two sample CSV files of test orders. You can load the smaller order file this way:

%> runOrderLoader.sh ../samples/smallMarket.csv 

Where to go from here:

  • If you haven't read the Photon guide - this would be a good time to read it here.
  • You can check out the Photon scripting feature, our fast prototyping framework for developing algorithms.
  • You can register with Marketcetera to receive further updates

Don't forget to send us your feedback or questions or use our issue tracking system to report bugs or suggest features.