Skip to content

Full Server mode

optyfr edited this page Jun 16, 2020 · 10 revisions

Full Server mode (since 2.4.1)

Purpose

To run JRomManager directly on the internet and serve files to users

How to install?

This is the same package than the "JRomManager standalone", so it is installed the same way, the difference may be that you will install it on your server instead of installing on your client machine

How to run (server side)?

Manual launch

  • open a shell or a cmd window,
  • then cd into the jrommanager install dir
  • run the following: java -Dfile.encoding=UTF-8 -cp JRomManager.jar jrm.fullserver.FullServer --cert="path/to/cert.pfx" --client="./webclient" --workpath="path/to/working_base_path/"

If you don't have rights to write into the install dir, then you will have to set --workpath to an absolute path with write access rights and also set --client to an absolute path too.

It is strongly recommended to set your -Xmx#G max memory value from java command line according to you server available memory, there is also the possibility to set a percentage of the available system RAM with -XX:MaxRAMPercentage=75.0 (for 75%)

As a service at boot

On Windows

On *nix

How to use (client side)

  • Launch your favorite browser (chrome or firefox are preferred)
  • Point to https://localhost:8443 or https://<yourserver>:<yourdefinedport> if you customized certificate and port
  • You should start to see the web client app, otherwise something goes wrong and you should start to see at log files
  • The initial login is username admin, password admin, and you can change it into the "Admin" sub Tab from the "Settings" main tab
  • If you choose a self-signed certificate or invalid certificate and use HTTPS, you could get strange behaviors with sub-requests (depend of the browser), the recommended way is to use a valid "Let's Encrypt" certificate with a real domain name (but you can still locally set it into your /etc/hosts file and make it point to 127.0.0.1)

Notable differences with standalone mode, limitations and words of caution

  • The filesystem exposed from the file/dir chooser is the one from your server NOT your client
  • If you need to send files or dir from your client machine to your server, then you can use "Manage file uploads" on "Profiles" tab, then drag & drop your files/dirs into the main file requester window
  • You may get less refresh in the progress bar and lists, this is the best that we can get in a client/server environment
  • You should avoid to close or hide your client page, and don't even think to let your laptop go into standby mode, because you may loose your session
  • You can safely use this server mode over the internet