Changes between Version 70 and Version 71 of client_installation_guide_rpm

Timestamp:

10/02/12 21:26:27 (12 years ago)

Author:

piontek

Comment:

--

client_installation_guide_rpm

@@ -13 +13 @@
 
 = Mandatory steps =
+
 == Certificate authorities ==
 
@@ -118 +119 @@
 
 
-= Software repositories =
+
+
+
+= QCG-Broker client =
+== Software repositories ==
 The packages are designed for Scientific Linux 5.x
 The installation process requires root privileges.
@@ -157 +162 @@
 }}}
 
-
-= GridFTP server =
+== Installation ==
+* install QCG-Broker client using YUM Package Manager:
+{{{
+#!div style="font-size: 90%"
+{{{#!sh
+yum install qcg-broker-client
+}}}
+}}}
+
+The client is installed into three directories:
+* ''/usr/share/qcg/qcg-broker-client'' - scripts and jars needed to run the client
+* ''/etc/qcg/qcg-broker-client'' - configuration file for the client
+* ''/usr/bin'' - links to qcg-* commands
+
+
+== Configuration ==
+* To configure the client please edit the ''/etc/qcg/qcg-broker-client/qcg-broker-client.conf'' file.
+
+{{{
+#!div style="font-size: 90%"
+{{{#!sh
+vi /etc/qcg/qcg-broker-client/qcg-broker-client.conf
+}}}
+}}}
+
+The following properties have to be set:
+* QCG_URL_DEFAULT - the URL of QCG-Broker service
+* QCG_DN_DEFAULT - the Distinguished Name of the QCG-Broker service
+* QCG_CLIENT_LOCATION_DEFAULT - the location ot the client. This value is set during the installation procedure and 
+
+Optionally it is possible to configure the host and port of GridFTP service which will be used by client to staging input/output files
+* GFTP_HOSTNAME - hostname of the host where the gridFTP service is installed. If the property is not set the default value is hostname of the host where the client is installed,
+* GFTP_PORT - port which the gridFTP service is listening on. If the property is not set the default value is "2811".
+
+Additionally it is possible to configure also the settings responsible for defining the policy for creation and refreshing of user's proxy.
+* QCG_PROXY_DURATION_DEFAULT - default length in hours of the created proxy 
+* QCG_PROXY_DURATION_MIN - minimal acceptable lifetime of the proxy. If the remaining lifetime of the proxy is smaller then the value, the proxy will be automatically recreated.
+
+
+The example of the configuration file can be seen below:
+{{{
+#!div style="font-size: 90%"
+{{{#!sh
+export QCG_CLIENT_LOCATION=/usr/share/qcg/qcg-broker-client
+
+export QCG_URL_DEFAULT="https://qcg-broker.man.poznan.pl:8443/qcg/services/"
+export QCG_DN_DEFAULT="/C=PL/O=GRID/O=PSNC/CN=qcg-broker/qcg-broker.man.poznan.pl"
+
+export GFTP_HOSTNAME=qcg.man.poznan.pl
+export GFTP_PORT=2811
+
+export QCG_PROXY_DURATION_DEFAULT=600
+export QCG_PROXY_DURATION_MIN=480
+}}}
+}}}
+
+= Optional steps =
+== GridFTP server ==
 For the user convenience QCG client is able to stage in input data accessible from the host where it is installed and also to stage out output data there. The functionality requires the data to be accessible via gridFTP server. The gridFTP server can be installed on the client machine or it can be any gridFTP server having access to the data on client machine.
 
@@ -218 +279 @@
 
 
-= Grid Mapfile =
+== Grid Mapfile ==
 To have access do data every authenticated user must be authorized by gridFTP server against the `grid-mapfile`. This file can be created manually by an administrator (if the service is run in "test mode") or generated automatically based on the LDAP directory service.
-== Manually created grid mapfile (for testing purpose only) ==
+=== Manually created grid mapfile (for testing purpose only) ===
 {{{
 #!div style="font-size: 90%"
@@ -228 +289 @@
 }}}
 }}}
-== LDAP generated grid mapfile ==
+=== LDAP generated grid mapfile ===
 * Create the ''qcg-dev'' group - this grou is allowed to read the configuration and log files.
 {{{
@@ -271 +332 @@
 
 This gridmapfile generator script is run every 10 minutes. Moreover its issues  `su - $USERNAME -c 'true' > /dev/null`  for every new user that do not have yet home directory (thus triggering pam_mkhomedir if installed).
-
-= QCG-Broker client =
-== Installation ==
-* install QCG-Broker client using YUM Package Manager:
-{{{
-#!div style="font-size: 90%"
-{{{#!sh
-yum install qcg-broker-client
-}}}
-}}}
-
-The client is installed into three directories:
-* ''/usr/share/qcg/qcg-broker-client'' - scripts and jars needed to run the client
-* ''/etc/qcg/qcg-broker-client'' - configuration file for the client
-* ''/usr/bin'' - links to qcg-* commands
-
-
-== Configuration ==
-* To configure the client please edit the ''/etc/qcg/qcg-broker-client/qcg-broker-client.conf'' file.
-
-{{{
-#!div style="font-size: 90%"
-{{{#!sh
-vi /etc/qcg/qcg-broker-client/qcg-broker-client.conf
-}}}
-}}}
-
-The following properties have to be set:
-* QCG_URL_DEFAULT - the URL of QCG-Broker service
-* QCG_DN_DEFAULT - the Distinguished Name of the QCG-Broker service
-* QCG_CLIENT_LOCATION_DEFAULT - the location ot the client. This value is set during the installation procedure and 
-
-Optionally it is possible to configure the host and port of GridFTP service which will be used by client to staging input/output files
-* GFTP_HOSTNAME - hostname of the host where the gridFTP service is installed. If the property is not set the default value is hostname of the host where the client is installed,
-* GFTP_PORT - port which the gridFTP service is listening on. If the property is not set the default value is "2811".
-
-Additionally it is possible to configure also the settings responsible for defining the policy for creation and refreshing of user's proxy.
-* QCG_PROXY_DURATION_DEFAULT - default length in hours of the created proxy 
-* QCG_PROXY_DURATION_MIN - minimal acceptable lifetime of the proxy. If the remaining lifetime of the proxy is smaller then the value, the proxy will be automatically recreated.
-
-
-The example of the configuration file can be seen below:
-{{{
-#!div style="font-size: 90%"
-{{{#!sh
-export QCG_CLIENT_LOCATION=/usr/share/qcg/qcg-broker-client
-
-export QCG_URL_DEFAULT="https://qcg-broker.man.poznan.pl:8443/qcg/services/"
-export QCG_DN_DEFAULT="/C=PL/O=GRID/O=PSNC/CN=qcg-broker/qcg-broker.man.poznan.pl"
-
-export GFTP_HOSTNAME=qcg.man.poznan.pl
-export GFTP_PORT=2811
-
-export QCG_PROXY_DURATION_DEFAULT=600
-export QCG_PROXY_DURATION_MIN=480
-}}}
-}}}