Revision 5073 (by k4x-guest, 2010/10/30 12:12:26) typo
 
                       CipUX Konsolen HOWTO
                       ====================

            Hier beschreiben wir die CipUX Konsolen Befehle
            -----------------------------------------------

                  (C) 2009-01-26 Kurt Gramlich     v0.1
                  (C) 2009-01-27 Christian Kuelker v0.2
                  (C) 2009-02-11 Christian Kuelker v0.3
                  (C) 2009-02-13 Kurt Gramlich     v0.4
                  (C) 2009-02-22 Christian Kuelker v0.5
                  (C) 2009-02-22 Kurt Gramlich     v0.6
                  (C) 2009-02-22 Kurt Gramlich     v0.7
                  (C) 2009-03-13 Christian Kuelekr v0.8
                  (C) 2009-08-02 Kurt Gramlich     v0.9
                  (C) 2009-08-14 Kurt Gramlich     v1.0
                  (C) 2009-09-03 Christian Kuelker v1.1
                  (C) 2009-09-28 Kurt Gramlich     v1.2
                  (C) 2009-09-28 Kurt Gramlich     v1.3
                  (C) 2009-09-29 Kurt Gramlich     v1.4
                  (C) 2009-10-30 Kurt Gramlich     v1.5


Inhalt
======

 0 Einleitung
 1 Wie aendere ich das cipadmin Passwort?
 2 Wie mache ich jemanden zum Studenten unter Debian Edu/ Skolelinux?
 3 Wie mache ich jemanden zum Schueler unter Debian Edu/ Skolelinux?
 4 Wer hat einen Admin-Account?
 5 Wer ist der Rolle der Admins zugeordnet?
 6 Wie schaffe ich einen Admin-Account?
 7 Wie liste ich alle Nachnamen und Vornamen der Admin-Accounts?
 8 Wie loesche ich einen Admin-Account?
 9 Wie liste ich alle Student-Account?
10 Wie lege ich einen Student-Account an?
10a Wie lege ich einen Student-Account mit Angabe von Vor- und Nachnamen an?
11 Wie liste ich alle Nachnamen und Vornamen der Student-Accounts?
12 Wie loesche ich einen Student-Account?
13 Wie liste ich alle Teacher-Account?
14 Wie schaffe ich einen Teacher-Account?
15 Wie liste ich alle Nachnamen und Vornamen der Teacher-Accounts?
16 Wie loesche ich einen Teacher-Account?
17 Wie liste ich alle User-Account?
18 Wie setze ich ein Passwort?
18a Wie aendere ich ein Passwort?
19 Wie lasse ich alle vorhandenen Rollen anzeigen?
20 Wie kann ich nach einem Befehl suchen?
21 Welche Module sind registiert?
22 Welche CAT-WEB-Module gibt es noch, die nicht registriert sind?
23 Wie kann ich ein Module registrieren und einschalten?
24 Gibt es eine Manpage fuer CAT-WEB-Module?
25 Wie sehe ich, welche Shares bereits vorhanden sind?
26 Wie lege ich eine Klasse an?
26a Wie ordne ich einen Student-Account einer Klasse zu?
27 Wie loesche ich eine Klasse?
28 Wie sperre ich den Internetzugang fuer einen User?
29 Wie sperre ich den Internetzugang fuer eine ganze Klasse?
30 Wie lege ich einen Raum an?
31 Welche Raeume sind bereits angelegt?
32 Wie loesche ich einen Raum?
33 Wie schalte ich fuer Lehrer/-innen das student Modul frei?
34 Wie schalte ich fuer Lehrer/-innen das role_assignment Modul frei?
35 Wie schalte ich fuer Lehrer/-innen das role_class_assignment Modul frei?
36 Wie schalte ich fuer Lehrer/-innen das teacher Modul frei?
37 Wie liste ich netgroups auf?
38 Wie liste ich die workstation-hosts auf?
39 Wie nehme ich einen Rechner dhcp156 in die netgroup workstation-hosts auf?
40 Wie finde ich alle task Kommandos, die mit netgroup zu tun haben?

Allgemeine Hinweise:
--------------------

* Alle Kommdos, solange nicht anders vermerkt, werden als 'root' auf der
  Kommandozeile (xterm, konsole, ...) ausgefuehrt.

* Ein Backslash "\" in einer Zeile bedeutet, dass diese Zeile fortgefuehrt
  wird. Entweder kann man dieses Zeichen mit eingeben oder man vereint die
  aktuelle mit der folgenden Zeile zu einer langen Zeile. Dieses Zeichen wird
  in dieser Anleitung verwendet, weil dieses Dokument einen Zeichenbegrenzung
  von 78 Zeichen hat um die Lesbarkeit zu verbessern.


0 Einleitung
------------

