updated documentation and scripts to reflect master autoconf

This commit is contained in:
maroy 2005-04-22 13:08:55 +00:00
parent cde23c4f0d
commit bd185d17d8
6 changed files with 27 additions and 39 deletions

View file

@ -22,7 +22,7 @@
Author : $Author: maroy $
Version : $Revision: 1.3 $
Version : $Revision: 1.4 $
Location : $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/INSTALL,v $
--------------------------------------------------------------------------------
@ -37,9 +37,9 @@ wget http://livesupport.campware.org/look/campware/download/livesupport-librarie
tar xfj livesupport-<version>.tar.bz2
tar xfj livesupport-libraries-<version>.tar.bz2
cd livesupport-<version>
./configure
make setup && make compile
./bin/install.sh -d /usr/local/livesupport -g apache
ln -s /usr/local/livesupport/var /var/www/livesupport
./bin/install.sh -d /usr/local/livesupport -g apache -r /var/www
/usr/local/livesupport/bin/scheduler.sh start

View file

@ -22,7 +22,7 @@
#
#
# Author : $Author: maroy $
# Version : $Revision: 1.5 $
# Version : $Revision: 1.6 $
# Location : $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/bin/dist.sh,v $
#-------------------------------------------------------------------------------
#-------------------------------------------------------------------------------
@ -209,7 +209,7 @@ cp -pPR $products_dir/* $products_tmpdir
#-------------------------------------------------------------------------------
cp -pPR $docdir $ls_tmpdir
cp -pPR $etcdir $ls_tmpdir
cp -pPR README Makefile $ls_tmpdir
cp -pPR README INSTALL configure $ls_tmpdir
#-------------------------------------------------------------------------------

View file

@ -13,7 +13,7 @@ Development Loan Fund</a>, under the GNU <a
href="http://www.gnu.org/licenses/gpl.html">GPL</a>.<br>
<ul>
<li>Author: $Author: maroy $</li>
<li>Version: $Revision: 1.3 $</li>
<li>Version: $Revision: 1.4 $</li>
<li>Location: $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/doc/install.html,v $</li>
</ul>
<h1>Scope</h1>
@ -36,7 +36,7 @@ Those who think they know everything, the quick steps to install
LiveSupport are (make sure to run at least the <code>./bin/install.sh</code>
script as root):<br>
<br>
<pre><code>wget </code><code></code><code>http://livesupport.campware.org/look/campware</code><code>/download/livesupport-&lt;version&gt;.tar.bz2<br></code><code>wget </code><code></code><code>http://livesupport.campware.org/look/campware</code><code>/download/livesupport-libraries-&lt;version&gt;.tar.bz2<br>tar xfj livesupport-&lt;version&gt;.tar.bz2<br></code><code>tar xfj livesupport-libraries-&lt;version&gt;.tar.bz2<br>cd livesupport-&lt;version&gt;<br>make setup &amp;&amp; make compile<br>./bin/install.sh -d /usr/local/livesupport -g apache<br>ln -s /usr/local/livesupport/var /var/www/livesupport<br>/usr/local/livesupport/bin/scheduler.sh start<br></code></pre>
<pre><code>wget </code><code></code><code>http://livesupport.campware.org/look/campware</code><code>/download/livesupport-&lt;version&gt;.tar.bz2<br></code><code>wget </code><code></code><code>http://livesupport.campware.org/look/campware</code><code>/download/livesupport-libraries-&lt;version&gt;.tar.bz2<br>tar xfj livesupport-&lt;version&gt;.tar.bz2<br></code><code>tar xfj livesupport-libraries-&lt;version&gt;.tar.bz2<br>cd livesupport-&lt;version&gt;<br>./configure<br>make setup &amp;&amp; make compile<br>./bin/install.sh -d /usr/local/livesupport -g apache -r /var/www<br>/usr/local/livesupport/bin/scheduler.sh start<br></code></pre>
<br>
Then try the URL <code>http://localhost/livesupport/htmlUI/var/html/ </code>,
and log in using username: <code>root</code>, password: <code>q</code>.<br>
@ -149,7 +149,11 @@ list</code> and installed by e.g.: <code>pear install DB</code>):</li>
</ul>
Please note the user group your apache daemon is running as (usually <code>apache</code>
or <code>www-data</code>), you will need this information later. Later
on in this document, this group will be referred to as <code>&lt;apache-group&gt;</code>.<br>
on in this document, this group will be referred to as <code>&lt;apache-group&gt;</code>.
Also note the document root directory for your apache installation
(usually <code>/var/www</code> or <code>/var/www/htdocs</code>
or <code>/var/www/&lt;yourhost&gt;/htdocs</code>). Later on in this
document, this directory will be reffered to as <code>&lt;www-root&gt;</code>.<br>
<h1>Obtaining LiveSupport sources</h1>
LiveSupport sources come in two different tarballs:<br>
<ul>
@ -180,7 +184,7 @@ LiveSupport.<br>
To compile LiveSupport, enter the LiveSupport directory, and execute
the following commands:<br>
<br>
<pre><code>cd livesupport-&lt;version&gt;<br>make setup &amp;&amp; make compile<br></code></pre>
<pre><code>cd livesupport-&lt;version&gt;<br>./configure<br>make setup &amp;&amp; make compile<br></code></pre>
<br>
This will take quite a while, so go have a tea, watch a movie, relax,
etc.<br>
@ -205,6 +209,13 @@ The user group the apache web server daemon runs at (see the section
above on installing apache). Supply the <code>&lt;apache-group&gt;</code>
value here, as mentioned above, which is usually either <code>apache</code>
or <code>www-data</code>.<br>
<br>
<pre> -r, --www-root The root directory for web documents served<br> by apache [default: /var/www]<br><br></pre>
The document root of your apache installation (see the section above on
installing apache). Supply the <code>&lt;www-root&gt;</code>
value here, as mentioned above, which is usually <code>/var/www</code>
or <code>/var/www/htdocs</code>
or <code>/var/www/&lt;yourhost&gt;/htdocs.</code>
<pre><code><br> -H, --host The fully qualified host name of the system<br> [default: guess].<br></code><br></pre>
The fully qualified domain name of your system. If the install script
cannot determine your host name correctly, please supply the FQDN via
@ -212,7 +223,7 @@ this parameter.<br>
<br>
Thus a typical invocation of the install script is the following:<br>
<br>
<pre><code>./bin/install.sh -d &lt;ls-installdir&gt; -g &lt;apache-group&gt;</code><br></pre>
<pre><code>./bin/install.sh -d &lt;ls-installdir&gt; -g &lt;apache-group&gt; -r &lt;www-root&gt;</code><br></pre>
<br>
The install script has more options, which enable you to customize your
installation of LiveSupport. Note that the defaults are usually quite
@ -225,22 +236,9 @@ password <code>livesupport</code>.</li>
<li>an ODBC data source named <code>LiveSupport</code>, connecting
to the database of the same name.</li>
<li>initialize the database with appropriate tables</li>
<li>create a symlink into your apache root to point to <code>&lt;ls-installdir&gt;/var</code>.<br>
</li>
</ul>
<h2>Configuring apache</h2>
After a successful run of the installation script, all LiveSupport
files are copied to <code>&lt;ls-installdir&gt;</code>. An additional
manual installation step is required, to make sure that the LiveSupport
web and XML-RPC interfaces are accessible through your apache web
server. LiveSupport expects that the URL <code>http://&lt;yourhost&gt;/livesupport</code>
points to the directory <code>&lt;ls-installdir&gt;/var</code>. To
achieve this, create a symbolic link from your apache document root to
the LiveSupport installation directory:<br>
<br>
<pre><code>ln -s &lt;ls-installdir&gt;/var &lt;apache-docroot&gt;/livesupport<br></code></pre>
<br>
Where <code>&lt;apache-docroot&gt;</code> is dependent on your
installation, but is usually something like <code>/var/www</code> or <code>/var/www/htdocs</code>
or <code>/var/www/&lt;yourhost&gt;/htdocs</code>. <br>
<h1>Try it out</h1>
After a successful installation, the LiveSupport scheduler has to be
started. The scheduler has a System V runlevel-style startup script,

View file

@ -21,7 +21,7 @@
#
#
# Author : $Author: maroy $
# Version : $Revision: 1.1 $
# Version : $Revision: 1.2 $
# Location : $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/etc/Makefile.in,v $
#-------------------------------------------------------------------------------
@ -270,7 +270,6 @@ ifeq (${prefix},)
else
INSTALL_PREFIX = ${prefix}
endif
APACHE_GROUP = @apache_group@
install: setup compile
${INSTALL_COPY_EXE} --directory ${INSTALL_PREFIX}

View file

@ -21,7 +21,7 @@ dnl Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
dnl
dnl
dnl Author : $Author: maroy $
dnl Version : $Revision: 1.1 $
dnl Version : $Revision: 1.2 $
dnl Location : $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/etc/configure.ac,v $
dnl-----------------------------------------------------------------------------
@ -35,21 +35,12 @@ dnl-----------------------------------------------------------------------------
AC_INIT(LiveSupport, 0.9, bugs@campware.org)
AC_PREREQ(2.59)
AC_COPYRIGHT([Copyright (c) 2004 Media Development Loan Fund under the GNU GPL])
AC_REVISION($Revision: 1.1 $)
AC_REVISION($Revision: 1.2 $)
AC_CONFIG_SRCDIR(../products/scheduler/src/main.cxx)
AC_PROG_CXX()
AC_ARG_WITH([apache-group],
[ --with-apache-group specify the system group the apache daemon runs as
defaults to: [apache]],
CONFIG_APACHE_GROUP=${withval}, CONFIG_APACHE_GROUP="apache")
apache_group=${CONFIG_APACHE_GROUP}
AC_MSG_RESULT([using apache daemon group: ${apache_group}])
AC_SUBST(apache_group)
AC_CONFIG_FILES(../Makefile:../etc/Makefile.in)
AC_OUTPUT()

View file

@ -30,7 +30,7 @@ endif
config.status: configure
dh_testdir
# Add here commands to configure the package.
CFLAGS="$(CFLAGS)" ./configure --host=$(DEB_HOST_GNU_TYPE) --build=$(DEB_BUILD_GNU_TYPE) --prefix=/opt/livesupport --with-apache-group=www-data
CFLAGS="$(CFLAGS)" ./configure --host=$(DEB_HOST_GNU_TYPE) --build=$(DEB_BUILD_GNU_TYPE) --prefix=/opt/livesupport
build: build-arch