Skip to content

Instructions for testers

Christian Mayer edited this page Apr 26, 2015 · 5 revisions

For developers:

Please confer development workflow about the mode of interaction.

For testers:

Deutsch:

Instruktionen für die Installation auf dem WireGate (andere Plattformen laufen ähnlich, werden aber nicht explizit erwähnt): http://www.cometvisu.org/wiki/CometVisu/HowTo:_Entwicklerversion_auf_dem_WireGate

English:

Installation:

When you want to participate in testing the code, the relevant instructions to get the code and stay current are as follows:

  • Please create an GitHub account (of course it is possible to download and test the CometVisu without having a GitHub account. But your ability to give feedback would be limited then - and the account is free.)
  • Please fork the CometVisu to your own account (there's a "Fork" button on the top right of the page)
  • Then have a look at your page in the CometVisu repository. There's a field named HTTPS clone URL on the right side of the page. Please copy the URL shown there.
  • Go to the terminal of your machine in the web directory (e.g. by cd /var/www)
  • Run the command
    git clone https://github.com/<Accountname>/CometVisu.git CometVisuGit
    where https://github.com/<Accountname>/CometVisu.git is the URL you have copied just above.
  • Then add the main repository as upstream:
    git remote add upstream https://github.com/CometVisu/CometVisu.git
  • To make it easily accessible in the browser, run:
    ln -s CometVisuGitSVN/trunk/src visu_git
  • To use all features a few file permissions must be updated:
    chmod a+rw /var/www/visu_git/config/visu_config.xml
    chmod a+rw /var/www/visu_git/config/backup
    chmod a+rw /var/www/visu_git/config/visu_config_previewtemp.xml

Congratulations! Your CometVisu installation is now available under the address: http://<your_box>/visu_git/

Updates:

After the successful installation you want to keep up with the development, of course. To understand a bit of the background, you should read the development workflow.

To get the latest updates from the main repository just call
git fetch
To switch to a different development branch you can use
git checkout <branchname>
(don't forget to replace <branchname> by the desired branch name)

To update local changes from you to the main repository please check them into your fork and then create a pull request for the development branch of the main repository (CometVisu/CometVisu).
Please read the necessary instructions for that in your favourite Git documentation. But to give you a hint, the necessary commands will be around
git add .
git commit
git push

Important

Please also check the instructions at HowTo: Entwicklerversion auf dem WireGate


Please also have a look at the manual (http://www.cometvisu.org/wiki/CometVisu).