Changeset 3350


Ignore:
Timestamp:
May 19, 2007, 9:56:35 AM (14 years ago)
Author:
Jari Häkkinen
Message:

Addresses #516. Upgrade and installation done.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/src/docbook/admindoc/installation_upgrade.xml

    r3339 r3350  
    120120        <listitem>
    121121          <para>
    122             There are severeal ways to download BASE. Please refer to
     122            There are several ways to download BASE. Please refer to
    123123            section <xref linkend="resources.home_page.download"/> for
    124124            information on downloading BASE, and select the item
     
    145145                  the downloaded file with <command>tar zxpf
    146146                  base-...src.tar.gz</command>. Change to the new
    147                   direcotry, and issue <command>ant
     147                  directory, and issue <command>ant
    148148                  package.bin</command>. This will create a binary
    149149                  package in the current directory. Unpack this new
     
    161161                  to <ulink
    162162                  url="http://base.thep.lu.se/chrome/site/doc/development/build.html">the
    163                   builing BASE document</ulink> for information on
     163                  building BASE document</ulink> for information on
    164164                  this download option.
    165165                </para>
     
    346346                  PostgreSQL 8.0 seems to be working very well with
    347347                  BASE and Hibernate. Download and install PostgreSQL,
    348                   avaialble from
     348                  available from
    349349                  <ulink url="http://www.postgresql.org/" />. you must
    350350                  edit
     
    535535          <para>
    536536            <emphasis>Optional but recommended.</emphasis> You may want
    537             ot modify extended properties to fit your needs. Extended
     537            to modify extended properties to fit your needs. Extended
    538538            properties are defined in
    539539            <filename>/path/to/base/www/WEB-INF/classes/extended-properties.xml</filename>.
     
    552552            <filename class="directory">/path/to/base/bin</filename>
    553553            and run <filename>initdb.sh</filename> as <programlisting>
    554 ./initdb.sh base_root_passwordh password
     554./initdb.sh base_root_password password
    555555</programlisting>
    556556            <important>
     
    569569
    570570      <varlistentry>
    571         <term></term>
    572         <listitem>
    573           <para>
    574           </para>
    575         </listitem>
    576       </varlistentry>
     571        <term>BASE and tomcat</term>
     572        <listitem>
     573          <para>
     574            Either move the <filename
     575            class="directory">/path/to/base/www</filename> directory
     576            to the tomcat <filename class="directory">webapps</filename>
     577            directory or create a symbolic link from the tomcat
     578            <filename class="directory">webapps</filename> directory to
     579            the <filename class="directory">/path/to/base/www</filename>
     580            directory <programlisting>
     581cd /path/to/tomcat/webapps
     582ln -s /path_to_base/www base2
     583</programlisting>
     584            Start/restart tomcat, and try http://hostname:8080/base2
     585            (change <emphasis>hostname</emphasis> to your hostname) in
     586            your favourite browser. BASE log-in page should appear
     587            after a few seconds.
     588          </para>
     589        </listitem>
     590      </varlistentry>
     591
     592      <varlistentry>
     593        <term>BASE, apache, and apache/tomcat connector</term>
     594        <listitem>
     595          <para>
     596            <emphasis>This step is optional</emphasis>.
     597          </para>
     598          <para>
     599            If you want run the tomcat server through the apache web
     600            server, you need to install the apache version 2 web
     601            server, available
     602            from <ulink
     603            url="http://www.apache.org/">http://www.apache.org/</ulink>,
     604            and a apache-tomcat connector, available
     605            from <ulink
     606            url="http://jakarta.apache.org/tomcat/connectors-doc/index.html">http://jakarta.apache.org/tomcat/connectors-doc/index.html</ulink>.
     607            So, we got you there;-) To be honest, this step is not
     608            really well documented since we previously used SuSE 9.3
     609            on our demo/test server, and apache/tomcat/mod_jk comes
     610            pre-installed. The current server does not use the
     611            apache/tomcat connector. What you need to do is something
     612            like this
     613            <itemizedlist>
     614              <listitem>
     615                Get that tomcat server running in stand-alone
     616                mode.
     617              </listitem>
     618              <listitem>
     619                Get the apache 2 server running.
     620              </listitem>
     621              <listitem>
     622                Install mod_jk. Note, different version are used for
     623                apache 1.3 and 2. In SuSE 9.3 this step is done by
     624                installing <filename>mod_jk-ap20</filename>.
     625              </listitem>
     626              <listitem>
     627                Create a <filename>workers.properties</filename> file
     628                in the
     629                tomcat <filename class="directory">base</filename>
     630                directory (commonly copied from a template).
     631              </listitem>
     632              <listitem>
     633                Create a <filename>jk.conf</filename> file in the
     634                apache <filename class="directory">conf</filename>
     635                directory (commonly copied from a template), and make
     636                sure that <emphasis>jk</emphasis> is added to the
     637                modules to be loaded when apache starts.
     638              </listitem>
     639              <listitem>
     640                In <filename>jk.conf</filename> add the lines below
     641                and change paths appropriately. <programlisting>
     642# The following lines makes apache aware of the location of
     643# the /base2 context
     644Alias /base2 "/srv/www/tomcat5/base/webapps/base2"
     645&lt;Directory "/srv/www/tomcat5/base/webapps/base2"&gt;
     646Options Indexes FollowSymLinks
     647allow from all
     648&lt;/Directory&gt;
     649# The following lines mounts all base2 jsp files to tomcat
     650JkMount /base2 ajp13
     651JkMount /base2/* ajp13
     652# The following lines prohibits users from directly accessing WEB-INF
     653&lt;Location "/base2/WEB-INF/"&gt;
     654AllowOverride None
     655deny from all
     656&lt;/Location&gt;
     657</programlisting>
     658              </listitem>
     659            </itemizedlist>
     660            You must restart the apache and the tomcat server after above steps.
     661          </para>
     662        </listitem>
     663      </varlistentry>
     664
     665      <varlistentry>
     666        <term>Setup done!</term>
     667        <listitem>
     668          <para>
     669            Happy BASEing. Now you can log on to your BASE 2 server as
     670            user <emphasis>root</emphasis> (use
     671            the <emphasis>base_root_password</emphasis> from the
     672            database initialization step above). You should begin with
     673            creating a couple user accounts, for more information on
     674            how to create user accounts please refer to
     675            <xref linkend="user_administration"/>.
     676          </para>
     677        </listitem>
     678      </varlistentry>
     679
    577680    </variablelist>
    578 
    579681
    580682  </sect1>      <!-- Installation instructions -->
Note: See TracChangeset for help on using the changeset viewer.