[LOG] Added lms.conf install

This commit is contained in:
emeric
2016-05-02 23:24:19 +02:00
parent 028a6f8e4c
commit f121c5f439
4 changed files with 21 additions and 10 deletions
+15 -10
View File
@@ -20,7 +20,7 @@ LMS is written entirely in C++. Therefore, it is suitable to run on embedded dev
Please note some media files may require significant CPU usage to be transcoded.
## Dependencies
### Debian or Ubuntu packages
### Debian
```sh
$ apt-get install g++ autoconf automake libboost-dev libboost-locale-dev libboost-iostreams-dev libavcodec-dev libwtdbosqlite-dev libwthttp-dev libwtdbo-dev libwt-dev libmagick++-dev libavcodec-dev libavformat-dev libav-tools libpstreams-dev libcurl-dev libcurlpp-dev libconfig++-dev
@@ -32,7 +32,7 @@ $ apt-get install g++ autoconf automake libboost-dev libboost-locale-dev libboos
$ autoreconf -vfi
$ mkdir build
$ cd build
$ ../configure --prefix=/usr
$ ../configure --prefix=/usr --sysconfdir=/etc
```
configure will complain if a mandatory library is missing.
@@ -47,19 +47,27 @@ $ make install
```
This command requires root privileges
## Configuration
LMS uses a config file for low level settings:
- database file path, default is /var/lms/lms.db
- TLS settings, default is none
- listen address/port, default is 0.0.0.0 port 5081
Other settings are set using the web interface.
By default, LMS will read its configuration in the file '/etc/lms.conf'
## Running
Here is a command line example to run on port 5081:
```sh
$ /usr/bin/lms --docroot='/usr/share/lms/docroot/;/resources,/css,/images,/favicon.ico' --approot=/usr/share/lms/approot --http-address 0.0.0.0 --http-port 5081
$ /usr/bin/lms [/path/to/config/file]
```
LMS needs write access to the directory used for the database.
It is highly recommended to run LMS as a non root user.
The exectuable needs write accesses to the /var/lms/ directory.
To connect to LMS, just open your favorite browser and go to http://localhost:5081
## Mobile
Add the following code in your wt_config.xml file:
Add the following code in your /etc/wt/wt_config.xml file:
```
<application-settings location="/usr/bin/lms">
<progressive-bootstrap>true</progressive-bootstrap>
@@ -77,10 +85,6 @@ Generate a self signed certificate:
```sh
$ openssl req -x509 -out cert.pem -keyout privkey.pem -newkey rsa:4096
```
Run (on port 5081):
```sh
$ /usr/bin/lms --docroot='/usr/share/lms/docroot/;/resources,/css,/images,/favicon.ico' --approot=/usr/share/lms/approot --https-address 0.0.0.0 --https-port 5081 --ssl-certificate cert.pem --ssl-private-key privkey.pem --ssl-tmp-dh dh2048.pem
```
Depending on your SSL parameters, you may be asked for the PEM passphrase to unlock the private key.
To connect to LMS, just open your favorite browser and go to https://localhost:5081
@@ -91,3 +95,4 @@ To connect to LMS, just open your favorite browser and go to https://localhost:5
- bootstrap3 (http://getbootstrap.com/)
- libav project (https://www.libav.org/)
- Magick++ (http://www.imagemagick.org/Magick++/)
- MetaBrainz (https://metabrainz.org/)