How to install UMS?

[maxllan]

Hi,

I started with your documentation on installation
https://support.universalmediaserver.co ... stallation

Apparently there is no need for any install documentation. So, I have this .tgz file downloaded and it isn't doing anything. No debug logs. Nothing. Just sits there....

But seriously, I know how to expand a tgz file. So now I have a directory of stuff. Oh and there's an INSTALL.txt file. I thought there was no need for install instructions? (See above).
Conveniently the file IN the tar file tells me how to expand a tar file..... Thanks, but I already figured that bit out. You really don't need a file in a tar file telling someone how to expand a tar file. It's strange that you put effort into _that_ install guide, but your website, where most people will naturally go says "don't need it".

But anyway, finally the first bit of install instructions: Run ./UMS.sh

"Great". There are some other bits of information missing:
Media
The INSTALL.txt says :

Code: Select all

UMS accesses some files in the `ums-$VERSION/` directory (the working directory).
Other files will be looked for in `~/.config/UMS`

Does that mean I need to put my media file in ~/.config/UMS ?? Or can it look for files somewhere else? How do I configure that? I looked at UMS.conf. There are many, many settings, I started reading all the options and got bored. So I grepped for media or source or file. Nope, still nothing that looks relevant.
It actually seems to be looking for files in my home directory. There's no media there, just a lot of apps and source code and container filesystems that it can't parse. eg

Code: Select all

INFO  08:12:14.307 [File event] File /home/maxllan/.local/share/containers/storage/overlay/l/DW6M33Q2HHII4J6UR5XPYCNNUU/var/run/NetworkManager/no-stub-resolv.conf.3X0VQ2 was deleted or moved on the hard drive, removing it from the database

It is currently wasting it's time chewing through a large npm install directory of .ts files. Is there a file glob/regex I can apply somewhere in case my media drive also contains non-media files as well as telling it where files are?


Firewall ports
As a security conscious person, I am of course running a local firewall. Is there a list of ports I need to open for the default config you supply?

Debug log
I tried to follow your "How to submit a support request" guide (viewtopic.php?t=556). It says there should be a debug.log "Whereever your UMS is". Nope. Nothing.
There is a line in the startup messages:

Code: Select all

INFO  07:36:01.755 [main] Logfile: /home/maxllan/.config/UMS/debug.log

That one?


References to the relevant pages in the documentation where this information is available would be gratefully received. (it is obviously much better to add these answers to basic questions in an "Install" guide than hiding them away in a support thread)

Thanks

[boss]

For linux.
Personally I have a folder /opt/ums (because I run a couple of different media servers.
I would suggest making the sub folder of ums under /opt.
Copy the ,gz file to: /opt/ums
then untar: tar -xvzf filenametountar

UMS will create a folder under the username you installed UMS as.
If you installed as root, it will be: /root/.config/UMS/
In that folder will be the configuration flies:
UMS.conf (contains all the configuration settings)
WEB.conf
SHARED.conf (contains the locations of your media files)
UMS.cred
Plus the folders:
data
database

In the default install, UMS uses the ports 9001 and 9002 (these can be changed to other ports).

I use a startup script to start UMS which is better than just running UMS.sh to start UMS.

PS: You can configure the media locations (and other things) in the Web GUI or edit SHARED.conf directly to set your media folder locations.
Mind you the Web GUI in the linux version of 14.1.0 is broken at present.
But... Just edit SHARED.conf.
This is mine so you can see the format.
satan /opt/ums # cat /root/.config/UMS/SHARED.conf
[
{
"file": "/mnt/media/Images",
"monitored": false,
"metadata": true,
"active": true,
"type": "Folder"
},
{
"file": "/mnt/media/Music",
"monitored": false,
"metadata": true,
"active": true,
"type": "Folder"
},
{
"file": "/mnt/media/Music Videos",
"monitored": false,
"metadata": true,
"active": true,
"type": "Folder"
},
{
"file": "/mnt/media/Karaoke Video",
"monitored": false,
"metadata": true,
"active": true,
"type": "Folder"
},
{
"file": "/mnt/media/Videos/Movies",
"monitored": false,
"metadata": true,
"active": true,
"type": "Folder"
},
{
"file": "/mnt/media/Videos/TV Series",
"monitored": false,
"metadata": true,
"active": true,
"type": "Folder"
}
]

[boss]

As far as ignoring particular file extensions, I don't think it is possible unless there have been changes to UMS since this post:
viewtopic.php?t=15781