Install JRiver Media Center and optional helper services on most Linux distributions

bryan 26c6054b3a Complete vncserver service %!s(int64=5) %!d(string=hai) anos
.atom-build.yml 146d10c58a installJRMC v0.1 %!s(int64=5) %!d(string=hai) anos
.gitignore af06ca0d34 Update .gitignore %!s(int64=5) %!d(string=hai) anos
Containerfile 4ac27676a6 RHEL-approved naming %!s(int64=5) %!d(string=hai) anos
README.md 9cd7be25cd Update README.md %!s(int64=5) %!d(string=hai) anos
installJRMC 26c6054b3a Complete vncserver service %!s(int64=5) %!d(string=hai) anos

README.md

installJRMC

This script will help install JRiver Media Center and associated services on Fedora (>=29), CentOS (>=8), Ubuntu (>=16.04), and Debian.

Notes

This script will not point major upgrades (i.e. from v25 to v26) to your old library. You should first perform a library backup, install the new major version, and then restore the library backup in the new version.

Installing

  1. Extract:

    unzip ./installJRMC.zip
    
  2. You may need to make the script executable:

    chmod +x ./installJRMC
    
  3. Run the script using default options (see Options section below):

    ./installJRMC
    

Options

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.

Here is a list of additional options that can be passed to the script. You can always find the latest supported options by running installJRMC --help.

--rpmbuild
    Debian/Ubuntu: Build RPM from source DEB
    Fedora/CentOS: Build RPM from source DEB and install it
--outputdir PATH
    Generate rpmbuild output in this directory (Default: $PWD/outputdir)
--mcversion VERSION
    Build or install a specific version (Default: scrape the latest version from Interact)
--restorefile RESTOREFILE
    Restore file location for registration (Default: skip registration)
--betapass PASSWORD
    Enter beta team password for access to beta builds
--service SERVICE
    See services section below for a list of possible service to install
-v|--version
    Print this script version and exit
-d|--debug
    Enter debug mode
-h|--help
    Print help dialog and exit
-u|--uninstall
    Uninstall JRiver MC, cleanup service files, and remove firewall rules (does not remove
    library files)

Some options are incompatible with each other, for example it is not possible to install the mediaserver service on Ubuntu/Debian when using --rpmbuild or --createrepo since those options do not actually install Media Center.

createrepo

--createrepo
    Build rpm, copy to webroot, and run createrepo

    --createrepo-webroot PATH
        The webroot directory to install the repo (Default: /srv/jriver/)
    --createrepo-user USER
        The web server user (Default: current user)

services

When installing systemd services it is important to execute installJRMC as the user you wish to run the services. Typically this is your normal user account but for some server installations it may be necessary to execute the script as root.

mediaserver
    Create and enable a JRiver MC Media Server systemd service for the current user

x11vnc-mediaserver
    Create and enable a JRiver MC mediaserver service and x11vnc (for headless
    installations without an existing X server) service for the current user

    --vncpass PASSWORD
        Set vnc password for x11vnc access. If no password is set, the script will either use
        existing password stored in ~/.vnc/jrmc_passwd or use no password
    --display DISPLAY
        Start X11VNC on this display (Default: The current display or :0 if current display is
        unaccessible)

createrepo
    Install service to build latest MC RPM and run createrepo hourly for the current user (can also take additional input arguments --createrepo-webroot and/or createrepo-user)

I utilize --service createrepo to build the rpm repository used by Fedora/CentOS.

Examples

  • installJRMC --service mediaserver

    Installs JRiver Media Center using the package manager and starts the jriver-mediaserver service.

  • installJRMC --restorefile /path/to/license.mjr --mcversion 26.0.15

    Builds JRiver Media Center version 26.0.15 RPM from the source DEB (and installs it on Fedora/CentOS along with the associated license).

  • installJRMC --createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user

    Builds the RPM, moves it to the webroot, and runs createrepo as www-user.

  • installJRMC --service createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user

    Installs the jriver-createrepo timer and service to build the RPM and move it to the webroot as www-user.