bryan/installJRMC
1
0
Fork 0
Code Issues Pull Requests Releases 8 Wiki Activity

Formatting

Browse Source
This commit is contained in:
Bryan Roessler
2022-01-14 11:13:16 -05:00
parent 1463eb3fd8
commit 12d55c2f21
1 changed files with 16 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
README.md
View File

@@ -1,11 +1,7 @@
# installJRMC
This program will install [JRiver Media Center](https://www.jriver.com/) (JRMC) and associated helper services on most major distros.
This program will install [JRiver Media Center](https://www.jriver.com/) (JRMC) and associated helper services on most major Linux distros.
## README
1. This script will not point major upgrades 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.
2. Typically, `installJRMC` should be **executed as your normal user** (i.e. don't run it with `sudo`) so services can be installed for the current user. `installJRMC` will prompt you for your `sudo` password as necessary to install dependencies and services.
## Executing
@@ -13,6 +9,8 @@ This program will install [JRiver Media Center](https://www.jriver.com/) (JRMC)
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](https://repos.bryanroessler.com/jriver/) (Fedora/CentOS) using the system package manager (`--install repo`). If any other option is specified, then the default install method will need to be specified using `--install`. This makes it possible to install services and containers independent of Media Center.
**Note**: `installJRMC` does not perform library migrations. Before moving to a new major version (i.e. v27->v28), you should first [make a library backup](https://wiki.jriver.com/index.php/Library_Backup), install the new major version, and then [restore the library](https://wiki.jriver.com/index.php/Restore_a_library).
## Options
You can always find the latest supported options by running `installJRMC --help`.
@@ -59,7 +57,7 @@ You can always find the latest supported options by running `installJRMC --help`
### services
When installing systemd services it is important to execute `installJRMC` as the user you wish to run the services. MC services are installed as system-level services (`--service-type=system`) by default. They can be manipulated by the root user: `sudo systemctl stop jriver-servicename@username.service`. It is also possible to create user-level services using `--service-type=user` that can be manipulated by the current user: `systemctl --user stop jriver-mediacenter`.
MC helper services are installed as system-level services (`--service-type=system`) by default and manipulatable by the root user: `sudo systemctl stop jriver-servicename@username.service`. It is also possible to create user-level services using `--service-type=user` that can be manipulated by the current unprivileged user: `systemctl --user stop jriver-mediacenter`.
```text
jriver-mediaserver
@@ -68,15 +66,16 @@ 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)
--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')
--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
```
It is possible to install multiple services at one time using multiple `--service` blocks: `installJRMC --repo --service jriver-x11vnc --service jriver-mediacenter`
@@ -103,17 +102,21 @@ It is possible to install multiple services at one time using multiple `--servic
Install the latest version of MC from the best available repository.
* `installJRMC --install deb --compat`
Install a more widely-compatible version of that latest MC on deb-based distros.
* `installJRMC --install repo --service jriver-mediacenter --service-type user`
Install MC from the repository and start/enable `jriver-mediacenter.service` as a user service.
* `installJRMC --install local --compat --restorefile /path/to/license.mjr --mcversion 28.0.100`
Build and install a MC version 28.0.100 comptability RPM locally and activate it using the `/path/to/license`.mjr
Build and install an MC 28.0.100 comptability RPM locally and activate it using the `/path/to/license.mjr`
* `installJRMC --createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user`
Build the RPM locally (specify cross-build target), move it to the webroot, and run createrepo as `www-user`.
Build an RPM locally for the current distro, move it to the webroot, and run createrepo as `www-user`.
* `installJRMC --service jriver-createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user`
@@ -127,10 +130,6 @@ It is possible to install multiple services at one time using multiple `--servic
Install an Xvnc server on display ':2' that starts MC.
* `installJRMC --install deb --compat`
Install a more widely-compatible version of that latest MC on deb-based distros.
* `installJRMC --uninstall`
Uninstall MC and its associated services and firewall rules. This will **not** remove your media, media library/database, or automated library backup folder.