FAQkissdx

From KiSS DP 558 STAGE2 WiKi
Jump to: navigation, search

Home  : Home >

FAQFrequently Asked Questions

Installing


QuestionHow to detect which release of kissdx is currently running on a system ?

AnswerUse one of these methods:

  • From a KiSS Player, select 'PC Link Server searching': The default signature specifies the release
  • Via a telnet access: Invoke help page with this command: kissdx -h
  • Via a telnet access: Invoke status page of currently running process: (since kissdx.0.14.x)
kissdx -s GET_TXT_CONFIG -m localhost -p 8003      (kissdx must be listening for admin commands on port 8003)
(on the server) netstat -ltp|grep kissdx           (display which tcp ports kissdx listens on)

QuestionWhich ports must I open in my firewall?

AnswerThe following ports are used by kissdx:

IP Protocol Port Purpose Description
TCP 8000 PC-Link commands and data The KiSS player will send commands to this port, so it must be open. The kissdx server will send command responses and stream data back on the same connection.
UDP 8000 PC-Link server discovery The KiSS player will send broadcast packets to this UDP port to discover PC-Link servers on the network, so it must be open for server discovery to work. The kissdx server will send a UDP response to the player address:port that the broadcast originated from.
TCP 8888 KML commands and data Optional: When operating as a KML server, kissdx will accept connections from players on this port, which must then be open.
TCP 8003 Administration commands Optional: kissdx 0.14 and later can be managed remotely over this administration port. If administration is enabled and remote administration is desired, this port must be open.

The firewall must allow incoming packets on TCP port 8000 and UDP port 8000 for kissdx to operate.

See a full description of the kissdx network architecture for more details.


QuestionWhy do I get a message about cygwin1.dll not being found?

AnswerThe following message may appear when you start kissdx on Windows:

This application has failed to start because cygwin1.dll was not found.
Re-installing the application may fix this problem.

Solution: Set up a batch file that will start kissdx in a proper cygwin environment. See the Win32 install guide how to do that.


Configuring


QuestionShould there be trailing slashes in the media paths in the config file?

AnswerThe trailing slash is optional. Both cases, with and without, are supported.
A path with an erroneous double slash is in fact also supported.


QuestionWhy do I get the message "The .recent directories must be deleted or moved"?

AnswerThe .recent directory is used to store a set of symbolic links that allow a history view of media played in the [Recently used] folder. kissdx will create the .recent directory inside the media folder if persistentstoragepath has not been set in the configuration file. When persistentstoragepath is set, kissdx stores the .recent directory inside the directory specified there.

So if you have been using kissdx without persistentstoragepath, and then decide to set it, kissdx will issue this message to help you manually migrate the .recent directory to its new location.

In versions previous to 0.13.10a, the location of .recent inside a media fodler was undetected. Since this release, this 'bad' configuration is detected and kissdx is unable to start.

Solution:

  • Remove the .recent directory in each media filesystem (audio, picture and video).
  • The result is loss of your media played history.

or

  • Move those 3 directories to their new locations. If persistentstoragepath is /var/kissdx then move them to /var/kissdx/audio/.recent, /var/kissdx/video/.recent and /var/kissdx/pictures/.recent.
  • This will preserve your media played history.

NOTE: The issues and solutions above are the exactly same for the .piccache folder as for the .recent folder. This .piccache directory stores resized pictures and affects only the media picture path.

Questionkissdx won't start but I don't see any error message

AnswerIf you are starting kissdx with the -d option and it doesn't start running, then check in your computer's log:

  • On Linux: Check in the syslog for messages from kissdx.
  • On Windows: Check in the Event Viewer (Application section) for messages from Cygwin or kissdx.

Streaming


No streaming related questions yet.


Adminstration


QuestionUsing kissdx in as a client administration, I get a 'connection refused'?

AnswerFirst, check that the administration server (port 8003 by default) is started correctly: Run kissdx in verbose mode and check that the following message appears in the log: "kissdx listener ADM.CMD TCP port 8003 open".

Second, the 'listenaddress' option may be configured to one of your network interfaces, and your client kissdx running on the same host as the administration server. Then the request is signed '127.0.0.1' and is rejected. A solution is to specify your client request, via -m option, to use the 'authorised' network interface.

Example: kissdx.conf specifies the option 'listenaddress = 192.168.0.2' which is your second network card
Client request command : ./kissdx -s MyCommand -m 192.168.0.2

Trouble-shooting


QuestionHow can I run kissdx to produce a log file for support?

AnswerIf asked to produce a verbose log file, proceed as follows:

  1. Log in to the computer running kissdx (telnet, ssh, console or Cygwin command prompt).
  2. Run the commands listed below.
  3. Perform tests on the player to reproduce the issue.
  4. When tests are completed, press Ctrl+C to stop kissdx.
  5. Compress the log file (zip, 7z, gzip).
  6. Forward the log file as requested, e.g. upload to bug report or e-mail.
  7. Notify us about the new log file and what specific tests were made to produce it.

These commands will produce a log file called kissdx.log in the current directory:

killall kissdx
/opt/bin/kissdx -v >kissdx.log 2>&1

Note: /opt/bin/kissdx is correct for Optware platforms. On other platforms try /bin/kissdx or just kissdx.


FAQQuestions related to specific kissdx releases

Streaming


QuestionDoes the message 'iconv support' mean a bad and unsupported configuration ?

AnswerSpecial advice for v0.13.8 users The iconv message does not indicate an error. It's just for info, and is removed in the 0.13.10a release.


Configuration


QuestionHow can I restrict excessive reloading of configuration with DP600/1600?

AnswerSpecial advice for v0.13.8 usersThe new KNAS firmware for the DP-600 and 1600 players broadcasts UDP packets very frequently to poll player status, adding to the risk of accidental re-reading of kissdx.conf. Since kissdx V0.14.0, the option 'configautoload = no' solve the issue.