opsi manual opsi version 4.0.2 - opsi Download - uib

opsi manual opsi version 4.0.2
17.6 Processing
133 / 193
If the dynamic depot assignment is activated for a client by the host parameter clientconfig.depot.dynamic, the client
retrieves the script via web service and executes it.
The script to be used for dynamic assignment is:
/etc/opsi/backendManager/extend.d/70_dynamic_depot.conf
Following parameters are passed to the function selectDepot, which is defined in the script:
• clientConfig
Information about the current client configuration (hash).
The clientConfig hash keys are currently:
– "clientId": opsi host ID of the client (FQDN)
– "ipAddress": IP address of the network interface to the opsi-config-server
– "netmask" : netmask of the network interface
– "defaultGateway": default gateway
• masterDepot
Information regarding the master depot (opsi-depot-server-object). The master depot is the depot which the client
is assigned to from the management interface. The attributes of the passed opsi-depot-server-object match the
attributes as given by host_getObjects (see Section 17.4).
• alternativeDepots
Information about the alternative depots (list of opsi-depot-server-objects). The list of alternative depots lists the
depots, which are, regarding the required software packets, identical to the master depot.
Based on this information, the assignment algorithm can pick a depot from the provided depot list and return the
opsi-depot-server-object of the chosen depot as the result of the function. If the assignment algorithm does not find a
suitable depot from the list (or if the provided list is empty), the return result should be the master depot object.
17.7 Template of the assignment script
The template script checks the network addresses of the given depots and picks the depot which is in the same network
as the client.
The template script offers example functions for depot detection.
The function depotSelectionAlgorithmByNetworkAddress checks the network addresses of the depots and selects
the depot which is in the same network as the client.
The function depotSelectionAlgorithmByLatency sends ICMP „echo-request“-packets (ping) to the depots and
selects the depot with the lowest latency.
The function getDepotSelectionAlgorithm is called by the client and returns the algorithm for depot selection.
The template script uses as default the function depotSelectionAlgorithmByNetworkAddress.
# -*- coding: utf-8 -*-
global depotSelectionAlgorithmByNetworkAddress
depotSelectionAlgorithmByNetworkAddress = \
’’’
def selectDepot(clientConfig, masterDepot, alternativeDepots=[]):
selectedDepot = masterDepot
logger.info(u"Choosing depot from list of depots:")
logger.info(u" Master depot: %s" % masterDepot)
for alternativeDepot in alternativeDepots:
logger.info(u" Alternative depot: %s" % alternativeDepot)
if alternativeDepots:
import socket, struct
# Calculate bitmask of host’s ipaddress