User Tools

Site Tools


wiki:obsolete:lenny-complete-edition

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
wiki:obsolete:lenny-complete-edition [2010/03/11 09:06]
romy
wiki:obsolete:lenny-complete-edition [2013/03/12 20:02]
sunweaver removed
Line 1: Line 1:
-==== Installation ==== +~~NOTOC~~ 
-=== Adding the needed Debian Repository to your system ===+ 
 +<note warning>THIS PAGE IS OBSOLETE, DO NOT BELIEVE ITS CONTENT (ANYMORE)!!!</note> 
 + 
 +====== Installation ====== 
 +===== Adding the needed Debian Repository to your system =====
  
 To get started you'll need to configure your local system to access the official X2go Debian repository. Please keep in mind that this installation manual will guide you through the installation on a Debian Lenny system. The repository will offer you packages for i386, amd64 and powerpc architectures.  To get started you'll need to configure your local system to access the official X2go Debian repository. Please keep in mind that this installation manual will guide you through the installation on a Debian Lenny system. The repository will offer you packages for i386, amd64 and powerpc architectures. 
Line 45: Line 49:
 Congratulations, you are now able to access the x2go packages. You may continue by installing x2goclient, x2goserver-one or x2goserver. Congratulations, you are now able to access the x2go packages. You may continue by installing x2goclient, x2goserver-one or x2goserver.
  
-=== Installing X2goserver-ONE (One Node Edition) ===+===== Installing X2goserver-ONE (One Node Edition) =====
  
 X2goserver-ONE is a meta package which will install an x2goserver for a single host. This meta package will take care of configuring your system and you'll be able to use it after very short time. This “One Node Edition” fits perfectly inside virtual machines and on single PC's. An unlimited number of users can access this PC – but you won't be able to use multi server features like “load balancing”.  X2goserver-ONE is a meta package which will install an x2goserver for a single host. This meta package will take care of configuring your system and you'll be able to use it after very short time. This “One Node Edition” fits perfectly inside virtual machines and on single PC's. An unlimited number of users can access this PC – but you won't be able to use multi server features like “load balancing”. 
Line 66: Line 70:
 > If you would like to use the file system sharing option of X2go, you'll need to make sure that those users also are part of the posix group “fuse”. This membership is also needed by x2goprint. > If you would like to use the file system sharing option of X2go, you'll need to make sure that those users also are part of the posix group “fuse”. This membership is also needed by x2goprint.
  
-=== Installing x2goprint (low bandwith capable print service) ===+===== Installing x2goprint (low bandwith capable print service) =====
  
 :!: **Warning!** :!: **Warning!**
Line 86: Line 90:
 You may configure further options by editing the file “/etc/cups/cups-x2go.conf”.  You may configure further options by editing the file “/etc/cups/cups-x2go.conf”. 
  
-== Using X2goprint on a centralized cups server ==+==== Using X2goprint on a centralized cups server ====
  
 If you would like to run X2goserver and the cups service on different machines, you'll need to generate a pair of SSH keys. Please make sure that you are logged in as user “root” on the system running the cups service and add the following folders: If you would like to run X2goserver and the cups service on different machines, you'll need to generate a pair of SSH keys. Please make sure that you are logged in as user “root” on the system running the cups service and add the following folders:
Line 113: Line 117:
 </code> </code>
  
-=== Installing X2goserver (complete version)===+===== Installing X2goserver (complete version)=====
  
 If you would like to use the full featured version of x2goserver, you'll need to configure X2goserver by yourself. There are a lot of different possibilities to install X2goserver in a network of existing services. This manual will describe  the installation on clean and freshly installed systems. The full featured version of X2goserver is needed, if you are planing to use more than one server and those servers should be configured as a server group. This setup will need a PostgreSQL server to store X2go related session information. If you'll continue installation, you'll further need an LDAP server. You can start the installation by installing the base server package: If you would like to use the full featured version of x2goserver, you'll need to configure X2goserver by yourself. There are a lot of different possibilities to install X2goserver in a network of existing services. This manual will describe  the installation on clean and freshly installed systems. The full featured version of X2goserver is needed, if you are planing to use more than one server and those servers should be configured as a server group. This setup will need a PostgreSQL server to store X2go related session information. If you'll continue installation, you'll further need an LDAP server. You can start the installation by installing the base server package:
Line 127: Line 131:
 </code> </code>
  
-== Setting login permissions ==+==== Setting login permissions ====
  
 Please make sure that every user which should be able to log into the x2go system is part of the posix group “x2gousers”. You can add an user to the “x2gousers” group by executing following command: Please make sure that every user which should be able to log into the x2go system is part of the posix group “x2gousers”. You can add an user to the “x2gousers” group by executing following command:
Line 135: Line 139:
 </code> </code>
  
-== Configuriung the file sharing option ==+==== Configuriung the file sharing option ====
  
 If you would like to use the file sharing option of x2go, you'll need to install SSHFS: If you would like to use the file sharing option of x2go, you'll need to install SSHFS:
Line 145: Line 149:
 You will also need to check the permissions an add the selected users to the “fuse” group. You will also need to check the permissions an add the selected users to the “fuse” group.
  
-== Installing the database ==+==== Installing the database ====
  
 X2goserver will need a database to store session information. You'll only need one PostgreSQL server in your network to do this job. If you plan to run X2goserver and PostgreSQL on the same machine, you'll need to install PostgreSQL with the following command: X2goserver will need a database to store session information. You'll only need one PostgreSQL server in your network to do this job. If you plan to run X2goserver and PostgreSQL on the same machine, you'll need to install PostgreSQL with the following command:
Line 160: Line 164:
 </code> </code>
  
