cipux_storage_clientp - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

cipux_storage_client - Befehlszeilenschnittstelle zur CipUX-Speicherabstraktionsschicht

VERSION

Version 3.4.0.2

ANWENDUNG

(1) cipux_storage_client -h
(2) cipux_storage_client [OPT] -t get_value -s -Ö -y [-y ]
(3) cipux_storage_client [OPT] -t get_all_values ​​-s -y [-y ]
(4) cipux_storage_client [OPT] -t set_value [-r] -s -Ö -y -v
cipux_storage_client [OPT] -t set_value -a -s -Ö -y -v
cipux_storage_client [OPT] -t set_value [-r] -s -Ö -y [-y ]
cipux_storage_client [OPT] -t set_value -a -s -Ö -y [-y ]
cipux_storage_client [OPT] -t set_value -d -s -Ö -y [-y ]
cipux_storage_client [OPT] -t set_value -e -s -Ö -y
(5) cipux_storage_client [OPT] -t set_all_values ​​[-r] -s -y -v
cipux_storage_client [OPT] -t set_all_values ​​-a -s -y -v
cipux_storage_client [OPT] -t set_all_values ​​[-r] -s -y [-y ]
cipux_storage_client [OPT] -t set_all_values ​​-a -s -y [-y ]
cipux_storage_client [OPT] -t set_all_values ​​-d -s -y [-y ]
(6) cipux_storage_client [OPT] -t add_node -s -Ö -x [-x ]
(7) cipux_storage_client [OPT] -t delete_node -s -Ö
(8) cipux_storage_client [OPT] -t rename_node -s -Ö -v
Abkürzungen: OBJ = OBJEKT, ATTR = ATTRIBUTE, VAL = WERT, OPT = OPTIONEN

OPTIONAL

Optionen für alle Befehle:

-c | --cfg: cipux-storage-access.conf
-D | --debug [ ] : Debug-Meldungen für Entwickler drucken
-h | --help : Hilfe ausgeben (diese Nachricht + Optionen)
-p | --pretty: schöne Boxed-Ausgabe
-V | --version : Nur Druckversion
--verbose : mehr Nachrichten drucken

Optionen für einige Befehle:

-a | --add : eher einen Wert hinzufügen, dann ersetzen
-d | --del : lösche den Wert des Attributs
-e | --erase: lösche das Attribut
-l | --list : listet Konfigurationsbereiche auf, kann für --type . verwendet werden
-o | --object : LDAP-Objektblatt
-r | --replace : einen Wert ersetzen, Standardverhalten
-s | --storage_type : Konfigurationstyp
-t | --storage_task : auszuführende Aktion
-v | --value : einzustellender Wert
-x | --mattrvalue : mehrere LDAP-Attribute, siehe Beschreibung
-y | --attrvalue : LDAP-Attribut, siehe Beschreibung

ERFORDERLICH ARGUMENTE

cipux_storage_client

-t oder -h

cipux_storage_client -t get_value

-S
-Ö
-y

cipux_storage_client -t get_all_values

-S
-y

cipux_storage_client -t set_value

-S
-Ö
-y

cipux_storage_client -t set_all_values

-S
-y
-v

cipux_storage_client -t add_node

-S
-Ö
-x

cipux_storage_client -t delete_node

-S
-Ö

cipux_storage_client -t rename_node

-S
-Ö
-v

BESCHREIBUNG OF OPTIONAL

-a Wie Option --add.

--hinzufügen
Dadurch wird nach Möglichkeit ein Wert hinzugefügt, anstatt einen Wert zu ersetzen.

--attrvalue
Dies kann verwendet werden, um das Attribut anzugeben durch

--attrvalue

Oder es kann verwendet werden, um das Attribut und den Wert anzugeben

--attrvalue =

Natürlich kann es auch zusammen mit der Option --value verwendet werden, um das Attribut anzugeben und
der Wert wie folgt:

--attrvalue --Wert

-D Wie Option --debug.

-d Wie Option --del.

--del
Dadurch wird das Attribut nach Möglichkeit aus dem Objekt gelöscht.

-e Wie Option --erase

--löschen
Löscht das LDAP-Attribut eines bestimmten Objekts. Dadurch werden auch alle Inhalte von . gelöscht
dieses Attribut. Wenn ein Objekt mehrere Werte für dieses Attribut hat, alle Werte
wird entfernt. Wenn diese Option gesetzt ist, löst sie --delete command line . aus
Option automatisch.

-h Wie Option --help

--help
Druckt eine kurze Hilfenachricht.

--mattrvalue
Diese Option muss verwendet werden, wenn ein LDAP-Objekt erstellt werden soll. Im Gegensatz zu --attrvalue
diese Option erfordert immer ein Attribut und einen Wert. Daher ist nur diese Syntax
möglich:

--mattrvalue =

Der Grund dafür ist, dem Benutzer genaue Hinweise geben zu können, wenn er versucht, ein
Objekt, aber vergessen Sie den Wert.

