3644
Kommentar:
|
← Revision 13 vom 2012-07-28 23:47:25 ⇥
6671
|
Gelöschter Text ist auf diese Art markiert. | Hinzugefügter Text ist auf diese Art markiert. |
Zeile 3: | Zeile 3: |
This page describes the installation of the [http://cryptobox.org CryptoBox server] from sources in a openSUSE 10.2 environment. The server-package is primarily built for Debian but the source package also works in other Linux distributions. Unfortunately you have to fulfil some dependencies manually, which takes a bit more time. | This page describes the installation of the [[http://cryptobox.org|CryptoBox server]] from the sources. The source package should be installable in many modern Linux distributions. Unfortunately you have to fulfil some dependencies manually, which might take a while. |
Zeile 5: | Zeile 5: |
[[TableOfContents]] | We have described two ways of installation. One for openSUSE 10.2 and another for Debian/etch (4.0). If you installed a !CryptoBox server in any other Linux distribution, pleas leave a comment about your experience or extend this site. <<TableOfContents>> |
Zeile 11: | Zeile 13: |
* In the same way you have to install ''util-linux-crypto''. * This package contains a program called cryptsetup, which mainly does the encryption work. * It is important, that cryptsetup includes support for [[http://luks.endorphin.org/|LUKS]]. This is the case in openSUSE 10.2. * Add a new user to your system e.g.: ''cryptobox''. With the rights of this user the CryptoBox will later run. * Do all the following steps as this user. Sometimes you need root rights. You can use the ''su'' and giving the root passphrase command for that. |
|
Zeile 13: | Zeile 19: |
* Download the latest [http://download.cherrypy.org/cherrypy/2.2.1/ CherryPy version from the 2.2 branch] (here: 2.2.1) to ''/tmp'' and unpack and install it with the following commands: {{{ | * Download the latest [[http://download.cherrypy.org/cherrypy/2.2.1/|CherryPy version from the 2.2 branch]] (here: 2.2.1) to ''/tmp'' and unpack and install it with the following commands: {{{ |
Zeile 17: | Zeile 24: |
python setup.py install | su -c "python setup.py install" |
Zeile 19: | Zeile 26: |
Zeile 21: | Zeile 27: |
* Download the latest [http://www.clearsilver.net/downloads/clearsilver-0.10.5.tar.gz ClearSilver Source Release] (here: 0.10.5) to ''/tmp'' and install it with the following commands: {{{ | * Download the latest [[http://www.clearsilver.net/downloads/clearsilver-0.10.5.tar.gz|ClearSilver Source Release]] (here: 0.10.5) to ''/tmp'' and install it with the following commands: {{{ |
Zeile 25: | Zeile 32: |
./configure --prefix=/usr --diable-java --diable-perl --disable-csharp --disable-ruby --disable-apache --enable-gettext --with-python=/usr/bin/python | ./configure --prefix=/usr --disable-java --disable-perl --disable-csharp --disable-ruby --disable-apache --enable-gettext --with-python=/usr/bin/python |
Zeile 27: | Zeile 34: |
make install | su -c "make install" |
Zeile 29: | Zeile 36: |
Zeile 31: | Zeile 37: |
* Download the [ftp://ftp.ucolick.org/pub/users/will/ latest version of "super"] (here 3.27.1) and install it. This allows to run the !CryptoBox with a non-root uid. {{{ | * Download the [[ftp://ftp.ucolick.org/pub/users/will/|latest version of "super"]] (here 3.27.1) and install it. This allows to run the !CryptoBox with a non-root uid. {{{ |
Zeile 36: | Zeile 43: |
make install | su -c "make install" |
Zeile 38: | Zeile 45: |
* This installs super to ''/usr/local/bin/super''. You have to change the corresponding path in the cryptobox.conf file. * The correct configfile in this case is ''/usr/local/etc/super.tab'' - not ''/etc/super.tab''. This is important as you later have to add a line to this configfile. |
|
Zeile 40: | Zeile 48: |
* Download a [http://packman.links2linux.de/package/python-configobj python-configobj.rpm] file from the packman openSUSE repository and install it with: {{{ rpm -i python-configobj-4.4.0-0.pm.1.i586.rpm |
* Install ''python-configobj'' via yast if you have the packamn repository in your rpm database. * Otherwise download an actual [[http://packman.links2linux.de/package/python-configobj|python-configobj.rpm]] file from the packman openSUSE repository and install it with: {{{ su -c "rpm -i python-configobj-4.4.0-0.pm.1.i586.rpm" |
Zeile 43: | Zeile 53: |
== cryptsetup == * TODO: install cryptsetup == CryptoBox == * Puh after that you at least know the magic spell (''./configure && make && make install'') to install source packages and the Python way of installing software (''python setup.py install''). * Now you're ready to get the latest [http://codecoop.org/frs/download.php/120/cryptobox-server_0.3.4.4-1.tar.gz CryptoBox server sources] (here 0.3.4.4-1) from codecoop and unpack it:{{{ |
== Python M2Crypto == * Install ''python-m2crypto'' via yast if you have the openSUSE development repository in your rpm database. * Otherwise download an actual [[http://ftp.opensuse.org/pub/opensuse/repositories/devel:/languages:/python/openSUSE_10.2/i586/python-m2crypto-0.17-1.1.i586.rpm|python-m2crypto.rpm]] (here 0.17) and install: {{{ su -c "rpm -i python-m2crypto-0.17-1.1.i586.rpm" }}} == CryptoBox server == * Puh, after that you at least learned the magic spell (''./configure && make && make install'') to install source packages and the Python way of installing software (''python setup.py install''). * Now you're ready to get the latest [[http://codecoop.org/frs/download.php/120/cryptobox-server_0.3.4.4-1.tar.gz|CryptoBox server sources]] (here 0.3.4.4-1) from codecoop and unpack it: {{{ |
Zeile 53: | Zeile 66: |
python setup.py install | su -c "python setup.py install" |
Zeile 55: | Zeile 68: |
* TODO | * Copy the ''conf-examples/super.tab-example'' to ''/usr/local/etc/super.tab'' (depends on your super installation) and modify it to your needs. * Now you should be able to start the CryptoBox server by running: {{{ ./bin/run_webserver.sh }}} * Do that as user ''cryptobox'' not as root. * The command returns some infromation about the server. One line should look like this "INFO Serving HTTP on http://localhost:8080/". This means you did it. * If there are any error messages read them carefully. There's most likely some of the dependent software missing. Fix it and start the run_webserver script again. * Did you install every tool as described? Did you configure ''super'' correctly? * Now, visit the printed url (here: http://localhost:8080) with your webbrowser. You'll see the !CryptoBox webinterface. Congratulations! * The webinterface will complain about some things. |
Zeile 58: | Zeile 80: |
* To have a complete working !CryptoBox server you need some additional software which is probably already installed on your server. | * To have a complete working !CryptoBox server you need some additional software which is probably already installed on your server otherwise install them. |
Zeile 63: | Zeile 85: |
* If you need further help take a look into the [[http://devel.cryptobox.org/wiki/CryptoBoxUser/en|CryptoBox user documentation]]. | |
Zeile 68: | Zeile 91: |
* If you for whatever reasons don't want to use the [http://codecoop.org/frs/?group_id=60&release_id=69 CryptoBox server Debian package], you need some preparations to use the source package or the code from the svn. {{{ apt-get install python python-central python-clearsilver python-cherrypy python-configobj python-m2crypto super cryptsetup e2fsprogs dosfstools |
* If you for whatever reasons don't want to use the [[http://codecoop.org/frs/?group_id=60&release_id=69|CryptoBox server Debian package]] (our recommendation), you need some preparations to use the source package or the code from the svn. {{{ apt-get install python python-central python-clearsilver python-cherrypy python-configobj python-m2crypto super cryptsetup |
Zeile 71: | Zeile 94: |
== CryptoBox == * Get the sources, unpack and install them the Python way {{{ |
== CryptoBox server == * Get the sources, unpack and install them the Python way {{{ |
Zeile 77: | Zeile 101: |
python setup.py install | su -c "python setup.py install" |
Zeile 79: | Zeile 103: |
* Edit ''/etc/super.tab'' like described in ''conf-examples/super.tab-example''. * Start the !CryptoBox with: {{{ ./bin/run_webserver.sh }}} * Read the messages, if there's no error take a look at "http://localhost:8080". You're up and ready. |
|
Zeile 81: | Zeile 111: |
apt-get install samba, apache2, stunnel4 | apt-get install samba stunnel4 e2fsprogs dosfstools |
Zeile 83: | Zeile 113: |
* If you need further help take a look into the [[http://devel.cryptobox.org/wiki/CryptoBoxUser/en|CryptoBox user documentation]]. |
This page describes the installation of the CryptoBox server from the sources. The source package should be installable in many modern Linux distributions. Unfortunately you have to fulfil some dependencies manually, which might take a while.
We have described two ways of installation. One for openSUSE 10.2 and another for Debian/etch (4.0). If you installed a CryptoBox server in any other Linux distribution, pleas leave a comment about your experience or extend this site.
Inhaltsverzeichnis
CryptoBox server in openSUSE 10.2
Preparation
Install the packages python-devel und gcc via yast. They are in the main openSUSE repository.
These two packages are just needed to install the CryptoBox dependent software and can be removed afterwards.
In the same way you have to install util-linux-crypto.
- This package contains a program called cryptsetup, which mainly does the encryption work.
It is important, that cryptsetup includes support for LUKS. This is the case in openSUSE 10.2.
Add a new user to your system e.g.: cryptobox. With the rights of this user the CryptoBox will later run.
Do all the following steps as this user. Sometimes you need root rights. You can use the su and giving the root passphrase command for that.
CherryPy 2.2
Download the latest CherryPy version from the 2.2 branch (here: 2.2.1) to /tmp and unpack and install it with the following commands:
cd /tmp tar zxf CherryPy-2.2.1.tar.gz cd CherryPy-2.2.1 su -c "python setup.py install"
Python Clearsilver
Download the latest ClearSilver Source Release (here: 0.10.5) to /tmp and install it with the following commands:
cd /tmp tar zxf clearsilver-0.10.5.tar.gz cd clearsilver-0.10.5 ./configure --prefix=/usr --disable-java --disable-perl --disable-csharp --disable-ruby --disable-apache --enable-gettext --with-python=/usr/bin/python make su -c "make install"
super
Download the latest version of "super" (here 3.27.1) and install it. This allows to run the CryptoBox with a non-root uid.
cd /tmp tar zxf super_3.27.1.orig.tar.gz ./configure make su -c "make install"
This installs super to /usr/local/bin/super. You have to change the corresponding path in the cryptobox.conf file.
The correct configfile in this case is /usr/local/etc/super.tab - not /etc/super.tab. This is important as you later have to add a line to this configfile.
Python ConfigObj
Install python-configobj via yast if you have the packamn repository in your rpm database.
Otherwise download an actual python-configobj.rpm file from the packman openSUSE repository and install it with:
su -c "rpm -i python-configobj-4.4.0-0.pm.1.i586.rpm"
Python M2Crypto
Install python-m2crypto via yast if you have the openSUSE development repository in your rpm database.
Otherwise download an actual python-m2crypto.rpm (here 0.17) and install:
su -c "rpm -i python-m2crypto-0.17-1.1.i586.rpm"
CryptoBox server
Puh, after that you at least learned the magic spell (./configure && make && make install) to install source packages and the Python way of installing software (python setup.py install).
Now you're ready to get the latest CryptoBox server sources (here 0.3.4.4-1) from codecoop and unpack it:
cd /tmp tar zxf cryptobox-server_0.3.4.4-1.tar.gz cd cryptobox-server_0.3.4.4-1 su -c "python setup.py install"
Copy the conf-examples/super.tab-example to /usr/local/etc/super.tab (depends on your super installation) and modify it to your needs.
Now you should be able to start the CryptoBox server by running:
./bin/run_webserver.sh
Do that as user cryptobox not as root.
The command returns some infromation about the server. One line should look like this "INFO Serving HTTP on http://localhost:8080/". This means you did it.
- If there are any error messages read them carefully. There's most likely some of the dependent software missing. Fix it and start the run_webserver script again.
Did you install every tool as described? Did you configure super correctly?
Now, visit the printed url (here: http://localhost:8080) with your webbrowser. You'll see the CryptoBox webinterface. Congratulations!
- The webinterface will complain about some things.
Finalization
To have a complete working CryptoBox server you need some additional software which is probably already installed on your server otherwise install them.
- samba
- stunnel4
- e2fsprogs
- dosfstools
If you need further help take a look into the CryptoBox user documentation.
CryptoBox server in Debian/etch
Preparation
If you for whatever reasons don't want to use the CryptoBox server Debian package (our recommendation), you need some preparations to use the source package or the code from the svn.
apt-get install python python-central python-clearsilver python-cherrypy python-configobj python-m2crypto super cryptsetup
CryptoBox server
- Get the sources, unpack and install them the Python way
cd /tmp wget http://codecoop.org/frs/download.php/120/cryptobox-server_0.3.4.4-1.tar.gz tar zxf cryptobox-server_0.3.4.4-1.tar.gz cd cryptobox-server_0.3.4.4-1 su -c "python setup.py install"
Edit /etc/super.tab like described in conf-examples/super.tab-example.
Start the CryptoBox with:
./bin/run_webserver.sh
Read the messages, if there's no error take a look at "http://localhost:8080". You're up and ready.
Finalization
Finally install some more useful software.
apt-get install samba stunnel4 e2fsprogs dosfstools
If you need further help take a look into the CryptoBox user documentation.