First PPS Download

We check out the source and data repository and build for the first time

1. Open a Terminal.
2. Create a folder for yourself on the local harddrive:

   mkdir /scratch/<your-username> 
   cd /scratch/<your-username>
   

3. Create your orxonox directory:

   mkdir orxonox && cd orxonox
   

4. Check out the latest revision of the data repository

   svn co http://svn.orxonox.net/game/data/data_extern
   

   4.1 Open a new terminal tab, to work in parallel.

   Press Control + Shift + T
   

   4.2 Check out the latest revision of the code

   svn co http://svn.orxonox.net/game/code/trunk trunk
   

   4.3 While you wait, open another terminal tab, download additional dependencies

   mkdir dependencies && cd dependencies
   svn co http://svn.orxonox.net/downloads/ogre_src_v1-9-0
   cd ..
   

5. Wait for all processes to finish

6. Prepare to build.

6.1 Make sure you are in the right folder. The ls command should give show the following folders:

data_extern  dependencies  trunk

6.2 Configure the build process

mkdir build && cd build
cmake ../trunk

7. Now build for the first time (may take some time, further builds will be faster):

   make -j4
   

   The -j4 means to create 4 parallel compile processes.

Start the game for the first time

8. Start the game. You will see a menu popping up, just press the Quickstart button.

   ./run
   

Sign up for Orxonox LDAP

In order to be able to commit your changes to a branch, you will need an orxonox LDAP account.

The assistants will have set up an account for you, using your <nethz> username and an automatically generated safe password.

To reset the password, go to "Lost Password" and click on "Email" on the top left. Enter your <nethz> name as "Login" and <nethz>@ee.ethz.ch as "Mail". An email will be sent to you with a link to reset your password.

You will be prompted for this password when committing to your branch (if it has been checked out with https).

Download your own branch

We check out the project branch and build it

1. Open a Terminal.
2. You should now have access to the orxonox storage account:

   cd /itet-stor/<your-username>/orxonox/<your-username>
   

3. Create your orxonox directory:

   mkdir orxonox && cd orxonox
   

4. Now check out the latest revision of the data repository (you will probably be asked for a username and password once):

   svn co https://svn.orxonox.net/game/data/data_extern
   

   4.1 Open a new terminal tab, to work in parallel.

   Press Control + Shift + T.
   

   4.2 Now checkout your project branch:

   svn co https://svn.orxonox.net/game/code/branches/<your-branchname>
   

4.3 While you wait, open another terminal tab, download and unzip additional dependencies:

mkdir dependencies && cd dependencies
svn co https://svn.orxonox.net/downloads/ogre_src_v1-9-0
cd ..

5. Wait for both branches to check out completely.

6. Prepare to build:

   mkdir build && cd build
   cmake ../<your-branchname>
   

7. Now build for the first time (may take some time, further builds will be faster):

   make -j4
   

   The -j4 means to create 4 parallel compile processes.

Start the game for the first time

8. Start the game. You will see a menu popping up, just press the Quickstart button.

   ./run