The SAFR Platform installation includes several scripts to manage and monitor your server. They are located in the bin folder under the SAFR Platform installation location.
/Library/RealNetworks/SAFR/bin
/opt/RealNetworks/SAFR/bin
C:\Program Files\RealNetworks\SAFR\bin
Note: Some of the scripts below may not work if you're accessing the SAFR Platform through the NVIDIA Metropolis Application Framework (MAF).
The check script checks the status of SAFR Server services.
/Library/RealNetworks/SAFR/bin/check
/opt/RealNetworks/SAFR/bin/check
"C:\Program Files\RealNetworks\SAFR\bin\check.bat"
The configure-ports script customizes the ports SAFR services listen on. This is typically done only if there is a conflict with existing software on the same server.
If port conflicts are detected during SAFR Platform installation, the following occurs:
This script is executed as part of the installation when appropriate, so it doesn't need to be executed manually unless you are changing the port settings after installation.
This script takes no arguments but relies on the safrports.conf file to determine what ports are to be used.
safrports.conf is located at the following locations:
/Library/RealNetworks/SAFR/safrports.conf
/opt/RealNetworks/SAFR/safrports.conf
C:\Program Files\RealNetworks\SAFR\safrports.conf
The get-license script is used as part of the process of getting an on-premises license when the SAFR system doesn't have Internet connectivity. See the On-Premises Licensing topic for detailed information on how to use this script.
The get-license-request script is used as part of the process of getting an on-premises license when the SAFR system doesn't have Internet connectivity. See the On-Premises Licensing topic for detailed information on how to use this script.
The insert-license script is used as part of the process of getting an on-premises license when the SAFR system doesn't have Internet connectivity. See the On-Premises Licensing topic for detailed information on how to use this script.
Lists all the ports that SAFR services are using.
python /Library/RealNetworks/SAFR/bin/portcheck.py
sudo python /opt/RealNetworks/SAFR/bin/portcheck.py
python "C:\Program Files\RealNetworks\SAFR\bin\portcheck.py"
The reconfigure script configures the hostname used by the SAFR Server. Run this command when configuring the server to use a DNS hostname with an SSL certificate.
This script can be run with arguments specifying the hostname and whether an SSL certificate chain is used by your SSL certificate. If no arguments are passed, you will be prompted for those values.
This script requires administrator privileges. It automatically asks for admin privileges on Windows and requires sudo
on macOS and Linux.
sudo /Library/RealNetworks/SAFR/bin/reconfigure <HOSTNAME> <SSL CERTIFICATE CHAIN?>
sudo /opt/RealNetworks/SAFR/bin/reconfigure <HOSTNAME> <SSL CERTIFICATE CHAIN?>
"C:\Program Files\RealNetworks\SAFR\bin\reconfigure.bat" <HOSTNAME> <SSL CERTIFICATE CHAIN?>
Examples: macOS:
/Library/RealNetworks/SAFR/bin/reconfigure 192.168.123.124 y
Linux:
/opt/RealNetworks/SAFR/bin/reconfigure 192.168.123.124 n
Windows:
"C:\Program Files\RealNetworks\SAFR\bin\reconfigure.bat" 192.168.123.124 y
The configure-ssl script is used to manage the SAFR Server's self-signed SSL certificate. The exact functionality of the script depends on which arguments are passed into it:
Possible arguments
The safr-worker script is used to join secondary SAFR Servers to the SAFR server cluster. See the Add Secondary Servers topic for information on how to use this script
The start script starts all SAFR Server services on the current machine.
/Library/RealNetworks/SAFR/bin/start
/opt/RealNetworks/SAFR/bin/start
"C:\Program Files\RealNetworks\SAFR\bin\start.bat"
The stop script stops all SAFR Server services on the current machine.
/Library/RealNetworks/SAFR/bin/stop
/opt/RealNetworks/SAFR/bin/stop
"C:\Program Files\RealNetworks\SAFR\bin\stop.bat"
The syscollect script collects all the necessary logs, stats, and configuration files into a single archive file that can be easily emailed to SAFR sales support engineers.
python /opt/RealNetworks/SAFR/bin/syscollect.py
. The archive file will be generated at /opt/RealNetworks/SAFR/syscollect/
.python "C:\Program Files\RealNetworks\SAFR\bin\syscollect.py"
. The archive file will be generated at C:\Program Files\RealNetworks\SAFR\syscollect\
.The script accepts the following optional arguments:
The uninstaller executable removes the SAFR Platform entirely. This closes all SAFR applications, stops all SAFR services, and then removes all SAFR services and data.
On Windows, you must select the optional ProgramData component to remove the config files, logs, and database files.
/Library/RealNetworks/SAFR/uninstaller
/opt/RealNetworks/SAFR/uninstaller
"C:\Program Files\RealNetworks\SAFR\uninstaller.exe"
The following scripts appear in the SAFR\bin folder, but are intended for internal use only.