DocWiki2.4: LinuxFedoraCore4Cookbook

Edit
More...

Introduction#

This page is intended to show how to setup a JSPWiki server from scratch. Some of the features are shown here but they are already documented in other areas of this site.

Overview#

This cookbook will cover:

Versions covered in this document:

Notes On Your Install Of Fedora Core 4#

I didn't install the developer packages, Java, or Tomcat. Most of the documentation on JSPWiki is indipendant of OS and distribution, so I didn't use the default installation of tomcat. I also didn't need to update the system for this install to work. And when I did, everything still worked, but still use caution when updating your system once you have it configured.

Installing Sun Java 5#

Open a browser and go to the download page.
Accept the license agreement and click on continue
Under the linux platform select the Linux self-extracting file (15.80mb bin file)
Make sure that the downloaded file is exicutable by:
1. Right click on the file and choosing properties.
2. Click on the permissions tab.
3. Make sure that the three "Execute" checkboxes are checked.
4. Click the Close button.
Open a terminal
Goto the directory that the file is located and type:

./jdk-1_5_0_07-linux-i586.bin

When typing the file name you can hit the TAB key and the terminal will fill in the rest of the filename or directory name. 6. Move the new folder to the /opt/ directory by typing:

mv jdk1.5.0_07 /opt/

7. Create a script that will set the java environment variables by typing:

gedit /etc/profile.d/java.sh

8. Add the following lines to the file:

export JAVA_HOME=/opt/jdk1.5.0_07
export PATH=$JAVA_HOME/bin:$PATH

9. Click on save to save the file and close gedit.

10. In the terminal type:

source /etc/profile.d/java.sh

The oput should be a blank line.
To test to see if it worked type:

echo $JAVA_HOME

and the output should be:

/opt/jdk1.5.0_07

11. Then type:

/usr/sbin/alternatives --install /usr/bin/java java /opt/jdk1.5.0_07/bin/java 2

12. Then type:

/usr/sbin/alternatives --config java

The output will be:

 There are 2 programs which provide 'java'.
Selection Command
-----------------------------------------------
*1 /usr/lib/jvm/jre-1.4.2-gcj/bin/java
+2 /opt/jdk1.5.0_07/bin/java
Enter to keep the current selection[+], or type selection number:

13. Type 2 and hit enter. To check to see if it worked, type:

/usr/sbin/alternatives --display java

The output should be:

java - status is manual.
link currently points to /opt/jre1.5.0_06/bin/java
/usr/lib/jvm/jre-1.4.2-gcj/bin/java - priority 1420
slave rmiregistry: /usr/lib/jvm/jre-1.4.2-gcj/bin/rmiregistry
slave jre_exports: /usr/lib/jvm-exports/jre-1.4.2-gcj
slave jre: /usr/lib/jvm/jre-1.4.2-gcj
/opt/jdk1.5.0_07/bin/java - priority 2
slave rmiregistry: (null)
slave jre_exports: (null)
slave jre: (null)
Current `best' version is /usr/lib/jvm/jre-1.4.2-gcj/bin/java.

Installation of Sun Java 5 is complete.

Installing Apache Tomcat#

Installation#

Download the core file from the Apache Tomcat website.

Open the compressed file and extract it to /opt
Optional: Create a link to /opt/apache-tomcat-5.5.17 in /opt This will make things a bit easier to type and document
1. Open a terminal and login as su
2. Type:

ln /opt/tomcat /opt/apache-tomcat-5.5.17

Testing#

Open a terminal
Login as su
Type:

sh /opt/tomcat/bin/startup.sh

The response should be:

Using CATALINA_BASE:   /opt/tomcat
Using CATALINA_HOME:   /opt/tomcat
Using CATALINA_TMPDIR: /opt/tomcat/temp
Using JRE_HOME:       /opt/jdk1.5.0_07

4. Open a browser and go to this address:

http://localhost:8080/

The default apache tomcat webpage should be displayed.

Further configuration#

Launch apache at startup#

To have the startup.sh script run at startup:

Open a terminal and login as su
Type:

gedit /etc/rc.d/rc.local

3. Add the following line to the end of the file:

sh /opt/tomcat/bin/startup.sh

4. Optional: By default SELinux is enabled and you may need to use the following command to allow the script to be run:

chcon -t initrc_exec_t /opt/tomcat/bin/startup.sh

Open ports in your firewall#

If you do have iptables running you will need to poke some holes in your firewall so that others will be able to get to your site. It would make sense to do this when your JSPWiki installation is complete.

Click on the Desktop menu
Goto Desktop->System Settings->Security Level
Make sure that the "Security Level" drop down menu is set to "Enable Firewall"
In the Trusted Service group make sure that the checkbox for "WWW (HTTP)" is checked. Instead of checking that checkbox, you can also type the following into the other ports edit box: