Regiboxd first steps

From regify WIKI
Revision as of 10:52, 23 January 2023 by Regify (talk | contribs) (Created page with "== Creating your first regibox on Windows == # After you downloaded the installer, please run and finish the setup. # Open a '''commandline prompt with Administrator permissi...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Creating your first regibox on Windows

  1. After you downloaded the installer, please run and finish the setup.
  2. Open a commandline prompt with Administrator permissions.
    • You may want to increase the window size in the shell properties by increasing Screen Buffer Size Width to 160.
  3. Go to the root folder of your drive:
    cd c:\
  4. Create a directory as your instance folder. It will hold your future regibox configuration:
    mkdir c:\rgbx_config
  5. Create a root folder as root for your regiboxd regiboxes:
    mkdir c:\rgbx_root
    • Do not use the same folder for configuration and data!
  6. Install config and windows service for your new regiboxd:
    regiboxd -c "c:\rgbx_config" -r "c:\rgbx_root" -i "MyExampleRegibox"
    • Please note that we submit the previously created config folder with -c and the regibox root folder with -r.
    • The -i switch registers your new regibox as service with the name MyExampleRegibox.
    • If you don't get Service MyExampleRegibox has been successfully installed, ensure that you run the commandline with administrator permissions.
  7. Validate the service by listing all regiboxd services:
    regiboxd -L
    Currently installed regiboxd service instances. Name(pid) means running, Command line
    MyExampleRegibox (984) "C:\Program Files\regiboxd\regiboxd.exe" -I "regiboxd_MyExampleRegibox" -c "c:\rgbx_config"
  8. Configure your new regibox service with your credentials.
    • Technically, regiboxd is controlled by placing a json file request.tmp into the configuration subfolder req\. Then, the result is placed in a file response.tmp in the res\ folder.
    • It is more easy to control regiboxd using the regiboxctl tool, which takes care of placing the file and observing the result.
    • Note that we use an uppercase -J to provide Windows specific json (see regiboxd manual).
    • regiboxctl -c "c:\rgbx_config" -p -J "{'op':'newConfig', 'providerUrl':'https://bp137.regify.com', 'regifyUser':'user@company.com', 'regifyPass':'password'}"
    • You should get some json result showing { "status": "OK" }. If you get an error, validate your request.
  9. Create your first regibox like this:
    regiboxctl -c "c:\rgbx_config" -J "{'op':'newBox', 'name':'box1'}"
    { "status": "OK", "uid" : "xksiypdqycmd7dhr6s8tbyqx8qsdcfnw" }
    • You should get some json result showing status OK and a uid, which is the API identifier of the new regibox. If you get an error, validate your request.

Congratulations, you just created your first regibox.

Uninstall a regiboxd service

In order to uninstall a regiboxd service, call regiboxd with the -u option:

regiboxd -u "MyExampleRegibox"

This removes the service and regiboxd is no longer running on the folders. Please note that this neither deletes the regibox nor the local data. It just unregisters the service.

You can recreate the service at any time on the existing configuration and data like this:

regiboxd -c "c:\rgbx_config" -r "c:\rgbx_root" -i "MyExampleRegibox"