*
QLogitechMediaServer version 2 Help-file

QLogitechMediaServer is a init-script, to run LogitechMediaServer on a
QNap Nas-system !
It support the arm5te, armhf, arm64/aarch64, x86 and x86_64 systems,
with QTS 4.0 and higher.
On startup can check on any updates (Official/Nightly), behavior can be
chanced in .QLMS.conf
Also there is a way, the set running prio/nice-level, to make it
running smooth on a Nas-system/Server.
The way it works/starts can be adjusted, by editing the config file
.QLMS.confg to adjusted needs !.
Build-in there is support for several plugin's like spotty,
shairtunes2, Radio Paradise, Subsonic, GoogleMusic a.m.m.

I made/developed it, because SSOTS/SSODS stop work after a upgraded to
QTS 4.3.
First only suppled a script and perl, but soon this was complaining
about missing libraries.
It seems that a lot off libraries/software are to old or missing
options , to support LMS function's.
So from version 2.00 start using the chroot command, and in
QLogitechMediaServer there is a own file-system.
Through that way the errors where solved, and by this way could give
more supported in LMS !
Please Keep in mind, I'm developing/building it in my spare time !

[ command line options ]

./QlogitechMediaServer.sh start

On startup will do check if there is a update for LMS, upgraded if
available.
Prepare system to run LMS, on it's own chrooted file-system !
If LMS crashes, will try to start LMS in the failsafe mode !
On trouble will give a error, when it's start in failsafe a plug-in is
causing the trouble !

./QlogitechMediaServer.sh stop

If LMS is running, will stop the services and any service started by
LMS !
Also will cleanup/unmounted any directory, and cleanup the chroot
file-system !

./QlogitechMediaServer.sh restart

Will stop LMS if running, after which a completed new start of LMS will
be preformed !

./QlogitechMediaServer.sh failsafe

Start's with only the basic options, and no plugins are loaded !
( Very helpful if there is trouble, or a plug-in/option is causing
trouble ! )

./QlogitechMediaServer.sh status

Can be used to check if LMS is running !
When available and active also will display if running MusicIP, and if
set the next time Auto update checker will run !

./QlogitechMediaServer.sh config

Will give a lot of system information !
( Can be very handy, if you run in to trouble or a error on startup ! )

./QlogitechMediaServer.sh clean

Will completely clean the installed LMS, but settings will be keeped.
When you run ./QLogitechMediaServer.sh start, will install a new LMS !
( Some times on trouble, could help to cleanup and install a completely
new LMS version )

./QlogitechMediaServer.sh check

Will check if there is a upgraded available, depending on settings
Official/nightly.
( Handy if you want to check if there is a update, without having to
restart QLogitechMediaServer. )

./QlogitechMediaServer.sh upgrade

When there is a upgrade file available, will do a upgrade.
For a downgrade, place the file in the DownloadShare, then will not
check on installed version of LMS !
( Will handle a upgraded, and if LMS is running will stop if first )

./QlogitechMediaServer.sh timer

