CDM Data Portal Install Guide

---

This page provides a guidance on installing the the CDM DataPortal

---

Download

In order to install the CDM Data Portal you will need to download the following files:

• The cdm_dataportal Drupal5 Module: http://dev.e-taxonomy.eu/download/dataportal/2.0/cdm_dataportal_v2.0.zip
• Drupal 5: http:\\drupal.org
• The JQuery Update for Drupal5: http://drupal.org/project/jquery_update

If you not already have CDM Server which is providing the data to be published in the CDM DataPortal? you will need to also install a CDM Server. The CDM Server can be downloaded from: http://dev.e-taxonomy.eu/download/dataportal/2.0/cdmserver_v2.0.zip

Multisite Installation

Setting cookie domain and path correctly

In multisite installations which are running under the same domain with different base paths you may encounter problems with concurrent cookies or with cookies. Sites with are delivered through a forwarding proxy will have the problem that cookies are even not set. To circumvent these issues replace in the settings.php the following section

/**
 * We try to set the correct cookie domain. If you are experiencing problems
 * try commenting out the code below or specifying the cookie domain by hand.
 */
if (isset($_SERVER['HTTP_HOST'])) {
  $domain = '.'. preg_replace('`^www.`', '', $_SERVER['HTTP_HOST']);
  // Per RFC 2109, cookie domains must contain at least one dot other than the
  // first. For hosts such as 'localhost', we don't set a cookie domain.
  if (count(explode('.', $domain)) > 2) {
    ini_set('session.cookie_domain', $domain);
  }
}

with

/**
 * We try to set the correct cookie domain and cookie path.
 * The code below differs from the default code usually found in 
 * the drupal settings.php. This enhanced version allows correct 
 * handling for multisite installations running under the same domain
 * with different base paths as well as of sites with are delivered 
 * through a forwarding proxy. In the latter case you may want to 
 * configure the $forwarded_server_mapping array found right below. 
 * This array maps the $_SERVER['HTTP_X_FORWARDED_SERVER'] to the 
 * correct cookie_path which cannot be inferred from the $_SERVER 
 * variables. E.g.:
 *    
 *    $forwarded_server_mapping = array(
 *        'wp6-cichorieae.e-taxonomy.eu' => '/portal'
 *    );
 */

$forwarded_server_mapping = array(
  'wp6-cichorieae.e-taxonomy.eu' => '/portal'
);


if(isset($_SERVER['HTTP_X_FORWARDED_SERVER']) && isset($forwarded_server_mapping[$_SERVER['HTTP_X_FORWARDED_SERVER']])){
	$domain = $_SERVER['HTTP_X_FORWARDED_SERVER'];
} else {
	$domain = $_SERVER['HTTP_HOST'];
}

if (isset($domain)) {
	if (strpos($domain, 'www.') == 0) {
    $domain = '.'. preg_replace('`^www.`', '', $domain);
	}
  // Per RFC 2109, cookie domains must contain at least one dot other than the
  // first. For hosts such as 'localhost', we don't set a cookie domain.
  if (count(explode('.', $domain)) > 2) {
    ini_set('session.cookie_domain', $domain);
  }
}

if (isset($_SERVER['SCRIPT_NAME'])) {
	if (isset($_SERVER['HTTP_X_FORWARDED_SERVER'])) {
    if (isset($forwarded_server_mapping[$_SERVER['HTTP_X_FORWARDED_SERVER']])) {
		  $cookie_path = $forwarded_server_mapping[$_SERVER['HTTP_X_FORWARDED_SERVER']];
		} else {
			$cookie_path = '/';
		}
	} else {
  	$cookie_path = preg_replace('`/index.php$`', '', $_SERVER['SCRIPT_NAME']);	
	}
  ini_set('session.cookie_path', $cookie_path);
}

You also may want to configure the $forwarded_server_mapping array.