Skip to main content

BriefCam Installation Guide

Server Hostname Change Tool

Last Updated: 1 minute read
Version2025r1
LanguageEnglish

This tool makes changes to an all-in-one environment after a server hostname change. Note that this tool does not make changes to the RESEARCH component or to RabbitMQ.

Note

Note: It is highly recommended not to change the server hostname if you are using the RESEARCH component.

The tool (BriefCamUpdateHostname) is available at: {BriefCam Server installation folder}\tools\change_hostname.

To work with the tool:

  1. Change the machine’s host name. (Make a note of the original host name because you will need it in step 4.)

  2. Restart the machine.

  3. Reshare the BriefCam share.

  4. Open PowerShell as admin.

  5. Run the following command: .\update_hostname.exe /qn NEW_HOSTNAME="{the new host name}" OLD_HOSTNAME="{the old host name}" POSTGRES_BC_USER="{the BC application user for connecting to the DB}" POSTGRES_BC_PASSWORD="{the password for BC application user}" LOG_NAME="{the file name for the application log}" /L*V "{path for verbose logging of the tool}"

    The LOG_NAME parameter controls the name of the log the tool generates for tracking what was changed. This log is saved in the %APPDATA%\briefcam folder.

    The machine will be restarted by the installer after the tool has finished running.

  6. Uninstall RabbitMQ using the Windows Add/Remove Programs option.

  7. Reinstall the RabbitMQ component.