-== Using an existent database server on the network ==+==== Using an existent database server on the network ====
  
 If you want to use an already existent PostgreSQL database server in your network, you'll need to allow the x2goserver(s) access to the database server. If you want to use an already existent PostgreSQL database server in your network, you'll need to allow the x2goserver(s) access to the database server.
Line 190: Line 194:
 You'll also need to run the “x2gocreatebase.sh” script as described before on the database server to create the needed instance. You'll also need to run the “x2gocreatebase.sh” script as described before on the database server to create the needed instance.
  
-=== Installation of the LDAP Tools ===+===== Installation of the LDAP Tools =====
  
 :!: **Warning!** :!: **Warning!**
Line 206: Line 210:
 As a dependency, openldap will be installed, too. You may ignore any configuration dialogues during the installation. You'll build new configuration files during the configuration process. As a dependency, openldap will be installed, too. You may ignore any configuration dialogues during the installation. You'll build new configuration files during the configuration process.
  
-== Configuring name resolution ==+==== Configuring name resolution ====
  
 X2go uses the host name of the machines for identification. Please ensure that the command hostname, the env variable $HOSTNAME and other name resolution services return the same value: X2go uses the host name of the machines for identification. Please ensure that the command hostname, the env variable $HOSTNAME and other name resolution services return the same value:
Line 220: Line 224:
 </code> </code>
  
-== Installation of the samba schemata (optional) ==+==== Installation of the samba schemata (optional) ====
  
 If you would like to use the OpenLDAP server also to store samba accounts, you should install the smb extension. You may use the graphical x2go administration tools to administrate the smb groups and the boolean permission of an account to allow smb login. If you would like to use the OpenLDAP server also to store samba accounts, you should install the smb extension. You may use the graphical x2go administration tools to administrate the smb groups and the boolean permission of an account to allow smb login.
Line 231: Line 235:
 </code> </code>
  
-== Generate LDAP configuration ==+==== Generate LDAP configuration ====
  
 :!: **Warning!** :!: **Warning!**
Line 280: Line 284:
 </code> </code>
  
-== Generating SSL Certificates (for OpenLDAP) ==+==== Generating SSL Certificates (for OpenLDAP) ====
  
 Change into the script directory: Change into the script directory:
Line 349: Line 353:
 </code> </code>
  
-Some functionalities of the graphical administration modules require root priviliges. If you would like to use those commands without entering a password, you can avoid this by generating a pair of SSH keys:+Some functionalities of the graphical administration modules require root privileges. If you would like to use those commands without entering a password, you can avoid this by generating a pair of SSH keys:
  
 <code> <code>
Line 366: Line 370:
 </code> </code>
  
-=== Installing x2gothinclient (PXEBoot environment) ===+===== Installing x2gothinclient (PXEBoot environment) =====
  
 X2goclient can be used as a display manager. If you combine this feature with a boot environment, you'll get an easy manageable solution for your whole network. Please read the manual carefully, because some of the commands could harm your system if executed within the wrong context. The boot environment used by x2go will be able to recognize USB mass storage and CD-ROM devices automatically. Global preferences can be edited inside the KDE Control Center. You'll need 300 MB of free disk space for this installation. First of all you'll need the network services: X2goclient can be used as a display manager. If you combine this feature with a boot environment, you'll get an easy manageable solution for your whole network. Please read the manual carefully, because some of the commands could harm your system if executed within the wrong context. The boot environment used by x2go will be able to recognize USB mass storage and CD-ROM devices automatically. Global preferences can be edited inside the KDE Control Center. You'll need 300 MB of free disk space for this installation. First of all you'll need the network services:
Line 488: Line 492:
 </code> </code>
  
-== Configuration of DHCPD == +==== Configuration of DHCPD ====
  
 If you already have an DHCP server in your network, please make sure that you are able to setup an own range of IP addresses for the boot environment. Because of the conflict between devices that should access the boot environment and normal network nodes (MAC address binding), it is much easier to setup an own network for your thin client system. The following example assumes that you are running the DHCPD and the ATFTPD on the same system.  If you already have an DHCP server in your network, please make sure that you are able to setup an own range of IP addresses for the boot environment. Because of the conflict between devices that should access the boot environment and normal network nodes (MAC address binding), it is much easier to setup an own network for your thin client system. The following example assumes that you are running the DHCPD and the ATFTPD on the same system. 
Line 513: Line 517:
 </code> </code>
  
-== Setting up atftp ==+==== Setting up atftp ====
  
 After receiving a network address from the DHCP daemon, a kernel will be deployed using the tftp protocoll. For this purpose, you'll need to configure the **atftpd**, so that the kernel can be found. Please make sure, that **atftp** ist started by an init script and not via inet.d. After receiving a network address from the DHCP daemon, a kernel will be deployed using the tftp protocoll. For this purpose, you'll need to configure the **atftpd**, so that the kernel can be found. Please make sure, that **atftp** ist started by an init script and not via inet.d.
Line 561: Line 565:
 </file> </file>
  
-== Configuration of the NFS share ==+==== Configuration of the NFS share ====
  
 The root file system of the boot environment is mounted using NFS (so it can be accessed over the network). You'll need to export the needed directory by editing the NFS configuration file: The root file system of the boot environment is mounted using NFS (so it can be accessed over the network). You'll need to export the needed directory by editing the NFS configuration file:
Line 579: Line 583:
 </code> </code>
  
-== Configuration of x2goclient (display manager mode) ==+==== Configuration of x2goclient (display manager mode) ====
  
 Please also edit the command line options used by the x2goclient running in display manager mode (for example: change the IP address). Please also edit the command line options used by the x2goclient running in display manager mode (for example: change the IP address).