Skip to end of metadata
Go to start of metadata

1.1.1 Before starting the installation

Prerequisites: See prerequisites.

Running the installer: The MDweb 2 installer is a jar (executable Java) file. The virtual Java machine is required before the installer can be used (see Installation prerequisites). A graphical user interface (GUI) environment is required.

Warning

Icon

PostgreSQL configuration: To be able to run the scripts for creating the database, you have to modify the authentication method specified in the pg_hba.conf file. Change:

to:

Then restart your database server:

1.1.2 Installation 

To start the installation, double-click the file or, in a terminal (command.com for Windows or shell terminal for Unix), run the command:

Then follow on-screen instructions which will take you through the following steps:

  • Step 1: Accepting the LGPL 3.0 licence.
  • Step 2: Specifying the installation path. It is, by default:
    • Under Windows : C:\Program Files\mdweb
    • Under Linux: /home/[user]/mdweb
    • Under Mac OS: /Application/mdweb
  • You can change the default to a directory of your choice. It will be created if it already does not exist.
  • Step 3: Choosing the packages to install
    • By default, the installer offers to install:
    • The MDweb documentation,
    • The independent administration module (required),
    • The local MDweb database (required),
    • The Java War which contains the MDweb application's Java classes (search engine and CSW 2 server)
    • The Tomcat 6.0 application server if it hasn't been detected on your machine. If you do not want to install it, uncheck the box. You will then have to, at the end of installation, deploy the war in a Java application server (Tomcat, Glassfish, etc.) to be able to access MDweb 2.
  • Step 4: Setting PostgreSQL connection parameters: name and password of the PostgreSQL superuser
  • Step 5: Configuring access to the MDweb database holding the metadata (required) and the thesaurus database (optional). The database holding the thesaurus has to be a MDweb 1.x thesaurus database.

    Warning

    Icon

    The PostgreSQL accounts specified here should be valid and have database creation rights.

  • Step 6: Installing the components selected in step 3 in the directory specified in step 2
  • Step 7: Installation complete

1.1.3 After installation 

You can verify the proper functioning of the application server at the url http://localhost:8080/ and of MDweb2 at http://localhost:8080/mdweb2/

1.1.3.1 Starting the Tomcat application server

In case the application server did not start, you can start it manually:

- Under Windows :

In the $INSTALL_DIR/tomcat/bin/ directory, run the command: 

To shut down Tomcat:

- Under Linux

In the $INSTALL_DIR/tomcat/bin/ directory, run the command: 

To shut down Tomcat:

For additional information, consult Apache Tomcat online documentation.

1.1.3.2 PostgreSQL configuration

Set your initial configuration to ensure access to your databases, change the authentication method to md5 (or other). Restart the database server.

 1.1.3.3 MDweb configuration files

The path to the configuration files is: 

  • under Windows:  [volume name]:\Documents and Settings[user]\Application Data\Sicade
  • under Linux: /home/[user]/.sicade
  • under Mac OSX: /Users/[user]/.sicade

Be Careful

Icon

[user] is the user which is owner of tomcat process. It can be tomcat user or root or anything else. 

Configuration files created during installation are: 

For the MDweb search client:
  • mdweb/search/config.properties: Contains the parameters for connecting to the MDweb2 database, the activation of multi lingual support and to the optional thesaurus database
  • mdweb/search/cswdefaultSet.properties: Contains the catalog services included by default in the MDweb search client, remote search tab > Who?
  • mdweb/search/map-context.xml:  Contains the parameters of the WMS server which serves as the cartographical background for the MDweb search client

    Warning

    Icon

    between version 2.0.1 and 2.0.4, the map-context.xml files changes and errors occurs if you don't update it on the newer version. see 1.2 Manual install.

For MDweb administration:
  • mdweb/admin/AdministrationConfiguration.xml: Holds the default parameters for MDweb administration. The default account to connect to the MDweb data base is user: admin, password: adminadmin
For the web catalog service (CSW)
  • csw_configuration/cascading.properties: Holds the names and URLs of web catalog services which will be queried in turn from the MDweb CSW of your installation
  • csw_configuration/config.xml: Contains the parameters for connecting to the MDweb2 database which will be connected to the web catalog service

1.1.4 Installation problems

Be Careful

Icon

If your installation has failed and you want to reattempt installation of MDweb on the same computer, you will need to uninstall it first. Use the uninstaller available in the installation directory. You should then manually delete the configuration files in the .sicade or Sicade directory; they are not deleted automatically during uninstallation.

Consult this site's FAQ for help in resolving problems.

  • No labels