# Installation and basic configuration

## Java

Java programming language is a requirement for PMS. Therefore you need to install Java second edition runtime environment (JRE), at least version 6. You can get the latest JRE here.

## Installation and start of PMS on Windows

After installing Java Runtime you can install Java PS3 media server. Double click the setup file "pms-setup-windows-1.20.exe" and follow the instructions.

## Installation and start of PMS on Linux

You also need to have Java installed on Linux. You should set environment variable JAVA_HOME to JRE installation path. After that you have to decompress the setup archive for Linux with:

>     tar xzf pms-linux-1.11.tgz

You have to install MPlayer, MEncoder, FFmpeg and TsMuxeR. If you like to stream web content also install VLC. Make sure that all binaries of these tools can be found via PATH variable. Start a shell, cd to your installation directory and start PMS with:

>     ./PMS.sh

Check permissions and set them if necessary with:

>     chmod ug+x PMS.sh

You can either use packages from your Linux distrubution or compile the tools by yourself. Sometimes distributors do not set important compiler options, e.g. scaling support for FFmpeg. So I recommend you to compile it from source.

## Starting PMS

First start up and login to your PS3 or other viewing device. This will allow PMS to detect it on the network.

After your device has started up, start PMS. PMS tries to detect available media renderers:

PMS should automatically detect your device. After about 10 seconds, you should see this message:

PMS has sucessfully detected your PS3 and connected with it. As a result, PMS should now appear on the cross media bar (XMB) of your PS3:

You are now able to browse your computer and play media files.

## Attention!

The PlayStation 3 separates "Photo", "Music" and "Video" in different XMB entry points. Even though you see all folders on your media server, you can only see the files that correspond to your XMB entry point.

For example: if you choose "Photo" and open your media server you will see a folder "Web video", but it will be empty because it does not contain any photo files. If you want to view the contents of "Web video", you have to navigate to the XMB option "Video" and browse your computer from there. You will now find it filled with video files.

# Troubleshooting

PMS should automatically detect your device and display it. In some cases PMS does not detect your PS3:

## Basic analysis

Often it suffices to change to the "General Configuration" tab and verify the network settings:

In the majority of reported cases there are two problem causes:

- Port 5001 is already in use by another software, for example Azureus Vuze
- PMS uses the wrong network interface as default

You can solve the problem by choosing the correct network interface and type in an unused port, e.g. 6001. After that save and quit, then start PMS again.

## In depth analysis

PMS not showing on your DLNA client can be caused by a variety of factors, but the potential causes can be broken up into two groups - "Before UDP Broadcast" and "After UDP Broadcast"
The line in the debug.log/trace that separates these two groups (this signifies the UDP broadcast) is

>     It's ready! You should see the server appears on XMB

Note 1: for the suggestions below, Windows, Apple and several OEM manufacturers install and enable default protection programs (e.g. Windows Defender or Peer Guardian). Make sure that the settings for all antivirus, firewall, malware and protection programs are checked.

Note 2: direct connections are a special case, so check the additional details at the bottom.

### Before UDP Broadcast

These can usually be spotted through errors in the debug.log / trace before the line above.

PMS cannot bind to the port/IP on the NIC.
  Some other program is already using that port.
  - Check with "netstat -a" through the command line, and change the port in the PMS settings if needed.
A software firewall is blocking javaw.exe (and wrapper.exe if running as a Windows service) from binding to the port.
  - Open the firewall settings and make sure the .exe's are allowed or the specific port is open.
You forced the wrong IP address in the PMS settings.
  - Force the correct IP address (the IP address of the server) or clear the setting. Note: you should only have to the force IP if you have assigned multiple IPs to a single NIC.
You opened multiple instances of PMS or a javaw.exe process got hung up.
  - Close all open instances of PMS and then kill any remaining javaw.exe processes. You may have other programs using javaw.exe, so exercise caution in killing the tasks.
