ua1zbe
/
aprsc
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update INSTALLING & CONFIGURATION documents to contain CentOS things

This commit is contained in:
Heikki Hannikainen 2012-10-01 19:01:12 +03:00
parent cb10b53a93
commit da465f6677
2 changed files with 63 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
doc/CONFIGURATION.md
View File

@ -6,9 +6,10 @@ Command line parameters and startup
--------------------------------------
aprsc understands a few command line parameters. On Ubuntu/Debian derived
systems these go to /etc/default/aprsc, on other systems they go in the init
script starting up the software. Shown here are the settings installed by
default when installing aprsc from a binary package.
systems these go to /etc/default/aprsc, on Fedora they go to
/etc/sysconfig/aprsc, and on other systems they go in the init script
starting up the software. Shown here are the settings installed by default
when installing aprsc from a binary package.
* `-u aprsc` - switch to user 'aprsc' as soon as possible
* `-t /opt/aprsc` - chroot to the given directory after starting

59
doc/INSTALLING.md
View File

@ -6,6 +6,10 @@ aprsc is "officially" "supported" on the following platforms:
* Debian stable (6.0, "squeeze"): i386 and x86_64
* Ubuntu LTS (10.04, 12.04): i386 and x86_64
* CentOS 6: i386 and x86_64
The i386 builds actually require an i686 (Pentium 2 class) CPU or
anything newer than that.
These platforms are the easiest to install, and upgrades happen
automatically using the mechanisms provided by the operating system. One or
@ -104,3 +108,58 @@ automatically start up when the system boots. You'll find it's log file in
/opt/aprsc/logs/aprsc.log. Log rotation is already configured in
aprsc.conf.
CentOS: Installing using yum
-------------------------------
This installation procedure has only been tested on CentOS 6.3. It should
probably work from 6.0 to 6.3, on both i386 and x86_64 platforms.
The following commands assume you're running them as a regular user, and the
sudo tool is used to run individual commands as root. sudo will ask you for
your password.
As the first step, please configure aprsc's package repository in yum by
downloading the .repo configuration file and installing it. The first
command installs curl (if you don't have it already), and the second command
uses curl to download the repository configuration to the right place.
sudo yum install curl
sudo curl -o /etc/yum.repos.d/aprsc.repo http://he.fi/aprsc/down/aprsc-centos.repo
Then, install aprsc:
sudo yum install aprsc
Whenever a new aprsc version is available, the upgrade can be performed
automatically by running the upgrade command. Your operating system can
also be configured to upgrade packages automatically, or instruct you to
upgrade when upgrades are available.
sudo yum upgrade
If aprsc upgrades happen very often (many times per day), you might have to
tell yum to expire it's cache before executing the upgrade command:
sudo yum clean expire-cache
Before starting aprsc edit the configuration file, which can be found in
/opt/aprsc/etc/aprsc.conf. Please see the [CONFIGURATION](CONFIGURATION.html)
document for instructions.
To enable startup, edit /etc/sysconfig/aprsc and change STARTAPRSC="no" to
"yes". There should not be any need to touch the other options at this time.
Start it up:
sudo /etc/init.d/aprsc start
To shut it down:
sudo /etc/init.d/aprsc stop
When STARTAPRSC is set to YES in the /etc/sysconfig/aprsc file it will
automatically start up when the system boots. You'll find it's log file in
/opt/aprsc/logs/aprsc.log. Log rotation is already configured in
aprsc.conf.