APX orchestrator

Stop debugging, start racing.

User Tools

Site Tools


setup_screenshots

This is a stub, use with caution.

Getting started

You will have to setup once a wizard an a receiver. A wizard can handle multiple recievers. After that, you work only from the web application. You can make the wizard be used from outside the server, but see the remarks written in the article Security considerations.

This guide will lead you on how to install both components. At the end there should be an running, configured server.

Terminology

  • Reciever: An program running on your server, controlling the rfactor instance
  • Wizard: The web app to manage everything

Download

Expand “Assets” and Download the zip file. Currently named “R” and a number. You will have to download the zipfile from the download link below. The number will be different compared to the screenshot, but should be higher in general.

Download Links

Windows protected your PC

As the batchfiles have their origin on another PC, Windows will complain about them. You can unlock the files by going in the file properties and choose “unlock” at the bottom.

Set up wizard

Extended guide: https://wiki.apx.chmr.eu/doku.php?id=setup_wizard

Execute the file wizard.bat. Answer the questions prompted.

Open http://localhost:8000/admin on the same PC to open the web interface. You have to run this batchfile each time you want to start the wizard web application.

:!: To quit the wizard, use the key command CTRL+C in the black terminal window!!!!! :!:

Create a server

To create a server, you have two choices:

  1. “Create server from scratch” (the easy way): APX will create a new server by itself, you don't have to do anything
  2. “Add new server”: Add all settings by hand, you will need https://wiki.apx.chmr.eu/doku.php?id=setup_reciever for that

Configure event

You can select the demo event and choose your desired track and car combination.

When using paid content, unlock the server first. You can do this with dowloading the key file: https://forum.studio-397.com/index.php?threads/how-to-hosting-with-steamcmd-and-paid-content.57209/. The key unlock file will be automatically uploaded, if present.

Recommendation: For testing, use a free combination, such as Zandvoort + Honda Civic.

After that, switch back to the server, select your event and select update config and redeploy. This will install the required content and will do an update.

You can only deploy not-running servers.

After deployment is completed, you can select start to spin up the server.

APX will inform you what is currently going on (see the “state” column).

After completion you can select the option “start” to execute the server

The server should start now with your desired event configuration.

Thats it.


Things you still need to do

  • Open firewall ports (neither expose the WEB UI port nor the wizard ports to the internet!, you can use the Firewall rule generation for that.)
  • To download uploads from the web site, you will need a separate webserver. For testing, you can use the script uploads.bat.

I want to use stamping

  • Use the download with “Win64 dynamic at 16 bits-per-pixel component with high dynamic-range imaging enabled”
  • Make sure you select the option “Install development libraries and headers for C and C++
setup_screenshots.txt · Last modified: 2021/09/25 09:13 by chmr