Changes between Version 5 and Version 6 of opsi/howto

Timestamp:

Jul 6, 2012, 3:49:01 PM (12 years ago)

Author:

joergs

Comment:

transfered infos from our internal wiki

opsi/howto

@@ -4 +4 @@
 = OPSI Howto =
 
+== API ==
 
-== Change Product Properties for all Clients on a Depot Server ==
+{{{
+opsi-admin
+}}}
+
+method names start with get or set are compability methods for opsi 3 calls.
+Opsi 4 method names start with the object type, eg:
+{{{
+method host_getIdents
+method product_getIdents
+method product_getHashes
+productOnClient_getObjects
+}}}
+
+== Product Properties ==
+
+Packages have defined default values for there properties.
+
+=== Client Product Properties ===
+
+Product properties can be set individually on every client using the Opsi-Gui.
+
+
+=== Depot Product Properties  ===
+
+A Depot Server can have its own set of product properties.
+When a new Opsi is added to a depot server, these depot values are also used for the client, 
+if the client does not overwrite these properties.
+
+The depot defaults can be defined when installing a new package:
+{{{
+opsi-package-manager -i -p ask PAKET.opsi
+}}}
+
+Additionally, these properties can be quering and modified using the Opsi-JSON-RPC API calls.
+
+Example:
+
+
+{{{
+# query the properties of the product "winxppro" on the server DEPOT-SERVER-ID
+opsi-admin -d method getProductProperties_hash winxppro DEPOT-SERVER-ID
+
+# change the property "productkey" of the product winxppro on the server DEPOT-SERVER-ID
+opsi-admin -d method setProductProperty winxppro "productkey" "ABCDE-FGHIJ-KLMNO-QRTUV-WXYZ1" DEPOT-SERVER-ID
+}}}
+
+==== Change Product Properties for all Clients on a Depot Server ====
 
 {{{
@@ -13 +60 @@
   objectId:: Depot-Server or Client-Name
 
+
+=== Global Defaults ===
+
+Global defaults can be changed using the following API calls:
+
+{{{
+opsi-admin -d method productProperty_getObjects [] '{"productId":"winxppro"}' > /tmp/winxppro_config.json
+
+vi /tmp/winxppro_config.json
+# change possible values and defaults here (eg.: orgname="dass IT GmbH"
+
+opsi-admin -d method productProperty_updateObjects < /tmp/winxppro_config.json
+
+# check the result
+opsi-admin -d method getProductProperties_hash winxppro
+}}}
+
+
+
+
 = Bitlocker and Reinstallation =