When in .QLMS.conf TIMER is set, will set the auto update timer ! [ If
it's not already enabled ! ]

./QlogitechMediaServer.sh timer status

If enabled will show on which time, the next check will be done !

./QlogitechMediaServer.sh timer stop

If running will stop the Auto Update timer !

./QlogitechMediaServer.sh backup

Will make a backup of the QLogitechMediaServer & LMS settings and
installed plugins !
( Will make a backup of all the LMS and QLogitechMediaServer in a save
place. )

./QlogitechMediaServer.sh restore

If LMS is running, it will be stopped.
Then a restore of the QLogitechMediaServer & LMS settings and plugins
is done !
( Be aware to chance any setting if needed, before restarting LMS with
QLogitechMeidaServer.sh start !)

[ .QLMS.conf ]

There is a config file called .QLMS.conf in the
.qpkg/LogitechMediaServer.
Here you can control several options for LMS, which will be used on
startup for the services.
Please check the wiki for more info on them.

Also there are options, which QLogitechMediaServer uses on startup !.
Which gives you control, on several options/function in the startup
process !.
On trouble or when LMS keeps crashing on startup, please remove this
from the directory !
A new default .QLMS.conf will be written on startup/restart, using only
the standard options !

The httpport will accepted a value between 9000 and 9050, default is
9001 which will be used when net set a with a wrong value !
( On startup will test if port is available, if not add 1 up or use
default 9001 )

[ Trouble or errors on startup ! ]

On startup with errors QLogitechMediaServer will try failsafe and only
the basic options for LMS !
If in failsafe it can start, have a look on the installed plugins. Also
look in .QLMS.conf on the LMS startup option's.
One off them is causing the error. Some times i could help, to remove
.QLMS.conf. On startup a new .QLMS.conf will made, with only the default
settings !

Still having trouble, try ./QLogitechMediaServer.sh clean and then
./QLogitechMediaServer.sh restart.
If it work but after a update the trouble started, try the
./QLogitechMediaServer.sh rollback options and select a older version.
When the error if gone remember to disable auto update in .QLMS.conf,
the most simple would be NOUPDATE=1.
( Up-/Down- grading through placing a file in the Download share, will
still work so you could still do it manuelly !)

If you placed old settings, by copy Cache and the prefs directory in
SLimServer, make a backup of those directory's.
Now remove then from the SlimServer/ directory, and now try to restart
QLogitechMediaServer.
When is work, the trouble comes from the old settings.

The best way to try solving error's is :

* First check if it running.
* Best way is to login to you're QNap system by ssh shell, then go to
/share/*/.qpkg/LogitechMediServer. [ where * depends on you used QNap
model ]
* Now do ./QLogichechMediaServer.sh status, or
./QLogitechMediaServer.sh config. [ Last will give a lot of info, and
show errors if there are any ]
* Try to restart you're QNap system. [ Most error's can be solved this
way ! ]
* If you ever made a backup from a good working installation, try using
this with ./QLogitechMediaServer.sh restore ! [ Installed plugins are
part of the backup ! ]
* When is started after a upgraded of LMS, try
./QLogitechMediaServer.sh rollback and if available choice a older
version to be installed.

[ LMS won't start ]

* Go to the .qpkg/LogitechMediaServer directory.
* Logon to you're QNap system by ssh shell, then go to
/share/*/.qpkg/LogitechMediServer.
* Do ./QLogitechMediaServer.sh clean, and if ask choice Y !.
* Next do ./QLogitechMediaServer.sh restart. [ Will install a
completely new LMS installations, but settings are keeped ]
* Have a good look on the messages come up, sometime it could give you
a clue !

[ LMS still won't start ]

* If you're still in the .qpkg/LogitechMediaServer directory, try
removing .QLMS.conf and ./QLogitechMediaServer.sh restart

[ Still having trouble ]

* First make a backup of you're settings, [ Only if you never made one
! ]
* Remove the SlimServer/ directory from the .qpkg/LogitechMediaServer
directory
* Restart LMS with ./QLogitechMediaServer.sh restart
* Test after a few minutes, if its working with a clean installed LMS.
[ ./QLogitechMediaServer.sh status ]
* If that work restore settings with ./QLogitechMediaServer.sh restore,
and ./QLogitechMediaServer.sh restart

[ If LMS is still crashing ]

* Make sure you made a backup of the LMS and QLogitechMediaServer,
other wise do it now !
* Remove QLogitechMediaServer through the QNap app center.
* Restart you're QNap system.
* Reinstall QLogitechMediaServer through the app center of QNap.
* After a few minutes, check if the webgui is working.
* Logon to you're QNap system by ssh shell, then go to
/share/*/.qpkg/LogitechMediServer.
* If its work, restore the settings with ./QLogitechMediaServer.sh
restore and restart QLogitechMediaServer.

[ If nothing helps ]

* Logon to you're QNap system by ssh shell, then go to
/share/*/.qpkg/LogitechMediServer.
* Check the several log file's . (QlogitechMediaServer.log,
SlimServer/Logs/server.log )
* Maybe they will give you information, where things go wrong.

! Keep in mind most trouble comes, from a plugins, if you uses settings
from a other LMS installation.
! By using a wrong option for LMS, or on a system which is running for
several day's.
! If you send me a message because of trouble, without logs i don't
have a clue !
! Regarding it can't find music files or you can access directory,
check if you uses ACL and if the music files can be read/executed by any
user !
[ No need to set those file to user squeezeboxserver, but make sure
they are rwxr-xr-x as file rights so LMS can access them !

*



*
maintainer of QLogitechMediaServer, QOptware-NG and QAutoSub.

Qnap TS-453a, with LogitechMediaSever 7.9.2 Nightly  ( with spotty,
youtube, Radio Paradise a.m. )
Several raspberry with hifiberry amp+ and picoreplayer.
Love logitechmediaserver for it flexibel way, to play music from
different sources.*
------------------------------------------------------------------------
digimaster's Profile: http://forums.slimdevices.com/member.php?userid=66919
View this thread: http://forums.slimdevices.com/showthread.php?t=108702

_______________________________________________
Squeezecenter mailing list
[email protected]
http://lists.slimdevices.com/mailman/listinfo/squeezecenter

Reply via email to