PMS is bound to the wrong NIC (e.g. TCP Loopback).
  - You forced the wrong NIC in the PMS settings, so force the right NIC or clear the setting. Note: There is no error in the debug.log/trace
The host file on your Linux box needs to be corrected.
  - http://ps3mediaserver.org/forum/viewtopic.php?f=6&t=3507&p=16041#p16041. Note: There is no error in the debug.log/trace
You do not have proper access or permissions for the PMS install folder.
  - You need to make sure there are full read and write permissions on the PMS install folder.
    - Check the base file system permissions.
    - On Windows Vista or Windows 7, reinstall with "Run as Administrator" on the installer.
    - Check if any filesystem protection programs are blocking access (some antivirus or malware programs have this feature).
PMS is taking its time to register a component or setting.
  Large collections of files (e.g. a large iTunes database) can take quite some time for PMS to go through. You need to either:
  - Wait for PMS to do its thing, after which it should properly broadcast and show up on your device, or
  - Disable the engine or library setting.

### After UDP Broadcast

At this point everything should be fine within PMS, so you need to look externally.

You have a Windows 7 box and it's using the "Public" settings instead of "Private"
  PUBLIC settings is used in non trusted network and PRIVATE is used in home (trusted) network so change your cable (ethernet or LAN) network to PRIVATE. In PUBLIC mode most of features as SSDP etc. are disabled. http://windows.microsoft.com/en-US/windows7/Choosing-a-network-location
Your software firewall is blocking incoming traffic from your DLNA device
  - Add the device's IP to your firewall's "Trusted List" or allow all local traffic
Your router is blocking the traffic
  - Check the router's firewall to see if the traffic is being blocked
  - Check your router's settings to see if there are any settings to allow UDP traffic or multicast traffic

  Note 1: Most UPnP settings on routers are to allow the devices on the LAN to dynamically configure the port forwarding and other router settings with minimal user interaction. This should not need to be enabled for the actual UPnP/DLNA traffic in the LAN, and in some cases it actually causes issues when enabled on bad routers.

  Note 2: Port forwarding is not required for standard use of PMS. It is only needed if you're trying to stream web-content.

  Note 3: Some routers are crap and either a) do not have the proper settings or b) just mishandle traffic regardless of the settings. This can even vary within the same router for wired vs wireless traffic.

  You may use a switch or a hub which is really cheap as a workaround. Connect your DLNA device, PC and router to the switch/hub and internet connectivity is still there, but you will not have trouble with your routers firewall anymore... This will of course only work with wired connections.

  There are firmware bugs on some DLAN or powerline adapters which prevent certain broadcasts from being transmitted (like using a firewall). This will also cause connection problems.

  If you have checked everything else, give the forum or Google a search and see if other people are having UPnP or DLNA issues with the same router. You could also see if a different DLNA program (WMP, TVersity, Wild, etc) works using the same router or settings.

Your server and device are on different subnets
  - Per the DLNA protocol (which uses UDP broadcast packets), the server and device must be on the same subnet. The easiest way to check is if you can ping the device from the server (successful ping = on same subnet). This issue should only really happen if you have multiple routers or managed switches in your network. If you only have a single router/switch, then you incorrectly set a manual IP address on at least one of your devices leading to a subnet mismatch
Your device is not set up to access any DLNA servers
  - See your device's manual. Note: this only covers PMS showing up on your device, nothing regarding playback or file browsing - viewtopic.php?f=6&t=3507&p=16952#p16952

### Other issues

In addition, you can run into issues (both Before and After UDP Broadcast) when trying to use a direct connection (no router or switch, just the computer with PMS and the device)

Examples:

- PMS cannot bind to the IP/Port because both devices need to be turned on for the connection to exist (before PMS is started)
- You did not use a crossover cable (only needed if BOTH devices are NOT gigabit)
- You have a mismatch in the IP settings
- The device has two (or more) NICs and is using the wrong one (eg PS3 still using the wifi NIC)

- Next: General Configuration
- Previous: Networking and technical basics
- Top: Help