Differences between revisions 16 and 18 (spanning 2 versions)
Revision 16 as of 2008-01-05 12:39:57
Size: 9048
Comment: sorry tmp save
Revision 18 as of 2008-01-05 20:10:12
Size: 9553
Comment: add Debian Edu section
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:


= CipUX Installation 3.4.x for plain Debian =
= CipUX Installation 3.4.x for DebiaEdu =
Line 17: Line 15:
Choose a fresh installed DebianEdu (Etch/Lenny)

(1)

edit /etc/apt/sources.list

add:
{{{
 deb http://debiantest.cipux.org/ sid main
}}}

Type this commands:
 * aptitude install cipux-common
 * aptitude install cipux-ldap
 * aptitude install cipux-object
 * aptitude install cipux-task
 * /usr/sbin/cipux_setup -svnD 129
 * vim /etc/etc/pam_ldap.conf
 * vim /etc/libnss-ldap.conf
 * aptitude install cipux-rpc
 *


= CipUX Installation 3.4.x for plain Debian =

{{{
This is under development for now. Do not install on productive systems,
as long this remark is here.
}}}
Line 73: Line 101:
Question 2 (libnss-ldap) Question 3 (libnss-ldap)
Line 86: Line 114:
 Question 3 (libnss-ldap)  Question 4 (libnss-ldap)
Line 99: Line 127:
Question 7 (libnss-ldap) Question 5 (libnss-ldap)
Line 116: Line 144:
Question 8 (libnss-ldap) Question 6 (libnss-ldap)
Line 132: Line 160:
 Question 5 (libpam-ldap)  Question 7 (libpam-ldap)
Line 153: Line 181:
 Question 4 (libpam-ldap)  Question 8 (libpam-ldap)
Line 169: Line 197:
Questin ? (libpam-ldap) Questin 9 (libpam-ldap)
Line 186: Line 214:
Question ? (libpam-ldap) Question 10 (libpam-ldap)
Line 202: Line 230:
 #* mv /etc/nsswich.conf /etc/nsswich.conf.orig
 #* cp /usr/share/doc/libnss-ldap/examples/nsswitch.ldap etc/nsswich.conf


{{{
Add "ldap" to the following services in /etc/nsswitch.conf

passwd: compat ldap
group: compat ldap
shadow: compat ldap
#netgroup: nis
netgroup: files ldap
}}}


 * /usr/share/cipux/sbin/cipux_setup -s
 * aptitude install cipux-rpc cipux-cat-web
 * /etc/init.d/apache2 restart
 * browse to https://localhost/cipux-cat-web/

Add "ldap" and "files" to the following services in /etc/nsswitch.conf
and comment out "compat"

{{{

passwd: files ldap
group: files ldap
shadow: files ldap
netgroup: files ldap
automount: files ldap
# passwd: compat
# group: compat
# shadow: compat

}}}

 * /etc/init.d/nscd restart
 * /usr/sbin/cipux_setup -svnD 129
 * aptitude install cipux-rpc
 * cipux_rpc_test_client (give cipadmin and password)
 * aptitude install cipux-cat-web
 * browse to http://localhost/cipux-cat-web/
Line 222: Line 254:
Line 226: Line 259:
For a French school:

 * aptitude install cipux-common cipux-cibot cipux-profile
 * /usr/share/cipux/sbin/cipux_setup -sp cipux_profile_fr_school
 * aptitude install cipux-rpc cipux-cat-web



= CipUX Automatic Setup 3.4.x =

= CipUX Automatic Setup 3.4.x (TODO) =

CipUX

Installtion of CipUX

?TableOfContents

?Navigation(children,5)

CipUX Installation 3.4.x for DebiaEdu

This is under development for now. Do not install on productive systems, 
as long this remark is here.

Choose a fresh installed DebianEdu (Etch/Lenny)

(1)

edit /etc/apt/sources.list

add:

 deb http://debiantest.cipux.org/ sid main