Das 'm' steht für multiple. Es ist also möglich, die Option mehrmals zu vergeben.

-o Wie Option --object

--Objekt
Diese Option wird verwendet, um das Objekt anzugeben, für das der Befehl ausgeführt wird. Machen
sicher wählen Sie das richtige Objekt. Dies wird natürlich auch fehlschlagen, wenn das Objekt nicht ist
abrufbar mit (in der Objektliste von) --storage_type.

-p Wie Option --pretty.

--ziemlich
Bei Befehlen, die eine Ausgabe erzeugen, kann diese Option verwendet werden, um eine schicke Box herum zu zeichnen
die Ausgabe.

-r Wie Option --replace.

--ersetzen
Für einige Befehle ist dies die Standardoption. Es ersetzt den Wert eines gegebenen Attributs
mit neuem Wert.

-s Gleich wie Option --storage_type.

--storage_task
Name für die Aktion, die ausgeführt werden kann. Gültige Aktionen sind:

get_all_values
set_all_values
add_node
Wert erhalten
set_value
Liste
Knoten löschen
umbenennen_knoten

--Speichertyp
Diese Option definiert den 'Typ des Objekts', mit dem der Befehl arbeitet. Eine Art von
object' ist eine bestimmte Menge von Objekten mit gemeinsamen Attributen. Zum Beispiel alle POSIX
Kontoobjekte bzw. In der Konfigurationsdatei können Sie ganz einfach neue Objekttypen definieren.
Der Standardspeicherort dieser Datei ist /etc/cipux/cipux-storage-structure.conf.

-t Wie --storage_task.

-V Wie Option --version.

--Version
Druckt die Version und wird beendet.

- ausführlich
Nicht implementierter Jet.

-l Wie Option --list

--aufführen
Listet alle Objektbereiche auf. Die Objektbereiche sind aus der Konfigurationsdatei rot. Die
Der Standardspeicherort der Konfigurationsdatei ist /usr/share/cipux/etc/cipux-storage.perl.
Für die Option --storage_type wird ein Objekttyp benötigt.

-v Wie Option --verbose.

--Wert
Bei einigen Befehlen wird dies verwendet, um einen Wert für ein Objekt oder ein Attribut bereitzustellen.

-x Gleich wie Option --mattrvalue.

-y Wie Option --attrvalue.

BESCHREIBUNG

Dies ist der Befehlszeilen-Client für CipUX::Storage. Es kann verwendet werden, um zu ändern oder zu löschen
CipUX-Speicherobjekte.

BEFEHLE

cipux_storage_client -t get_value
cipux_storage_client -t set_value
cipux_storage_client -t get_all_values
cipux_storage_client -t set_all_values
cipux_storage_client -t add_node
cipux_storage_client -t rename_node
cipux_storage_client -t delete_node

cipux_storage_client -t Wert erhalten
Rufen Sie einen oder mehrere LDAP-Werte für jedes gegebene Attribut eines gegebenen Objekts ab.

cipux_storage_client -t get_all_values
Rufen Sie einen oder mehrere LDAP-Werte für jedes gegebene Attribut aller Objekte in einem gegebenen ab
Objekttyp.

cipux_storage_client -t set_value
(1) Sie können Werte mit cipux_storage_client -t set_value hinzufügen.

cipux_storage_client -t set_value -s all_group_node -e memberUid -o testgroup -v login -a

Dies macht jedoch nur einen Unterschied für LDAP-Attribute, die mehrmals vorhanden sein können.

cipux_storage_client -t set_value -s all_group_node -e memberUid -o testgroup -v login1 -a
cipux_storage_client -t set_value -s all_group_node -e memberUid -o testgroup -v login2 -a

Daraus ergibt sich:

MitgliedsUId: login1
MitgliedsUId: login2

Wobei die folgenden Zeilen ein anderes Ergebnis haben:

cipux_storage_client -t set_value -s all_group_node -e groupType -o testgruppe -v public -a

Die resultierende Ausnahme:

Attribut 'groupType' darf nicht mehrere Werte in ./cipux_storage_client -t set_value Zeile 369 haben

In diesem Fall müssen Sie die Option -a aus Ihrer Zeile entfernen oder -r verwenden.

(2) Das Standardverhalten ist das Ersetzen von Werten. Werte können ersetzt werden durch:

cipux_storage_client -t set_value -s all_group_node -e groupType -o testgruppe -v privat

or

cipux_storage_client -t set_value -s all_group_node -e groupType -o testgruppe -v private -r

Dadurch wird der vorhandene Wert durch den neuen ersetzt.

Aber seien Sie sich bewusst (!), wenn Sie 3 Mitglieder in einer Gruppe haben, zum Beispiel:

MitgliedsUId: login1
MitgliedsUId: login2
MitgliedsUId: login3

nach dem Befehl der Befehl:

cipux_storage_client -t set_value -s all_group_node -e memberUid -o testgroup -v login4

Sie haben nur ein Mitglied!

MitgliedsUId: login4

