Operating an esReven installation

This page lists common and advanced procedures for operating a Reven installation.

Common operations

Adding symbol servers

To benefit from symbols when analyzing a trace, you can define a list of PDB servers in the Project Manager's configuration file (located in $DATA/reven/config/quasar.py).

NOTE: A default list of servers is already present in the settings file that comes with your installation. You only need to perform this step if you require additional or different servers.

  1. Open the Project Manager's configuration file.
  2. Update the default list variable QUASAR_SYMBOL_SERVERS.
  3. Populate the variable with PDB server addresses, here is a sample configuration:
  4. Restart Reven: ./start_stop.sh restart reven
# Symbol server list
QUASAR_SYMBOL_SERVERS = [
    "https://msdl.microsoft.com/download/symbols",
    "https://chromium-browser-symsrv.commondatastorage.googleapis.com/",
    "https://symbols.mozilla.org/",
    # "https://download.amd.com/dir/bin",
    # "https://driver-symbols.nvidia.com/",
    # "https://software.intel.com/sites/downloads/symbols/",
]

For more information, please refer to the page on Getting OSSI for Windows.

Moving a Reven installation directory

If you need to change the location of your Reven installation, the recommended procedure is to run ./start_stop.sh down from the installation location, move the $DATA folder, update the $DATA value in .env, and start again with ./start_stop.sh up -d.

Advanced

Running multiple esReven instances on the same machine

You can run multiple instances of esReven on the same machine, as long as you set differently the $COMPOSE_PROJECT_NAME variable in your .env.

Troubleshooting

If you have any trouble somewhere, don't hesitate to take a look at the logs located in $DATA/reven/Reven2/<version>/Logs and see the Support page for any help.

©2019-2023 eShard