Difference between revisions of "DHN Installation"
Manuelesimi (Talk | contribs) (→Installation Beta) |
Manuelesimi (Talk | contribs) (→Installation Beta) |
||
| Line 32: | Line 32: | ||
After having prepared the node as described in [[DHN_Installation:Host_preparation| Host preparation]], the following steps have to be performed in order to install the DHN: | After having prepared the node as described in [[DHN_Installation:Host_preparation| Host preparation]], the following steps have to be performed in order to install the DHN: | ||
| − | |||
| − | |||
* uncompress the ''DHN_installer_Beta.tar.gz'' file | * uncompress the ''DHN_installer_Beta.tar.gz'' file | ||
* stop the Java WS Core container (if any) | * stop the Java WS Core container (if any) | ||
Revision as of 15:29, 9 July 2007
Contents
Host preparation
Minimal host requirements
- Hardware
TBD
- Operating System
- any Unix-based tested platform for Java WS Core
- tested platform: SL3.0, Red Hat FC6, Ubuntu
- any Unix-based tested platform for Java WS Core
- Connectivity
- a machine configured with a static IP address
- bandwidth...
- Software
- java 1.5
- Apache ANT 1.6.0 or higher
- Java Ws Core 4.0.4
Migrating from the previous releases
The last version of DHN (RCBeta) is a full installation and also can be used to upgrade from a previous DHN distributions.
Package Installation
Download
The DHN RC Beta can be downloaded from here.
Installation Beta
After having prepared the node as described in Host preparation, the following steps have to be performed in order to install the DHN:
- uncompress the DHN_installer_Beta.tar.gz file
- stop the Java WS Core container (if any)
- if you are installing a new DHN from scratch:
- type "make install" in the uncompressed ./DHN_installer_Beta folder
- if you are making an upgrade from a previous DHN distribution:
- type "make upgrade" in the uncompressed ./DHN_installer_Beta folder
- source your ${GLOBUS_LOCATION}/etc/globus-devel-env.sh file
- follow the Post-installation configuration steps
- (re)start the container
Included software
This version of the DHN Installer includes the following Collective Layer components:
- NAL Beta
- DIS-HLSClient Beta
- DIS-IP Beta
- HNM Service Beta
- HNM Service stubs Beta
- DIS-IC stubs Beta
- DIS-Registry stubs Beta
- DIS-Broker stubs Beta
- DLManagement stubs Beta
- KeeperCommon Library Beta
- DIS-Util Library Beta
- ProfileManagement Library Beta
- DILIGENTProvider Beta
- Authentication API Beta
- Delegation Service Beta
- Delegation Stubs Beta
- DVOS Common Library Beta
- Gas stubs Beta
- DILIGENT Provider Stubs Beta
All the components above are also available in ETICS in their *_0_2_0 configurations.
Post-installation configuration
Configuration files
Configuration files that have to be edited after the installation:
Java WS Core
container-log4j.properties
The Log4J output should be redirected on the file system in order to simplify the debugging of what is happening on the DHN and the exchange of such information. The following configuration in the $GLOBUS_LOCATION/container-log4j.properties file has to replace the default one for the log4j.appender.A1:
log4j.appender.A1=org.apache.log4j.RollingFileAppender
log4j.appender.A1.file=container.log
log4j.appender.A1.MaxFileSize=10000KB
# Keep ten backup file
log4j.appender.A1.MaxBackupIndex=100
# A1 uses PatternLayout.
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%d{ISO8601} %-5p %c{2} [%t,%M:%L] %m%n
# Display any warnings generated by our code
log4j.category.org.globus=INFO
This configuration enables the file rolling behavior and a rollover schedule when the file log size reaches 10MB by managing in this way 100 log files.
Moreover, we initially suggest also to enable a DEBUG log level for the HNMService and the Profile Management Library. In order to do that, add the following lines to the same file:
log4j.category.org.diligentproject.keeperservice.hnm.impl=DEBUG log4j.category.org.diligentproject.common.profile.impl=DEBUG
server-config.wsdd
This file includes a set of global properties related to the container. It is located in the $GLOBUS_LOCATION/etc/globus_wsrf_core/ directory. It must be changed in order to allow the DHN to publish its hostname. The following two lines have to be added in the <globalConfiguration> section:
<parameter name="logicalHost" value="yourHostName.yourDomain"/> <parameter name="publishHostName" value="true"/>
Of course, the yourHostName.yourDomain string must be replaced with your real hostname.
HNMService
JNDI file
The HNMService performs JNDI lookups for some static configuration parameters. Its JNDI file is located in $GLOBUS_LOCATION/etc/org_diligentproject_keeperservice_hnm/jndi-config.xml
The global resource HNMServiceConfiguration groups the configuration parameters. The following ones have to be changed accordingly to the suggestion reported:
- defaultVO
- This parameter has to be filled with the name of the VO in which the DHN will act. This is the Default VO where the DHN and all the hosted RIs will be published as default behavior. The DHN is pre-configured to work in three different VOs (ARTE, ImpECt and Testing). One of the followings has to be specified as default VO value:
- /diligent → to join only the global DILIGENT VO (working in the pre-production infrastructure)
- /diligent/ARTE → to join the ARTE VO (working in the pre-production infrastructure)
- /diligent/ImpECt → to join the ImpECt VO (working in the pre-production infrastructure)
- /diligent/dev → to join the Development VO (working in the development infrastructure)
- This parameter has to be filled with the name of the VO in which the DHN will act. This is the Default VO where the DHN and all the hosted RIs will be published as default behavior. The DHN is pre-configured to work in three different VOs (ARTE, ImpECt and Testing). One of the followings has to be specified as default VO value:
- DHNProfileUpdateIntervalInMillis
- the DHN profile is updated accordingly to this interval. The interval is specified as milliseconds.
- latitude + longitude
- these two coordinates are used to correctly locate the DHN on the Google Map visualized by the Monitoring Portlet. To discover which are the coordinates for the DILIGENT partner DHNs see here
- country: two letter code of the country (e.g. IT)
- location: a freetext placeholder (e.g. Pisa)
- localFileSystem
- the partition on your file system that you want to share with the hosted services
- DHNType
- allowed values here are: Dynamic, Static and SelfCleaning. A static DHN is not used as target for the dynamic deployment, while a SelfCleaning is automatically cleaned every night (used just for demos). The default value is Dynamic.
There are other parameters in the resource and they have to be left with their default values.
Scripts
Scripts that have to be run that take care of post installation activities:
Testing and Verification
After the installation the DHN automatically joins the Beta infrastructure of DILIGENT. This is a completely new infrastructure that officially becomes the target infrastructure for the Beta releases of all the DILIGENT components. All the profiles produced by the DHN software are published on this new infrastructure glued together by the Beta release of the Collective Layer components.
To understand if a DHN has been successfully installed it is important to check if the DHN profile and the HNMService Running Instance profiles are correctly published in the DIS of such a infrastructure. A new DILIGENT Administrative Portal is available to manage this new infrastructure. In order to access to the monitoring capabilities of the Portal, you can use the following:
- user monitoring
- pass monitoring
