diff options
Diffstat (limited to 'docs/testers/howto.rst')
| -rw-r--r-- | docs/testers/howto.rst | 83 |
1 files changed, 15 insertions, 68 deletions
diff --git a/docs/testers/howto.rst b/docs/testers/howto.rst index e5bf1fa8..c4a928ed 100644 --- a/docs/testers/howto.rst +++ b/docs/testers/howto.rst @@ -21,81 +21,24 @@ Install dependencies ^^^^^^^^^^^^^^^^^^^^ First, install all the base dependencies plus git, virtualenv and development files needed to compile several extensions:: - apt-get install openvpn git-core libgnutls-dev python-dev python-qt4 python-setuptools python-virtualenv + apt-get install openvpn git-core python-dev python-qt4 python-setuptools python-virtualenv Bootstrap script ^^^^^^^^^^^^^^^^ -.. note:: getting latest version of this script. - - At some moment we will publish an url from where you can download this script. For now, you can copy and paste this. - .. note:: This will fetch the *develop* branch. If you want to test another branch, just change it in the line starting with *pip install...*. Alternatively, bug kali so she add an option branch to a decent script. .. note:: This script could make use of the after_install hook. Read http://pypi.python.org/pypi/virtualenv/ -Then copy and paste this script somewhere in your path, in the parent folder where you want your testing build to be downloaded. For instance, to `/tmp/leap_client_bootstrap`: +Download and source the following script in the parent folder where you want your testing build to be downloaded. For instance, to `/tmp/`: .. code-block:: bash - :linenos: - - #!/bin/bash - - # Installs requirements, and - # clones the latest leap-client - - # depends on: - # openvpn git-core libgnutls-dev python-dev python-qt4 python-setuptools python-virtualenv - - # Escape code - esc=`echo -en "\033"` - - # Set colors - cc_green="${esc}[0;32m" - cc_yellow="${esc}[0;33m" - cc_blue="${esc}[0;34m" - cc_red="${esc}[0;31m" - cc_normal=`echo -en "${esc}[m\017"` - - echo "${cc_yellow}" - echo "~~~~~~~~~~~~~~~~~~~~~~" - echo "LEAP " - echo "client bootstrapping " - echo "~~~~~~~~~~~~~~~~~~~~~~" - echo "" - echo "${cc_green}Creating virtualenv...${cc_normal}" - - mkdir leap-client-testbuild - virtualenv leap-client-testbuild - source leap-client-testbuild/bin/activate - - echo "${cc_green}Installing leap client...${cc_normal}" - # Clone latest git (develop branch) - # change "develop" for any other branch you want. - - - pip install -e 'git://leap.se/leap_client@develop#egg=leap-client' - - cd leap-client-testbuild - - # symlink the pyqt libraries to the system libs - ./src/leap-client/pkg/postmkvenv.sh - - echo "${cc_green}leap-client installed! =)" - echo "${cc_yellow}" - echo "Launch it with: " - echo "~~~~~~~~~~~~~~~~~~~~~~" - echo "bin/leap-client" - echo "~~~~~~~~~~~~~~~~~~~~~~" - echo "${cc_normal}" - -and then source it:: - - $ cd /tmp - $ source leap_client_bootstrap + cd /tmp + wget https://raw.github.com/leapcode/leap_client/develop/pkg/scripts/leap_client_bootstrap.sh + source leap_client_bootstrap.sh Tada! If everything went well, you should be able to run the client by typing:: @@ -115,17 +58,21 @@ from the directory where you *sourced* the bootstrap script. Refer to :ref:`Working with virtualenv <virtualenv>` to learn more about virtualenv. -Policy files -^^^^^^^^^^^^ +Copying config files +^^^^^^^^^^^^^^^^^^^^ + +If you have never installed the ``leap-client`` globally, **you need to copy some files to its proper path before running it for the first time** (you only need to do this once). This, unless the virtualenv-based operations, will need root permissions. See :ref:`copy script files <copyscriptfiles>` and :ref:`running openvpn without root privileges <policykit>` sections for more info on this. In short:: -If you have never installed the ``leap-client`` globally, **you need to copy a policykit file to its proper path before running it for the first time** (you only need to do this once). This, unless the virtualenv-based operations, will need root permissions. See :ref:`running openvpn without root privileges <policykit>` section for more info on this. + $ sudo cp pkg/linux/polkit/net.openvpn.gui.leap.policy /usr/share/polkit-1/actions/ + $ sudo mkdir -p /etc/leap + $ sudo cp pkg/linux/resolv-update /etc/leap -Config files -^^^^^^^^^^^^ +Local config files +^^^^^^^^^^^^^^^^^^^ If you want to start fresh without config files, just move them. In linux:: - $ mv ~/.config/leap ~/.config/leap.old + mv ~/.config/leap ~/.config/leap.old Pulling latest changes ^^^^^^^^^^^^^^^^^^^^^^ |