Dieser Text beschreibt die Komanndos, die man auf der Konsole benutzen kann,
um CipUX zu steuern und zu konfigurieren. Die meisten der Befehle, die CipUX
versteht, sind sogenannte 'Task' Befehle. Diese werden zuerst vorgestellt,
weil sie die oberste Ebene der Befehle darstellen um auf die CipUX Datenbank
zuzugreifen. Daneben gibt es nicht weniger wichtige Befehle fuer
ausgesprochene Spezialaufgaben, wie z.B. CAT Module verwalten.



1 Wie aendere ich das cipadmin Passwort?
----------------------------------------

cipux_task_client -t \
cipux_task_change_admin_account_password -o cipadmin -x value=test


2 Wie mache ich jemanden zum Studenten unter Debian Edu/ Skolelinux?
-------------------------------------------------------------------

cipux_task_client -t \
cipux_task_add_member_to_role_account -o students -x value=LoginName


3 Wie mache ich jemanden zum Schueler unter Debian Edu/ Skolelinux?
-------------------------------------------------------------------

Da die Rolle 'pupils' unter Debian Edu/ Skolelinux nicht existiert, muss man
einen Schueler zu einem Studenten machen. Man muss ihn also der Rolle
'students' zuordnen. Siehe 'Wie mache ich jemanden zum Studenten unter Debian
Edu/ Skolelinux?'


4 Wer hat einen Admin-Account?
------------------------------

cipux_task_client -t \
cipux_task_list_admin_accounts


5 Wer ist der Rolle der Admins zugeordnet?
------------------------------------------

cipux_task_client -t \
cipux_task_list_members_of_role_account -o admins


6 Wie schaffe ich einen Admin-Account?
--------------------------------------

cipux_task_client -t \
cipux_task_create_admin_account -o LoginName


7 Wie liste ich alle Nachnamen und Vornamen der Admin-Accounts?
---------------------------------------------------------------
cipux_task_client -t \
cipux_task_retrieve_all_admin_account_lastname_firstname


8 Wie loesche ich einen Admin-Account?
--------------------------------------

cipux_task_client -t \
cipux_task_destroy_admin_account -o LoginName


9 Wie liste ich alle Student-Account?
-------------------------------------

cipux_task_client -t \
cipux_task_list_student_accounts


10 Wie lege ich einen Student-Account an?
-----------------------------------------

cipux_task_client -t \
cipux_task_create_student_account -o LoginName

10a Wie lege ich einen Student-Account mit Angabe von Vor- und Nachnamen an?
---------------------------------------------------------------------------

cipux_task_client -t \
cipux_task_create_student_account -o dummy0815 \
-x cipuxFirstname=Otto -x cipuxLastname=Meier

11 Wie liste ich alle Nachnamen und Vornamen der Student-Accounts?
------------------------------------------------------------------
cipux_task_client -t \
cipux_task_retrieve_all_student_account_lastname_firstname


12 Wie loesche ich einen Student-Account?
-----------------------------------------

cipux_task_client -t \
cipux_task_destroy_student_account -o LoginName


13 Wie liste ich alle Teacher-Account?
-------------------------------------

cipux_task_client -t \
cipux_task_list_teacher_accounts


14 Wie schaffe ich einen Teacher-Account?
-----------------------------------------

cipux_task_client -t \
cipux_task_create_teacher_account -o LoginName


15 Wie liste ich alle Nachnamen und Vornamen der Teacher-Accounts?
------------------------------------------------------------------

cipux_task_client -t \
cipux_task_retrieve_all_teacher_account_lastname_firstname


16 Wie loesche ich einen Teacher-Account?
-----------------------------------------

cipux_task_client -t \
cipux_task_destroy_teacher_account -o LoginName


17 Wie liste ich alle User-Account?
-------------------------------------

cipux_task_client -t \
cipux_task_list_user_accounts


18 Wie aendere ich ein Passwort?
-------------------------------

cipux_task_client -t \
cipux_task_change_student_account_password -o Loginname -x value=SuperGeheim

Hierbei wird das neue Passwort ohne Nachfrage gesetzt.


18a  Wie aendere ich ein Passwort?
_________________________________

cipux_task_client -t \
cipux_task_change_user_account_password_on_command_line -o hemeier
Enter new password:
Enter same password again:


19 Wie lasse ich alle vorhandenen Rollen anzeigen?
--------------------------------------------------

cipux_task_client -t \
cipux_task_list_role_accounts


20 Wie kann ich nach einem Befehl suchen?
-----------------------------------------

Wenn ich ein Stichwort angebe, sucht der folgende Befehl nach allen
Kommandos, in denen das Stichwort vorkommt.

 cipux_task_client -l <STICHWORT>

Hier einige Beispiele:

 cipux_task_client -l lastname
 cipux_task_client -l line
 cipux_task_client -l name
 cipux_task_client -l role

Wenn ich nun aber nach allen Kommandos suchen will die 'tasks' behandeln?

 cipux_task_client -l | egrep -e 'task$'

listet alle 'task' Kommandos mit dem Wort 'task' am Ende auf.

 cipux_task_add_member_to_task
 ...