Daher besteht das Standardverhalten darin, alle Werte bis auf einen zu ersetzen. Das Ersetzen und nicht das Hinzufügen
ist das Standardverhalten, da es mehr einzelne Attribute in LDAP gibt und daher
die Ausfallwahrscheinlichkeit ist geringer, wenn Ersetzen das Standardverhalten ist.

(3) Auch LDAP-Attribute können gelöscht werden. Wenn Sie 2 MemberUids haben, zum Beispiel das Löschen
Betrieb führt zu einer Ausnahme:

modifizieren/löschen: memberUid: kein solcher Wert in ./cipux_storage_client -t set_value Zeile 369

Um alle (!) Mitglieder zu löschen, müssen Sie also zwei LDAP-Operationen durchführen:

cipux_storage_client -t set_value -s all_group_node -e memberUid -o testgroup -v login -r
cipux_storage_client -t set_value -s all_group_node -e memberUid -o testgroup -v login -d

Wobei der Wert von -v nicht wichtig ist.

cipux_storage_client -t set_all_values
Legen Sie alle LDAP-Werte eines bestimmten Objekts und Attributs fest.

cipux_storage_client -t add_node
Fügt einen LDAP-Knoten hinzu.

ZUSAMMENFASSUNG

cipux_storage_client -t add_node -s -Ö -x = [-x = ...]

Anwendungsbereich Beispiel

cipux_storage_client -t add_node -s cipux_room -o test1 -x objectClass=room -x objectClass=cipuxRoom -x cn=test1

Wenn Sie beispielsweise cn=NAME nicht angeben, erhalten Sie die folgende Ausnahme:

AUSNAHME Pflichtattr [cn] fehlt!
Bitte geben Sie die Befehlszeilenoption -x oder --mattrvalue an!
Beispiel: -x cn=

Um einen Benutzerknoten hinzuzufügen (kein vollständiges Benutzerkonto!) wird dadurch ein halbes Benutzerkonto erstellt
benannter Testbenutzer:

cipux_storage_client -t add_node -s cipux_account.user -o testuser -x cipuxFirstname=test -x cipuxLastname=user -x objectClass=cipuxAccount -x objectClass=posixAccount -x objectClass=shadowAccount -x uid=testuser -x cn=testuser -x cipuxCreationDate =2007 -x uidNumber=10 -x gidNumber=26 -x homeDirectory=/home/testuser -x objectClass=imapUser -x mailMessageStore=/ Tmp -D 129

Dies ist natürlich nur ein Beispiel. Es ist keine gute Idee zu geben / Tmp als Postspeicher
Verzeichnis oder verwenden Sie eine statische uidNumber. Aber dieser oder ein ähnlicher Befehl kann der Benutzer sein, um die zu testen
LDAP-Schicht.

cipux_storage_client -t umbenennen_knoten
Der Befehl umbenennen setzt auf den Net::LDAP-Befehl modrdn. Und weil einfach
Das Umbenennen eines LDAP-DN ist nicht die einzige Aufgabe des Umbenennens eines LDAP-Blatts, der Befehl kann nur umbenennen
bestimmte LDAP-Objekte.

Es kann beispielsweise ein cipuxConfiguration-LDAP-Blatt umbenennen. Vor dem Umbenennen sieht es aus
im Grunde so:

dn: cn=testconfig,ou=Konfiguration,ou=CipUX,dc=nodomain
cipuxVariable: Testwert
cn: testconfig
objectClass: oben
Objektklasse: cipuxConfiguration

Wenn Sie jetzt den Befehl ausgeben:

cipux_storage_client -t rename_node -s cipux_configuration -o testconfig -v myconfig

Sie erhalten

dn: cn=myconfig,ou=Konfiguration,ou=CipUX,dc=nodomain
cipuxVariable: Testwert
cn: testconfig
cn: meineconfig
objectClass: oben
Objektklasse: cipuxConfiguration

Sie haben bemerkt, dass sich das 'cn' verdoppelt hat, da LDAP ein entsprechendes 'cn' in diesem LDAP erwartet
Objekt? Da hat diese Konfiguration nun zwei Namen. Es sollte schwierig sein zu verpacken
jetzt eine neue 'testconfig'. Sie müssen 'cn: testconfig' Attribut und Wert löschen, bevor Sie
kann eine neue 'testconfig' erstellen. Da dies eher verwirrend ist, solltest du es vermeiden
nach Möglichkeit umbenennen. Ein Objekt zu löschen und neu zu erstellen ist ein sicherer Weg.

cipux_storage_client -t Knoten löschen
Löscht einen bestimmten LDAP-Knoten.

DIAGNOSE

ALLES

EXIT STATUS

ALLES

CONFIGURATION

/usr/share/cipux/etc/cipux_storage.perl

ABHÄNGIGKEITEN

CipUX::Speicher::Client

INKOMPATIBILITÄTEN

Nicht bekannt.

Verwenden Sie cipux_storage_clientp online mit den onworks.net-Diensten