AidaVOWS2009SoftwareLinux < EuroVOAIDA/AidaVOWS2009

EuroVOAIDA/AidaVOWS2009 Web>AidaVOWS2009SoftwareLinux (18 Jun 2009, AurelienStebe) (raw view)

---+ Preparation steps for Linux

Any recent Linux distribution is supported and should work with the following steps.

---++ Initial set-up steps

First, open a new terminal window and make sure you are running the BASH shell by typing : ==bash== <BR/>
Create a new working directory inside which you will install all the workshop software : ==mkdir {MY_WORKING_DIRECTORY}==

Then, copy all the software from the workshop DVD in your welcome package (=/DVD/Software/Linux/=) <BR/>
or from the [[http://esavo.esac.esa.int:8080/AIDAWS09/DVD/Software/Linux/][online DVD on our server]] to your new working directory.

Finally, move inside your working directory : ==cd {MY_WORKING_DIRECTORY}==

---++ Java JDK installation

Start the Java JDK installation and accept the license terms : ==sh jdk-6u14-linux-i586.bin==

---++ Tomcat installation

Unpack the Tomcat application : ==tar xvfz apache-tomcat-6.0.20.tar.gz==

---++ Tomcat configuration

Replace the following portion from the =apache-tomcat-6.0.20/conf/tomcat-users.xml= configuration file :
<verbatim>
<tomcat-users>
<!--
  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <user username="tomcat" password="tomcat" roles="tomcat"/>
  <user username="both" password="tomcat" roles="tomcat,role1"/>
  <user username="role1" password="tomcat" roles="role1"/>
-->
</tomcat-users>
</verbatim>
... with this (insert an actual password instead of {MY_PASSWORD}, =admin= will do fine) :
<verbatim>
<tomcat-users>
  <role rolename="admin"/>
  <role rolename="manager"/>
  <user username="admin" password="{MY_PASSWORD}" roles="admin,manager"/>
</tomcat-users>
</verbatim>

---++ Apache Ant installation

Unpack the Apache Ant application : ==tar xvfz apache-ant-1.7.1-bin.tar.gz==

---++ !PostGreSQL installation

Start the !PostGreSQL installation and follow the wizard steps : ==sudo sh postgresql-8.3.7-1-linux.bin==

Note that you will need to input your machine root password to realize this installation. <BR/>
You do not need to modify any of the proposed configuration options except to introduce a password for the =postgres= user.

---++ Perl check & installation

You should already have a recent version of Perl installed; check the version number by typing : ==perl -version== <BR/>
If Perl is not already installed or the version is inferior to =version 5=, use the !ActivePerl distribution included on the workshop DVD. Ask a tutor if you encounter any issue in the process.

---++ Environment variables set-up

Save the following text file inside your working directory and edit it : [[%ATTACHURL%/workshop.env][workshop.env]]

If you followed the preceding instructions, using the supplied software versions, you only need to edit the =WORK_DIR= environment variable and set it to the full path of your directory. <BR/>
If you used different versions or installation paths, please set correctly the =JAVA_HOME=, =TOMCAT_HOME= and =ANT_HOME= environment variables.

Finally, load the edited environment config file : ==source workshop.env==

Remember that every time you open a new terminal window for the workshop tutorials, you need to make sure you are running BASH : ==bash== <BR/>
... and load the environment config file : ==source /home/user/work_dir/workshop.env==

---++ Testing the workshop set-up

To test the Java JDK installation run : ==javac -version== <BR/>
You should get : ==javac 1.6.0_14==

To test the Tomcat installation run : ==startup.sh== <BR/>
You should get : <BR/>
==Using CATALINA_BASE:   /home/user/work_dir/apache-tomcat-6.0.20== <BR/>
==Using CATALINA_HOME:   /home/user/work_dir/apache-tomcat-6.0.20== <BR/>
==Using CATALINA_TMPDIR: /home/user/work_dir/apache-tomcat-6.0.20/temp== <BR/>
==Using JRE_HOME:       /home/user/work_dir/jdk1.6.0_14==

Open [[http://localhost:8080/manager/html][http://localhost:8080/manager/html]] with your browser, it should ask you for your Tomcat manager username and password, and then give you the list of installed Tomcat !WebApps.

Don't forget to stop the Tomcat server : ==shutdown.sh==

To test the Apache Ant installation run : ==ant -version== <BR/>
You should get : ==Apache Ant version 1.7.1 compiled on June 27 2008==

To test the !PostGreSQL installation use the =Start server=, =SQL Shell= and =Stop server= you should find in the =PostgreSQL= sub-menu of your =Applications= menu.

If all went well, congratulations you are set and ready for the workshop tutorials. <BR/>
If you encountered any problem, please ask for help from any of the tutors during the Monday morning "set-up session for participants".

Attachments

Topic attachments
I	Attachment	History	Action	Size	Date	Who	Comment
env	workshop.env	r1	manage	0.5 K	18 Jun 2009 - 09:31	AurelienStebe

Topic revision: r3 - 18 Jun 2009 - AurelienStebe

EuroVOAIDA/AidaVOWS2009

Copyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback