|
|
@@ -0,0 +1,103 @@
|
|
|
+# installJRMC
|
|
|
+
|
|
|
+This script will help install [JRiver Media Center](https://www.jriver.com/) 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`.
|
|
|
+```text
|
|
|
+--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
|
|
|
+```text
|
|
|
+--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.
|
|
|
+```text
|
|
|
+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`.
|
