More > JRiver Media Center 29 for Linux

installJRMC - MC installer for Linux

(1/4) > >>

BryanC:
installJRMC

This program will install JRiver Media Center and associated services on most major Linux distros.

You can always find the latest version of installJRMC, changelog, and documentation in my repository.

Installing

Download and unzip installJRMC from the attachment below or curl the latest stable version directly from my repo:


--- Code: ---curl -O https://git.bryanroessler.com/bryan/installJRMC/raw/master/installJRMC && chmod +x ./installJRMC
--- End code ---

Executing


--- Code: ---installJRMC [--option [ARGUMENT]]
--- End code ---

Running `installJRMC` without any options will install the latest version of JRiver Media Center from the official JRiver repository (Ubuntu/Debian) or my unofficial repository (Fedora/CentOS) using the system package manager (--install repo). If any other option is specified, then the install method (i.e. --install repo or --install local) will need to be explicitly specified. This makes it possible to install services and containers independent of MC.

Note: installJRMC does not perform library migrations. Before moving to a new major version (i.e. v28->v29), you should first perform a library backup, install the new major version, and then restore the library. As of 1.0b14 major version library migrations are performed if the destination config directory `$HOME/.jriver/Media Center XX` is missing for major release `XX`. However, it is still good practice to create a manual library backup before migrating major versions.

Options


--- Code: ---$ installJRMC --help
--install, -i repo|local
    repo: Install MC from repository, future updates will be handled by the system package manager
    local: Build and install MC package locally
--build[=suse|fedora|centos]
    Build RPM from source DEB but do not install
    Optionally, specify a target distro for cross-building (ex. --build=suse, note the '=')
--compat
    Build/install MC without minimum library specifiers
--mcversion VERSION
    Build or install a specific MC version, ex. "29.0.18"
--outputdir PATH
    Generate rpmbuild output in this PATH (Default: ./output)
--restorefile RESTOREFILE
    Restore file location for automatic license registration
--betapass PASSWORD
    Enter beta team password for access to beta builds
--service, -s SERVICE
    See SERVICES section below for the list of services to deploy
  --service-type user|system
      Starts services at boot (system) or user login (user) (Default: system)
--container, -c CONTAINER (TODO: Under construction)
    See CONTAINERS section below for a list of containers to deploy
--createrepo[=suse|fedora|centos]
    Build rpm, copy to webroot, and run createrepo.
    Optionally, specify a target distro for non-native repo (ex. --createrepo=fedora, note the '=')
  --createrepo-webroot PATH
      The webroot directory to install the repo (Default: /var/www/jriver/)
  --createrepo-user USER
      The web server user if different from the current user
--version, -v
    Print this script version and exit
--debug, -d
    Print debug output
--help, -h
    Print help dialog and exit
--uninstall, -u
    Uninstall JRiver MC, cleanup service files, and remove firewall rules (does not remove library or media files)

--- End code ---

Services


--- Code: ---jriver-mediaserver
    Enable and start a mediaserver systemd service (requires an existing X server)
jriver-mediacenter
    Enable and start a mediacenter systemd service (requires an existing X server)
jriver-x11vnc
    Enable and start x11vnc for the local desktop (requires an existing X server, does NOT support Wayland)
  --vncpass and --display are also valid options (see below)
jriver-xvnc
    Enable and start a new Xvnc session running JRiver Media Center
  --vncpass PASSWORD
    Set vnc password for x11vnc/Xvnc access. If no password is set, the script will either use existing password stored in ~/.vnc/jrmc_passwd or use no password
  --display DISPLAY
    Manually specify display to use for x11vnc/Xvnc (ex. ':1')
jriver-createrepo
    Install hourly service to build latest MC RPM and run createrepo
    By default installs as root service to handle www permissions more gracefully

--- End code ---

MC helper services are installed as system-level services (--service-type=system) by default and are manipulable as admin:
--- Code: ---sudo systemctl stop jriver-servicename@username.service
--- End code ---

It is also possible to create user-level services (--service-type=user) that can be manipulated by the current unprivileged user:
--- Code: ---systemctl --user stop jriver-mediacenter
--- End code ---

