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 $ Author : $Author: maroy $
Version : $Revision: 1.3 $ Version : $Revision: 1.4 $
Location : $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/INSTALL,v $ 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-<version>.tar.bz2
tar xfj livesupport-libraries-<version>.tar.bz2 tar xfj livesupport-libraries-<version>.tar.bz2
cd livesupport-<version> cd livesupport-<version>
./configure
make setup && make compile make setup && make compile
./bin/install.sh -d /usr/local/livesupport -g apache ./bin/install.sh -d /usr/local/livesupport -g apache -r /var/www
ln -s /usr/local/livesupport/var /var/www/livesupport
/usr/local/livesupport/bin/scheduler.sh start /usr/local/livesupport/bin/scheduler.sh start

View file

@ -22,7 +22,7 @@
# #
# #
# Author : $Author: maroy $ # Author : $Author: maroy $
# Version : $Revision: 1.5 $ # Version : $Revision: 1.6 $
# Location : $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/bin/dist.sh,v $ # 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 $docdir $ls_tmpdir
cp -pPR $etcdir $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> href="http://www.gnu.org/licenses/gpl.html">GPL</a>.<br>
<ul> <ul>
<li>Author: $Author: maroy $</li> <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> <li>Location: $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/doc/install.html,v $</li>
</ul> </ul>
<h1>Scope</h1> <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> LiveSupport are (make sure to run at least the <code>./bin/install.sh</code>
script as root):<br> script as root):<br>
<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> <br>
Then try the URL <code>http://localhost/livesupport/htmlUI/var/html/ </code>, 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> 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> </ul>
Please note the user group your apache daemon is running as (usually <code>apache</code> 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 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> <h1>Obtaining LiveSupport sources</h1>
LiveSupport sources come in two different tarballs:<br> LiveSupport sources come in two different tarballs:<br>
<ul> <ul>
@ -180,7 +184,7 @@ LiveSupport.<br>
To compile LiveSupport, enter the LiveSupport directory, and execute To compile LiveSupport, enter the LiveSupport directory, and execute
the following commands:<br> the following commands:<br>
<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> <br>
This will take quite a while, so go have a tea, watch a movie, relax, This will take quite a while, so go have a tea, watch a movie, relax,
etc.<br> 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> above on installing apache). Supply the <code>&lt;apache-group&gt;</code>
value here, as mentioned above, which is usually either <code>apache</code> value here, as mentioned above, which is usually either <code>apache</code>
or <code>www-data</code>.<br> 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> <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 The fully qualified domain name of your system. If the install script
cannot determine your host name correctly, please supply the FQDN via cannot determine your host name correctly, please supply the FQDN via
@ -212,7 +223,7 @@ this parameter.<br>
<br> <br>
Thus a typical invocation of the install script is the following:<br> Thus a typical invocation of the install script is the following:<br>
<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> <br>
The install script has more options, which enable you to customize your The install script has more options, which enable you to customize your
installation of LiveSupport. Note that the defaults are usually quite 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 <li>an ODBC data source named <code>LiveSupport</code>, connecting
to the database of the same name.</li> to the database of the same name.</li>
<li>initialize the database with appropriate tables</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> </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> <h1>Try it out</h1>
After a successful installation, the LiveSupport scheduler has to be After a successful installation, the LiveSupport scheduler has to be
started. The scheduler has a System V runlevel-style startup script, started. The scheduler has a System V runlevel-style startup script,

View file

@ -21,7 +21,7 @@
# #
# #
# Author : $Author: maroy $ # Author : $Author: maroy $
# Version : $Revision: 1.1 $ # Version : $Revision: 1.2 $
# Location : $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/etc/Makefile.in,v $ # Location : $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/etc/Makefile.in,v $
#------------------------------------------------------------------------------- #-------------------------------------------------------------------------------
@ -270,7 +270,6 @@ ifeq (${prefix},)
else else
INSTALL_PREFIX = ${prefix} INSTALL_PREFIX = ${prefix}
endif endif
APACHE_GROUP = @apache_group@
install: setup compile install: setup compile
${INSTALL_COPY_EXE} --directory ${INSTALL_PREFIX} ${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 dnl
dnl Author : $Author: maroy $ 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 Location : $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/etc/configure.ac,v $
dnl----------------------------------------------------------------------------- dnl-----------------------------------------------------------------------------
@ -35,21 +35,12 @@ dnl-----------------------------------------------------------------------------
AC_INIT(LiveSupport, 0.9, bugs@campware.org) AC_INIT(LiveSupport, 0.9, bugs@campware.org)
AC_PREREQ(2.59) AC_PREREQ(2.59)
AC_COPYRIGHT([Copyright (c) 2004 Media Development Loan Fund under the GNU GPL]) 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_CONFIG_SRCDIR(../products/scheduler/src/main.cxx)
AC_PROG_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_CONFIG_FILES(../Makefile:../etc/Makefile.in)
AC_OUTPUT() AC_OUTPUT()

View file

@ -30,7 +30,7 @@ endif
config.status: configure config.status: configure
dh_testdir dh_testdir
# Add here commands to configure the package. # 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 build: build-arch