Type this commands:

  • aptitude install cipux-common
  • aptitude install cipux-ldap
  • aptitude install cipux-object
  • aptitude install cipux-task
  • /usr/sbin/cipux_setup -svnD 129
  • vim /etc/etc/pam_ldap.conf
  • vim /etc/libnss-ldap.conf
  • aptitude install cipux-rpc

CipUX Installation 3.4.x for plain Debian

This is under development for now. Do not install on productive systems, 
as long this remark is here.

Choose a fresh installed Debian (Etch) with hostname cipux340 and domain name example.net (!!!).

(1)

edit /etc/apt/sources.list

comment out something like this:

# deb cdrom:[Debian GNU/Linux 4.0 r2 _Etch_ - Offical i386 NETINST Binary-1 20080103-00:44]/ etch contrib main

add:

 deb http://debiantest.cipux.org/ sid main

(2)

Type this commands:

  • unset http_proxy (or set it correctly)
  • aptitude update
  • aptitude install cipux-common

{{{ Question 1 (Configuring slapd) Please enter the password for the admin entry in your LDAP directory.

Admin password:

By default: empty

Correct answer: (choose one and remember it!) }}}

  • aptitude install cipux-ldap

Question 2 (libnss-ldap)

Please enter the URI of the LDAP server used. This is a string in the form ldap://<hostname or IP>:<port>/ . ldaps:// or ldapi:// can also be used. The port number is optional.

Note: It is usually a good idea to use an IP address; this reduces risks of failure in the event name service is unavailable.

LDAP server Uniform Resource Identifier

By default:     ldapi:///

Correct answer: ldap://127.0.0.1

Question 3 (libnss-ldap)

Please enter the distinguished name of the LDAP search base. Many sites use the components of their domain names for this purpose. For example, the domain "example.net" would use "dc=example,dc=net" as the distinguished name of the search base.

distinguished name of the search base

By default:     dc=example.net,dc=net

Correct answer: dc=example.net,dc=net

 Question 4 (libnss-ldap)

Please enter which version of the LDAP protocol ldapns is to use. It is usually a good idea to set this to highest available version number.

LDAP version to use

By default: 2 or 3

Correct answer: 3

Question 5 (libnss-ldap)

This account will be used for nss requests with root privileges.

Note: For this to work the account needs permission to access the attributes in the LDAP directory that are related to the users

shadow entries as well as users' and groups' passwords.

LDAP account for root

By default: cn=manager,dc=example,dc=net

Correct answer: cn=admin,dc=example,dc=net

Question 6 (libnss-ldap)

Bitte geben sie das Passwort ein, das verwendet wird, wenn libnss-ldap sich mit dem LDAP-Zugang fuer root am LDAP-Verzeichnis anmeldet. 

Das Passwort wird in einer eigenene Datei /etc/libnss-ldap.secret gespeichert, die nur fuer root lesbar ist.

Beleibt das Passwort leer, wird das alte Passwort wieder benutzt.

Passwort des LDAP-Zugangs fuer Root:

by default: empty
correct answer: (use password from above)

 Question 7 (libpam-ldap)

This option will allow you to make password utilities that use pam, to 
behave like you would be changing local passwords.

The password will be stored in a sepereate file which will be made 
readable to root only. 

If you are using NFS mounted /etc or any other custom setup, you should 
disable this.

Make local root Datatbase admin.

By default: YES  (YES or NO)

Correct answer: YES

 Question 8 (libpam-ldap) 

Choose this option if you can't retrieve entries from the datatbase
without logging in.

Note: Under normal setup, this not needed.

Does the LDAP database require login?

By default: NO  (YES or NO)

Correct answer: NO

Questin 9 (libpam-ldap)

This account will be used when root changes a password.

Note: This account has to be a privileged account. 

LDAP account for root:

By default: cn=manager,dc=example,dc=net

