The GeoNetwork’s configuration is made up of a set of parameters that can be changed to accomodate any installation need. These parameters are subdivided into 2 groups:
parameters that can be easily changed through a web interface.
parameters not accessible from a web interface and that must be changed when the system is not running.
The first group of parameters can be queried or changed through 2 services: xml.config.get and xml.config.update. The second group of parameters can be changed using the GAST tool.
This service returns the system configuration’s parameters.
The response is an XML tree similar to the system hyerarchy into the settings structure. See ?? for more information. The response has the following elements:
site: A container for site information.
name: Site’s name.
organization: Site’s organization name.
server: A container for server information.
host: Name of the host from which the site is reached.
port: Port number of the previous host.
intranet: Information about the intranet of the organization.
network: IP address that specifies the network.
netmask: netmask of the network.
z3950: Configuration about Z39.50 protocol.
enable: true means that the server component is running.
port: Port number to use to listen for incoming Z39.50 requests.
proxy: Proxy configuration
use: true means that the proxy is used when connecting to external nodes.
host: Proxy’s server host.
port: Proxy’s server port.
username: Proxy’s credentials.
password: Proxy’s credentials.
feedback: A container for feeback information
email: Administrator’s email address
mailServer: Email server to use to send feedback
host: Email’s host address
port: Email’s port to use in host address
removedMetadata: A container for removed metadata information
dir: Folder used to store removed metadata in MEF format
ldap: A container for LDAP parameters
use:
host:
port:
defaultProfile:
login:
userDN:
password:
distinguishedNames:
base:
users:
userAttribs:
name:
password:
profile:
Figure 18.19, “Example of xml.config.get response” shows an example of
xml.config.get
response.
Figure 18.19. Example of xml.config.get response
<config> <site> <name>dummy</name> <organization>dummy</organization> </site> <server> <host>localhost</host> <port>8080</port> </server> <intranet> <network>127.0.0.1</network> <netmask>255.255.255.0</netmask> </intranet> <z3950> <enable>true</enable> <port>2100</port> </z3950> <proxy> <use>false</use> <host/> <port/> <username>proxyuser</username> <password>proxypass</password> </proxy> <feedback> <email/> <mailServer> <host/> <port>25</port> </mailServer> </feedback> <removedMetadata> <dir>WEB-INF/removed</dir> </removedMetadata> <ldap> <use>false</use> <host /> <port /> <defaultProfile>RegisteredUser</defaultProfile> <login> <userDN>cn=Manager</userDN> <password /> </login> <distinguishedNames> <base>dc=fao,dc=org</base> <users>ou=people</users> </distinguishedNames> <userAttribs> <name>cn</name> <password>userPassword</password> <profile>profile</profile> </userAttribs> </ldap> </config>
This service is used to update the system’s information and so it is restricted to administrators.
The request format must have the same structure returned by the
xml.config.get
service and can contain only elements
that the caller wants to be updated. If an element is not included, it will
not be updated. However, when included some elements require mandatory
information (i.e. the value cannot be empty). Please, refer to Table 18.4, “Mandatory and optional parameters for the xml.config.update service”.
Table 18.4. Mandatory and optional parameters for the xml.config.update service
Parameter |
Type |
Mandatory |
---|---|---|
site/name |
string |
yes |
site/organization |
string |
- |
server/host |
string |
yes |
server/port |
integer |
- |
intranet/network |
string |
yes |
intranet/netmask |
string |
yes |
z3950/enable |
bool |
yes |
z3950/port |
integer |
- |
proxy/use |
bool |
yes |
proxy/host |
string |
- |
proxy/port |
integer |
- |
proxy/username |
string |
- |
proxy/password |
string |
- |
feedback/email |
string |
- |
feedback/mailServer/host |
string |
- |
feedback/mailServer/port |
integer |
- |
removedMetadata/dir |
string |
yes |
ldap/use |
bool |
yes |
ldap/host |
string |
- |
ldap/port |
integer |
- |
ldap/defaultProfile |
string |
yes |
ldap/login/userDN |
string |
yes |
ldap/login/password |
string |
- |
ldap/distinguishedNames/base |
string |
yes |
ldap/distinguishedNames/users |
string |
yes |
ldap/userAttribs/name |
string |
yes |
ldap/userAttribs/password |
string |
yes |
ldap/userAttribs/profile |
string |
- |
Other documents: The complete manual in pdf format | License | Readme | Changes