Project

General

Profile

Revision 3066

Added by perry almost 15 years ago

Added some install docs specific to ubuntu and windows setups

View differences:

docs/user/metacatinstall.html
639 639
   Apache you will probably have to type
640 640
   <pre>http://yourserver.yourdomain.com:8080/yourcontext/</pre>
641 641
  </p>
642

  
643
  <h2> Operating System Specific Instructions </h2>
644
  <p> These documents are meant to outline the metacat installation process on specific platforms. They are <strong><em>not</em></strong> a substitute for the above instructions and only meant as a supplemental guideline. </p>
645
  <ul>
646
    <li> <a href="os_specific/install_metacat_windows.txt">Installing from CVS source on Windows XP</a> </li>
647
    <li> <a href="os_specific/install_metacat_ubuntu.txt">Installing on Ubuntu 6.06 (ie Dapper Drake)</a> </li>
648
  </ul>
642 649
</td>
643 650
</tr>
644 651
</table>
docs/user/os_specific/install_metacat_ubuntu.txt
1
Installing Metacat on Ubuntu
2

  
3
Assumes you have the base ubuntu distribution set up already.
4

  
5
* Add the extra repositories to your apt sources list. 
6
    sudo gedit /etc/apt/sources.list
7
    # add universe and multiverse to the following lines
8
       deb http://us.archive.ubuntu.com/ubuntu/ dapper main restricted universe multiverse
9
       deb-src http://us.archive.ubuntu.com/ubuntu/ dapper main restricted universe multiverse
10
    sudo apt-get update
11

  
12
* Install the ubuntu package dependencies
13
    sudo apt-get install tomcat5-webapps postgresql-server-dev-8.1 postgresql-8.1 sun-java5-jdk \
14
                         apache2 cvs 
15

  
16
* Tell the ubuntu system to use the java jdk 
17
    sudo update-java-alternatives -s java-1.5.0-sun
18

  
19
    sudo vi /etc/default/tomcat5
20
      JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun
21
      .......
22
      CATALINA_OPTS="-Djava.awt.headless=true -Djava.util.prefs.syncInterval=2000000 -Xmx512M -server"
23
      ....
24
      TOMCAT_SECURITY=no
25

  
26
    sudo /etc/init.d/tomcat5 restart
27

  
28
* Download metacat from CVS and set up utilites     
29
    
30
    mkdir ~/workspace; cd ~/workspace
31
    cvs -d:ext:perry@cvs.ecoinformatics.org:/cvs co metacat
32
    cvs -d:ext:perry@cvs.ecoinformatics.org:/cvs co utilities
33
    cd utilities
34
    ant clean jar
35
    cd ../metacat
36

  
37
* prep postgres
38

  
39
    # Setting up the postgres metacat db
40
    sudo vi /etc/postgresql/8.1/main/pg_hba.conf
41
    # add 
42
      host metacat metacat 127.0.0.1 255.255.255.255 password
43
    sudo su postgres
44
    createdb metacat
45
    psql -d metacat
46
      create user metacat with unencrypted password 'metapass';
47
      \q
48
    exit
49

  
50
    #restart postgres
51
    sudo /etc/init.d/postgresql-8.1 restart
52
 
53
    # TEST
54
    psql -U metacat -W -h localhost metacat
55

  
56
* Build
57
   sudo touch /var/lib/tomcat5/webapps/knb.war
58
   sudo chown perry /var/lib/tomcat5/webapps/knb.war
59
   cd ~/workspace/metacat
60
   cp build.properties default.build.properties
61
   # Edit build.properties 
62
   vi lib/metacat.properties
63

  
64
   #change
65
     onlySecureLDAPConnection=false
66
   # TODO set up the certificate *********
67

  
68
   ant clean install
69
   # may need to give cvs password a few times on the first build
70

  
71
* Postgres configuration
72
   psql -U metacat -W -h localhost -f build/src/xmltables-postgres.sql metacat
73
   ant register-schemas
74

  
75
* apache / tomcat integration
76
    #the instructions at http://www.ubuntuforums.org/showthread.php?t=219985 cover this pretty well
77
    #remember to add the 'knb' servlet context
78
 
79
* Make sure metacat_data and metacat_inline_data folders are readable/writable by tomcat user
80

  
0 81

  
docs/user/os_specific/install_metacat_windows.txt
1
Building Metacat from cvs on Windows XP
2
Matthew Perry
3
10/24/2006
4

  
5
Note: This is not intended to be a complete, step-by-step tutorial but rather a general overview of the process along with some specific "gotchas" that I encountered along the way.
6

  
7
===============
8

  
9
Download and Install via the standard windows installers:
10
  Postgresql 8.1
11
  Java 1.5 JDK
12
  TortiseCVS 
13

  
14
Download Tomacat5.5 windows installer and install to C:\tomcat5 (or another directory w/out spaces)
15

  
16
Download ant 1.6.5-bin and extract to C:\ant
17

  
18
Set environment variables (ctl panel > System > Advanced > Environment Variables). 
19
 ANT_HOME => C:\ant
20
 JAVA_HOME => C:\Program_Files\jdk1.5.0_09
21
 PATH => { THE EXISTING PATH };C:\Program_Files\jdk1.5.0_09\bin;C:\ant\bin;C:\Program Files\TortoiseCVS
22
 CVS_RSH => C:\Program Files\TortoiseCVS\TortoisePlink
23

  
24
Use pgadmin to 
25
* Create a new user named 'metacat'
26
* Create a new database named 'metacat', owned by user 'metacat',  with UTF8 Encoding
27

  
28
Download the cvs version of metacat
29
    cd c:\worskpace
30
    cvs -d:ext:{ USER }@cvs.ecoinformatics.org:/cvs co metacat
31
    cvs -d:ext:{ USER }@cvs.ecoinformatics.org:/cvs co utilities
32
    cd metacat
33

  
34
Adjust build.properties
35
  # Tomcat Properties
36
  tomcat=C:/tomcat5
37
  deploy.dir=C:/tomcat5/webapps
38

  
39
  # Server Properties
40
  config.hostname=localhost
41
  config.port=8080
42

  
43
  # Metacat database user and password and location of file stores
44
  user=metacat
45
  password=metapass
46
  datafilepath=C:/workspace/metacat-data
47
  inlinedatafilepath=C:/workspace/metacat-inline-data
48

  
49
  # give username for CVS access to retrieve latest EML
50
  cvsroot=:ext:perry@cvs.ecoinformatics.org:/cvs
51

  
52
Run 
53
  ant clean install 
54

  
55
Create tables
56
  "C:\Program Files\PostgreSQL\8.1\bin\psql.exe" -U metacat -W -h localhost -f build/src/xmltables-postgres.sql metacat
57

  
58
Register schemas with metacat db
59
  ant register-schemas
60

  
61
If all went well, you should be able to point your browser to http://localhost:8080/knb and see the default metacat skin
62

  
63

  
64

  
65

  
0 66

  

Also available in: Unified diff