Multiple services (but not --service-types) can be installed at one time using multiple --service blocks:
--- Code: ---installJRMC --install repo --service jriver-x11vnc --service jriver-mediacenter
--- End code ---

jriver-x11vnc versus jriver-xvnc

jriver-x11vnc shares your existing X display via VNC and can be combined with additional services to start Media Center or Media Server. Conversely, jriver-xvnc creates a new Xvnc display and starts a JRiver Media Center service in the foreground of the new VNC display.

Note: If jriver-xvnc finds an existing display it will attempt to increment the display number by 1. This should work fine in most cases, but if you have multiple running X servers on your host machine you should use the --display option to specify a free display.

Containers

Coming soon!

Firewall

installJRMC will automatically add port forwarding firewall rules enabling remote access to Media Server (52100-52200/tcp, 1900/udp DLNA) and Xvnc/x11vnc (depends on port selection). installJRMC uses `firewall-cmd` on EL distros and `ufw` on Ubuntu/Debian.

Note: ufw is not installed by default on Debian but will be installed by installJRMC. To prevent user lock-out (i.e. SSH), Debian users that have not already enabled ufw will need to `sudo ufw enable` after running installJRMC and inspecting their configuration.

Examples


--- Code: ---installJRMC
--- End code ---
Install the latest version of MC from the best available repository.

--- Code: ---installJRMC --install local --compat
--- End code ---
Install a more widely-compatible version of the latest MC version.

--- Code: ---installJRMC --install repo --service jriver-mediacenter --service-type user
--- End code ---
Install MC from the repository and start/enable jriver-mediacenter.service as a user service.

--- Code: ---installJRMC --install local --compat --restorefile /path/to/license.mjr --mcversion 29.0.18
--- End code ---
Build and install an MC 29.0.18 comptability RPM locally and activate it using the /path/to/license.mjr

--- Code: ---installJRMC --createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user
--- End code ---
Build an RPM locally for the current distro, move it to the webroot, and run createrepo as www-user.

--- Code: ---installJRMC --service jriver-createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user
--- End code ---
Install the jriver-createrepo timer and service to build the RPM, move it to the webroot, and run createrepo as www-user hourly.

--- Code: ---installJRMC --install repo --service jriver-x11vnc --service jriver-mediacenter --vncpass "letmein"
--- End code ---
Install services to share the existing local desktop via VNC and automatically run MC on startup.

--- Code: ---installJRMC --install repo --service jriver-xvnc --display ":2"
--- End code ---
Install an Xvnc server on display ':2' that starts MC.

--- Code: ---installJRMC --uninstall
--- End code ---
Uninstall MC and its associated services and firewall rules. This will not remove your media, media library/database, or automated library backup folder.

Additional Info

Did you find installJRMC useful? Buy me a coffee!

Did you find a bug? Let me know on Interact!

JimH:
Thanks, Brian!

jcd201406:
Hi Brian;

Version: 1.0b14 ...migrating MC28 to MC29

This script copy ~.jriver/Media Center 28 in ~.jriver/Media Center29 . To complete the migration, I had to move content of ~/.jriver/Media Center 29/Media Center28 in ~.jriver/Media Center 29/

JC

BryanC:

--- Quote from: jcd201406 on March 12, 2022, 01:52:21 pm ---Hi Brian;

Version: 1.0b14 ...migrating MC28 to MC29

This script copy ~.jriver/Media Center 28 in ~.jriver/Media Center29 . To complete the migration, I had to move content of ~/.jriver/Media Center 29/Media Center28 in ~.jriver/Media Center 29/

JC

--- End quote ---

Thanks, should be fixed now in 1.0b15.

drmimosa:
Thank you so much for building this installer. It's so helpful for "off the ranch" distro installations, like openSUSE TW. Greatly appreciated!!!!

Perhaps the script could automate fixing this ssl-symlink problem for Tumbleweed?

https://yabb.jriver.com/interact/index.php/topic,132493.0.html

EDIT: Command that worked for me to create a correct certificate symbolic link in openSUSE Tumbleweed (not tested on other systems!):


--- Code: ---sudo ln -s /var/lib/ca-certificates/ca-bundle.pem /etc/ssl/certs/ca-certificates.crt
--- End code ---
 

Navigation

[0] Message Index

[#] Next page

Go to full version