21 Welche Module sind registiert?
---------------------------------

cipux_cat_web_module --list-registered


22 Welche CAT-WEB-Module gibt es noch, die nicht registriert sind?
------------------------------------------------------------------

Das folgende Kommando zeigt die nicht registrierten Module an:

cipux_cat_web_module --list-deregistered


23 Wie kann ich ein Module registrieren und einschalten?
---------------------------------------------------------

Das folgende Kommando registriert das class.cgi Modul, schaltet es ein und
stellt es den Angehoerigen der Rolle Admins zur Verfuegung. Wichtig ist dabei,
mit der UID www-data zu arbeiten, damit die damit angelegten Dateien dem User
www-data gehören:

su -l www-data -c 'cipux_cat_web_module --register -o class.cgi \
--enable --add-member admins'

Ein weiteres Beispiel mit dem Objekt class_assignment:

su -l www-data -c 'cipux_cat_web_module --register -o class_assignment.cgi \
--enable --add-member admins'


24 Gibt es eine Manpage fuer CAT-WEB-Module?
--------------------------------------------

Ja, das folgende Kommando gibt eine Beschreibung,
wie cipux_cat_web_module zu benutzen ist.

man cipux_cat_web_module


25 Wie sehe ich, welche Shares bereits vorhanden sind?
------------------------------------------------------

cipux_task_client -t cipux_task_list_class_shares


26 Wie lege ich eine Klasse an?
-------------------------------

Das folgende Kommando legt eine Klasse als sogenanntes Share an:

cipux_task_client -t \
cipux_task_create_class_share -o 2009a --password pwpwpw


26a Wie ordne ich einen Student-Account einer Klasse zu?
--------------------------------------------------------

cipux_task_client -t \
cipux_task_add_member_to_class_share -o 2009f -x value=dummy0815


27 Wie loesche ich eine Klasse?
-------------------------------

Das folgende Kommando legt eine Klasse als sogenanntes Share an:

cipux_task_client -t \
cipux_task_destroy_class_share -o 2009a

Das Homeverzeichnis wird dabei nicht geloescht. Es muss bei Bedarf noch
manuell geloescht werden.


28 Wie sperre ich den Internetzugang fuer einen User?
-----------------------------------------------------

cipux_task_client -t \
cipux_task_add_member_to_role_account -o no-internet -x value=LoginName


29 Wie sperre ich den Internetzugang fuer eine ganze Klasse?
------------------------------------------------------------

cipux_task_client -t \
cipux_task_add_member_to_role_account -o no-internet -x value=2009a


30 Wie lege ich einen Raum an?
------------------------------

cipux_task_client -t \
cipux_task_create_room -o Besenkammer


31 Welche Raeume sind bereits angelegt?
---------------------------------------

cipux_task_client -t \
cipux_task_list_rooms


32 Wie loesche ich einen Raum?
------------------------------

cipux_task_client -t \
cipux_task_destroy_room -o Besenkammer


33 Wie schalte ich fuer Lehrer/-innen das student Modul frei?
-------------------------------------------------------------

Wenn ein Lehrer das Passwort eines Schuelers neu setzten will, benoetigt er
Zugriff auf das student Modul. Mit dem folgenden Kommando wird das student
Modul fuer alle Mitglieder der Gruppe teachers nutzbar:

cipux_task_client -t \
cipux_task_add_member_to_cat_module -o student.cgi -x value=teachers


34 Wie schalte ich fuer Lehrer/-innen das role_assignment Modul frei?
---------------------------------------------------------------------

cipux_task_client -t \
cipux_task_add_member_to_cat_module -o role_assignment.cgi -x value=teachers



35 Wie schalte ich fuer Lehrer/-innen das role_class_assignment Modul frei?
---------------------------------------------------------------------

cipux_task_client -t \
cipux_task_add_member_to_cat_module -o role_class_assignment.cgi \
-x value=teachers


36 Wie schalte ich fuer Lehrer/-innen das teacher Modul frei?
-------------------------------------------------------------

cipux_task_client -t \
cipux_task_add_member_to_cat_module -o teacher.cgi -x value=teachers


37 Wie liste ich netgroups auf?
_______________________________

cipux_task_client -t \
cipux_task_list_netgroups


38 Wie liste ich die workstation-hosts auf?
___________________________________________

cipux_task_client -t \
cipux_task_list_clients_of_netgroup -o workstation-hosts


39 Wie nehme ich einen Rechner dhcp156 in die netgroup workstation-hosts auf?
_____________________________________________________________________________

cipux_task_client -t \
cipux_task_addmodify_all_clients_of_netgroup -o workstation-hosts -x \
value=nisNetgroupTriple='(dhcp156,-,-)'


40 Wie finde ich alle task Kommandos, die mit netgroup zu tun haben?
____________________________________________________________________

cipux_task_client -l netgroup









--------------------------
# vim:set ai textwidth=78: