2.2. OpenSUSE 11

Introduction

This page explains how to install and configure all pre-requisites for OpenSUSE 11, configure a firewall on the GRIA server machine and set-up Tomcat for or deployment of a GRIA war.

Software Prerequisites

This page describes how the prerequisites for SuSE can be installed using the YaST systems configuration tool. They are as follows:

• The Java SDK v1.6.0 (6.0) or higher
  • java-1_6_0-sun
  • java-1_6_0-sun-devel
• Jakarta Tomcat 6
  
  • tomcat6-admin-webapps
  • tomcat6-webapps
• Apache Server v2.2 (an optional package to provide secure access)
  • apache2
  • apache2-prefork
  • apache2-mod_jk
    
• A web browser, such as Firefox (can be installed on a different machine)
  • MozillaFirefox
• A sample application (only required for the GRIA Basic Application Services package)
  • ImageMagick

You can use either Tomcat or Apache to provide secure access. If you are unsure then choose Tomcat as it is easier to set up.

In order to provide some synchronisation between the clocks on machines that the various GRIA packages are installed on, it is recommended that you run an NTP client that will synchronise your system with an Internet time server. Having installed the Linux base platform, configure the Network Services to use an NTP server. This is done as follows:

1. Run YaST and select 'Network Services'
2. From here, choose 'NTP Client' (or 'NTP Configuration') and select an NTP server, setting it to start on boot up. If you don't have an NTP server available on your local network then select a public one e.g. a.ntp.alphazed.net in Great Britain.

Having configured the machine to use NTP, the system should then be restarted to ensure the changes made during the installation of the above pre-requisites are applied.

This completes the installation of the GRIA software prerequisites.

Configuring the Firewall

The deployed GRIA war (or webapp) should be hosted behind a firewall to ensure that your server can only be accessed on certain ports. You should consult with your systems administrator to determine if you need to run a firewall on the machine hosting the GRIA webapp. If so, configure the firewall as follows:

1. Run YaST
2. Click on Security and Users.
3. Click on Firewall.
4. Select Interfaces from the menu and set interfaces appropriate to you network. You may need to discuss this with your systems administrator.
5. Select Allowed Services from the menu, then:
   • add a HTTPS server.
   • add a HTTP server.
   • Use the Advanced button to add TCP port 8080. If you intend to use Tomcat for secure access then also add port the 8443.
   • if you require Secure Shell access then also add SSH.
6. Click on Next and then Accept to finalise the settings.
7. Start the firewall.

Set-up Tomcat Users

In order to deploy the war file, the Tomcat Manager for application deployment will be used. The Tomcat manager functions are disabled by default.

To enable Tomcat administration and management we must add a role and a tomcat user to the tomcat-users.xml file.

1. Open the /etc/tomcat6/tomcat-users.xml file with a suitable editor and add this element, replacing ADMIN_PASSWORD with an appropriate password:

   <user username="admin" password="ADMIN_PASSWORD" roles="manager"/>
   

2. Save the file.

Start Tomcat

To start Tomcat:

$ su
# /etc/init.d/tomcat6 start

To stop Tomcat:

$ su
# /etc/init.d/tomcat6 stop

To restart Tomcat:

$ su
# /etc/init.d/tomcat6 restart

To get the status of Tomcat:

$ su
# /etc/init.d/tomcat6 status

Test it with your browser by pointing to your machine URL ( http://<host IP>:8080). You should be able to access your Tomcat server home page.

Next: Fedora Previous: Windows