2023-06-23 Fred Gleason <fredg@paravelsystems.com>

* Updated the 'INSTALL' file to cover use of the 'configure_build.sh'
	script.

Signed-off-by: Fred Gleason <fredg@paravelsystems.com>
This commit is contained in:
Fred Gleason
2023-06-23 16:01:39 -04:00
parent d247672a3e
commit 6e5c13fc38
2 changed files with 21 additions and 23 deletions

View File

@@ -24257,3 +24257,6 @@
* Incremented the Python API version to 4.0.2. * Incremented the Python API version to 4.0.2.
2023-06-23 Fred Gleason <fredg@paravelsystems.com> 2023-06-23 Fred Gleason <fredg@paravelsystems.com>
* Added a 'configure_build.sh' script. * Added a 'configure_build.sh' script.
2023-06-23 Fred Gleason <fredg@paravelsystems.com>
* Updated the 'INSTALL' file to cover use of the 'configure_build.sh'
script.

41
INSTALL
View File

@@ -144,11 +144,7 @@ capture. Available at http://www.twolame.org/.
DOCUMENTATION DOCUMENTATION
------------- -------------
The larger pieces of the Rivendell documentation are written in XML-DocBook5. The larger pieces of the Rivendell documentation are written in XML-DocBook5.
Pre-generated docs are included in the source tarball, so special tools will The following tools are required to build them:
not normally be required to view or install them. However, if you need to
rebuild them (either because you've modified the DocBook sources or are
installing from the primary GitHub repository), then you will need the
following:
XML-DocBook5 Stylesheets. Available at XML-DocBook5 Stylesheets. Available at
http://sourceforge.net/projects/docbook/. You will also need to create a http://sourceforge.net/projects/docbook/. You will also need to create a
@@ -164,6 +160,9 @@ http://xmlsoft.org/XSLT/xsltproc2.html
Apache FOP. Formatting Objects (FO) processor. Available at Apache FOP. Formatting Objects (FO) processor. Available at
https://xmlgraphics.apache.org/fop/. https://xmlgraphics.apache.org/fop/.
For a list of the required set of development packages for various popular
distros, see the 'DISTRO-SPECIFIC NOTES' section, below.
INSTALLATION INSTALLATION
There are three major steps to getting a Rivendell system up and There are three major steps to getting a Rivendell system up and
running. They are: running. They are:
@@ -196,16 +195,18 @@ documentation that accompanies the server itself.
Once the prerequisites are set up, installation is most often a matter of Once the prerequisites are set up, installation is most often a matter of
cd'ing to the top of the Rivendell source tree and typing cd'ing to the top of the Rivendell source tree and typing
'./configure', 'make', followed (as root) by 'make install'. Those './configure_build.sh', 'make', followed (as root) by 'make install'. The
who obtained the source via CVS will need to do './autogen.sh' first. 'configure_build.sh' will attempt to determine which distribution is
running and automatically invoke the './configure' script with the
The ./configure script will auto-detect what sound drivers (HPI, JACK appropriate arguments. Should 'configure_build.sh' fail to recognize
or ALSA) are available and enable build support accordingly. To override the distro environment, './configure' can be run directly. Do
this behavior, it's possible to specify '--disable-hpi', './configure --help' for a list of the available arguments. This script
'--disable-jack' or '--disable-alsa' as an argument to './configure'. will auto-detect what sound drivers (HPI, JACK or ALSA) are available and
Be sure to see the important additional information regarding enable build support accordingly. To override this behavior, it's possible
configuration in the 'docs/JACK.txt' or 'docs/ALSA.txt' files if you to specify '--disable-hpi', '--disable-jack' or '--disable-alsa' as an
plan on using those sound driver architectures. argument to './configure'. Be sure to see the important additional
information regarding configuration in the 'docs/JACK.txt' or 'docs/ALSA.txt'
files if you plan on using those sound driver architectures.
The installation of Rivendell's web services components are controlled The installation of Rivendell's web services components are controlled
by two parameters passed to 'configure', as follows: by two parameters passed to 'configure', as follows:
@@ -215,14 +216,8 @@ by two parameters passed to 'configure', as follows:
--sysconfdir Location to install Apache configuration --sysconfdir Location to install Apache configuration
The specific values to pass will vary widely depending upon the specific The specific values to pass will vary widely depending upon the specific
distro in question. Some known good values (assuming a default Apache distro in question. For some specific examples for various popular distros,
setup): see the 'DISTRO-SPECIFIC NOTES' section below.
RHEL 5: --libexecdir=/var/httpd/rd-bin --sysconfdir=/etc/httpd/conf.d
RHEL 6/7: --libexecdir=/var/www/rd-bin --sysconfdir=/etc/httpd/conf.d
SuSE: --libexecdir=/srv/www/rd-bin --sysconfdir=/etc/apache2/conf.d
After doing 'make install', be sure to restart the Apache web service. After doing 'make install', be sure to restart the Apache web service.