Establishing secure connections is necessary to maintain safe communications among FairCom servers and data collection devices. The following process for establishing TLS connections is recommended when deploying FairCom servers.
Security
- Create a valid certificate for each FairCom Edge server.
- Configure the certificate for
HTTPSconnections only. - Turn on file encryption.
- Change the ADMIN password to a secure password.
- Add additional user accounts for applications and end users.
Note: Do not allow application and end-user accounts to have admin access or to know the ADMIN password. Ensure each account has a secure password
Configuration settings
- Update the settings in the
ctsrvr.cfgfile to fit production needs.- Increase the default topic settings for FairCom Edge and FairCom MQ. There needs to be
62*numberof expected topics. If the persistence settings were changed it will be(retentionPeriod+1)*2.
- Increase the default topic settings for FairCom Edge and FairCom MQ. There needs to be
- Verify that the system files limit is at least as high as the
FILESsettings from Step 1. - Increase the
DAT_MEMORYandIDX_MEMORYsettings to allow caching as much of the data you expect to access as possible.- Keep this within the footprint of the physical RAM the hardware has available.
- Store the
data,index, andtranlogfolders on fast local SSD storage.- Using a shared or network volume to store these files will dramatically slow down performance.
Change the admin password
The ADMIN user and members of the ADMIN group have full control over all operations in the FairCom server. They are also the only users who can stop the server.
Note: Changing the ADMIN password on all servers is critical to secure your data from malicious attackers.
- The default administrator user ID is admin.
- FairCom user IDs are NOT case-sensitive.
- The default password is ADMIN
- FairCom passwords ARE case-sensitive.
Use sa_admin to change a password
The <faircom>/tools/sa_admin.exe file is a command-line interface (CLI) program designed to be embedded into scripts. It changes a user password using command line parameters.
The following example changes the admin user password to NewPassword:
sa_admin -aADMIN -pADMIN -f"" -sFAIRCOMS -oup admin NewPassword
- The -a parameter specifies the current value of the admin username, which is ADMIN unless you previously changed it.
- The -p parameter specifies the current value of he admin user password, which initially is ADMIN.
- The -f parameter is the file password, which is typically "".
- The -s parameter is the connection name of the FairCom database, which is "FAIRCOMS" unless you previously changed it.
- The -oup parameter tells the program to change the password.
Use ctadmn to change a password
The <faircom>/tools/ctadmn.exe file is an interactive tool you run from the command line, such as the DOS command prompt or the Linux BASH shell. It prompts you for information to change a user password.
This example authenticates the admin user as an authorized administrator, then changes the admin user password.
- Open a command prompt.
- Move to the <faircom>/tools folder.
- Run ctadmn.
- When prompted, enter admin for the user ID and press ENTER.
- Enter ADMIN for the password and press ENTER.
(By default, FairCom products set the admin password to ADMIN, which is all uppercase characters.) - Press ENTER for the next two prompts unless you have changed the File Password or Server Name.
- Press 1 and ENTER to open the User Operations menu.
- Press 4 and ENTER to change a user password.
- When prompted, enter admin for the User ID and press ENTER.
- Enter a new password and press ENTER.
- Enter the same new password again and press ENTER.
- Press ENTER.
- To quit
- Press q then ENTER
- Press q then ENTER again.