Update README.md

2020-04-15 11:12:12 -04:00
parent e722473e99
commit 9cd7be25cd
1 changed files with 103 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -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`.