Correct answer: cn=admin,dc=example,dc=net

Question 10 (libpam-ldap)

Please enter the password for the admin entry in your LDAP directory.

Admin password:

By default: empty

Correct answer: (choose one and remember it!)
  • aptitude install cipux-object
  • aptitude install cipux-task

Add "ldap" and "files" to the following services in /etc/nsswitch.conf and comment out "compat"

passwd:         files ldap
group:          files ldap
shadow:         files ldap
netgroup:       files ldap
automount:      files ldap
# passwd:         compat
# group:          compat
# shadow:         compat
  • /etc/init.d/nscd restart
  • /usr/sbin/cipux_setup -svnD 129
  • aptitude install cipux-rpc
  • cipux_rpc_test_client (give cipadmin and password)
  • aptitude install cipux-cat-web
  • browse to http://localhost/cipux-cat-web/

  • login as "cipadmin" (password was given during installation)

Remarks:

  • aptitude install ... leads to a warning message as the buildserver does not sign its packages with a gpg key

CipUX Automatic Setup 3.4.x (TODO)

This chapter is intended for integrators or developers who would like to deploy CipUX on their distribution or LiveCD. So this page contains several methods to install CipUX.

apt-getting debs

You can fetch the debian packages of cipux from last svn-revision with the following entry in your sources list. Every half hour, the packages are build if there was any commit to svn-repository, so here you will get the very latest ones. This location is also available by browser via http://debiantest.cipux.org

 deb http://debiantest.cipux.org/ sid main

Get the package list

  • aptitude update

Setup process description

  • The first setup is done via the package cipux-cibot Within the package cipux-cibot a script can be found to add
  • administrator
  • schema
  • ACL
  • PAM
  • add default CipUX objects
  • add default CipUX values
  • move some object if necessary
  • delete some objects if necessary (it is a good idea to install also cipux-common and cipux-profile for that)

Attended installation procedure

  • see CipUX installation above

Unattended installation procedure

  • (1) add the following files
    • mkdir -p /etc/cipux; chmod 700 /etc/cipux; chown root:root /etc/cipux;
    • echo -n "secret" > /etc/cipux/ldappassword.conf (cipuxadm password)

    • chmod 400 /etc/cipux/ldappassword.conf
    • chown root:root /etc/cipux/ldappassword.conf
    • echo -n "DISTRIBUTION" > /etc/cipux/system.conf (distribution: debian, debian-edu, ...)

    • chmod 400 /etc/cipux/system.conf
    • chown root:root /etc/cipux/system.conf
  • (2) aptitude install cipux-common cipux-cibot cipux-profile
  • (3) /usr/share/cipux/sbin/cipux_setup -sn
  • (4) aptitude install cipux-rpc cipux-cat-webim

Remarks:

  • Profile:
  • install cipux-profile BEFORE running cipux_setup
  • run: /usr/share/cipux/sbin/cipux_setup -sn -p PROFILE
  • list of supported profiles can be get with:
    • ls /usr/share/cipux/sbin/cipux_profile_*
  • if there is no profile suitable for you, create one.
  • if you have created one, please share that with the community. System:
  • supported distributions for now are:
  • example: echo -n "debian" > /etc/cipux/system.conf

Customization for (jet) unsupported Distributions

  • get in contact with one of:
  • join #cipux
  • add a customer in /etc/cipux/customer.conf
  • add a customer to cipux.conf
  • probably change LDAP values in cipux.conf
  • check all pathes for executables
  • check LPREF variable in top level Makefile
  • do test it on fresh installed systems

Other CipUX Installation Guides

Installation guides for different Debian and Debian-Edu/Skolelinux releases. For Updates please read the [:DebianEdu/CipUX/Update:update page].

On Debian (Etch) , Debian-Edu/ Skolelinux 3.0

  • This, page: see above

Older installation guides

Debian-Edu/ Skolelinux 1.0 (Venus)

?Navigation(siblings,1)