2 Installation manual



Prerequisites for installing Ninf-G

Note: We recommend you use *pthr flavor. Some features don't work with non-*pthr flavor.

2.1 Downloading the Ninf-G package

Download the Ninf-G package from the download Web page

( http://ninf.apgrid.org/packages/welcome.html).

2.2 Creating a "ninf" user

It is recommended that you create a "ninf" user on the installation system.

It is also possible, however, to install Ninf-G in a location where the user has read and write privileges under general user privileges (that user's home directory, for example).

2.3 Installation

  • Globus libraries built from source bundles must be installed on all nodes on which Ninf-G Clients and Executables may run. The libraries may be installed in a shared directory.
  • Ninf-G libraries must be installed on the nodes on which Ninf-G Clients and Executables will be compiled. The libraries may be installed in a shared directory.
  • The server_install command for registering the host information needs to be executed only on a front-end node on which the Globus gatekeeper is running.

2.4 Configure command options

The available options can be displayed with the following command.

% ./configure --help

The options that can be used with the configure script are described below.

appendix : Installing GT4

Ninf-G requires Globus Toolkit installation. This appendix shows how to accomplish GT4 installation. When you install GT4, refer to Globus Website for exact information.

This section gives hints for installing GT4.

a.1 Installing the Globus Toolkit

Make the temporary directory.

% mkdir dirForInstaller 

Install GT4 (we recommend Version 4.0.1 or later (not 4.0.0) and "source" installer).

% cd dirForInstaller
% gunzip -c [TARBALL LOCATION]/gt4.0.1-all-source-installer.tar.gz | tar xf -   
% cd gt4.0.1-all-source-installer
% ./configure --prefix=/path/to/gt4-install
% make
% make install

Note: Use of MDS2 on Ninf-G requires the --enable-prewsmds option on GT4.

See also information about setting the Globus Toolkit at following URL.

http://www.globus.org/toolkit/docs/4.0/admin/docbook/

Ninf-G4 requires some components of the Globus Toolkit. Following URLs provide information about setting of components.

a.2 About Usage Statistics Collection by Globus Toolkit

Globus Toolkit provides Usage statistics. (See http://www.globus.org/toolkit/docs/4.0/Usage_Stats.html) If you desire to prevent this, match the following configuration changes.

Set the environment variable "GLOBUS_USAGE_OPTOUT" to "1."

Comment out the "usageStatisticsTargets" parameter in the configuration file $GLOBUS_LOCATION/etc/globus_wsrf_core/server-config.wsdd

This setting,
    <globalConfiguration>
        <parameter name="usageStatisticsTargets"
                   value="usage-stats.globus.org:4810"/>
Delete or comment out as follows.
    <globalConfiguration>
        <!--parameter name="usageStatisticsTargets"
                   value="usage-stats.globus.org:4810"/-->
Also check the following URLs.

a.3 Setting up the environment

Setup the environment variable and execute the script for setting up the environment.

a.4 Starting the Container

% cd $GLOBUS_LOCATION
% ./bin/globus-start-container

Starting the SOAP server at: https://[IP-ADDR]:8443/wsrf/services/ with the following services:

[1]: https://[IP-ADDR]:8443/wsrf/services/TriggerFactoryService
[2]: https://[IP-ADDR]:8443/wsrf/services/DelegationTestService
....
[48]: https://[IP-ADDR]:8443/wsrf/services/CASService
[49]: https://[IP-ADDR]:8443/wsrf/services/ManagedJobFactoryService

a.5 Testing the WS GRAM

Test the WS GRAM using following procedures.

% cd $GLOBUS_LOCATION
% ./bin/grid-proxy-init
  (input your passphrase)
% globusrun-ws -submit -job-description-file \
    $GLOBUS_LOCATION/test/globus_wsrf_gram_service_java_test_unit/test.xml
Submitting job...Done.
Job ID: uuid:[UUIDUUID-UUID-UUID-UUID-UUIDUUIDUUID]
Termination time: MM/DD/CCYY HH:MM GMT
Current job state: Unsubmitted
Current job state: Done
Destroying job...Done.

a.6 Installing Index Service Bindings

If the Ninf-G C Client uses MDS4, the Index Service Bindings should be installed with Globus Toolkit.

Execute the following items with owner user privileges for $GLOBUS_LOCATION (for example, "globus").

% cd gt4.0.1-all-source-installer
% make globus_c_wsrf_core_bindings-thr
% make globus_handler_ws_addressing-thr
% $GLOBUS_LOCATION/sbin/gpt-build index_service_bindings-1.2.tar.gz [flavor]

Note: threaded flavor recommended.

a.7 Installing GT4 by Binary installer

It is recommended to install Globus Toolkit from source installer. If Globus Toolkit is installed from binary installer, you need to install globus_core with the following command:

% $GLOBUS_LOCATION/sbin/gpt-build -nosrc <flavor>

Where flavor is the Globus Toolkit flavor you're passing to Ninf-G configure script.

(GT4 Admin Guide B.4. Using globus-makefile-header with a binary distribution)

a.8 Installed file composition

$GLOBUS_LOCATION/
+etc
| +grid-info-resource-ldif.conf (optional) (*1)
| +grpc.schema (optional)
| +gpt
| | +packages
| |   +ng4grpcinfo (optional)
| |     +undeploy.xml (optional)
| +ng4grpcinfo (optional)
|   +regist.xml (optional)
|   +server-config.wsdd (optional)
|   +jndi-config.xml (optional)
+lib
| +ng4grpcinfo.jar (optional)
| +ng4grpcinfo_stubs.jar (optional)
+share
| +schema
|   +ng4grpcinfo (optional)
|     +GrpcInfo_flattened.wsdl (optional)
|     +GrpcInfo.wsdl (optional)
|     +GrpcInfo_service.wsdl (optional)
|     +GrpcInfo_bindings.wsdl (optional)
+var
  +gridrpc (optional)
    +catldif (optional)
    +root.ldif (optional)
    +*.ldif (optional)

    *1) The information of Ninf-G was added to this file.

$NG_DIR
+bin
| +base64encode
| +globusflags
| +ng_cc
| +ng_delete_functions
| +ng_dump_functions
| +ng_gen
| +ng_gen_dif
| +ng_invoke_server.Condor (optional)
| +ng_invoke_server.GT2c
| +ng_invoke_server.GT4java (optional)
| +ng_invoke_server.GT4py
| +ng_invoke_server.SSH
| +ng_invoke_server.NAREGISS (optional)
| +ng_version
+doc
| +tutorial
| +users_manual
+etc
| +gpt-query-result.txt
| +ng_invoke_server.GTtempl
| +ninfg-user-env.csh
| +ninfg-user-env.sh
| +server.conf
+include
| +grpc.h
| +grpcError.h
| +grpcLocal.h
| +grpc_executable.h
| +net.h
| +ng.h
| +ngClientInternal.h
| +ngCommon.h
| +ngConfig.h
| +ngConfigFile.h
| +ngEx.h
| +ngExecutableInternal.h
| +ngFunctionInformation.h
| +ngInternal.h
| +ngPlatform.h
| +ngXML.h
+lib
  +classad.jar (optional)
  +condorAPI.jar (optional)
  +condorIS.jar (optional)
  +gt4invokeserver.py
  +gt4invokeserverconfig.py
  +ioutils.py
  +libexpat.a
  +libngclient.a
  +libngcommon.a
  +libngexecutable.a
  +libnggrpc.a
  +libngnet.a
  +libngutility.a
  +ng_invoke_server.GT4.py
  +ng_invoke_server.jar (optional)
  +ngisgt4.jar (optional)
  +ngutils.py
  +template.mk
  +template.sh
  +uuid.py
  +naregissIS.jar (optional)
  +naregiss_is_execute.sh (optional)

last update : $Date: 2008/09/12 08:27:42 $