Truecall Server: Installation and Upgrade Guide
Truecall Server: Installation and Upgrade Guide
Mobile Access
Government Use and Notice of Restricted Rights: In U.S. government ("Government") contracts or subcontracts, Customer will
provide that the Products and Documentation, including any technical data (collectively "Materials"), sold or delivered pursuant
to this Agreement for Government use are commercial as defined in Federal Acquisition Regulation ("FAR") 2.101and any
supplement and further are provided with RESTRICTED RIGHTS. All Materials were fully developed at private expense. Use,
duplication, release, modification, transfer, or disclosure ("Use") of the Materials is restricted by the terms of this Agreement and
further restricted in accordance with FAR 52.227-14 for civilian Government agency purposes and 252.227-7015 of the Defense
Federal Acquisition Regulations Supplement ("DFARS") for military Government agency purposes, or the similar acquisition
regulations of other applicable Government organizations, as applicable and amended. The Use of Materials is restricted by the
terms of this Agreement, and, in accordance with DFARS Section 227.7202 and FAR Section 12.212, is further restricted in
accordance with the terms of NETSCOUT'S commercial End User License Agreement. All other Use is prohibited, except as
described herein.
This Product may contain third-party technology. NETSCOUT may license such third-party technology and documentation ("Third-
Party Materials") for use with the Product only. In the event the Product contains Third-Party Materials, or in the event you have
the option to use the Product in conjunction with Third-Party Materials (as identified by NETSCOUT in the Documentation
provided with this Product), then such third-party materials are provided or accessible subject to the applicable third-party terms
and conditions contained either in the "Read Me" or "About" file located in the Software or on an Application CD provided with
this Product, or in an appendix located in the documentation provided with this Product. To the extent the Product includes
Third-Party Materials licensed to NETSCOUT by third parties, those third parties are third-party beneficiaries of, and may enforce,
the applicable provisions of such third-party terms and conditions.
Open-Source Software Acknowledgement: This product may incorporate open-source components that are governed by the GNU
General Public License ("GPL") or licenses that are compatible with the GPL license ("GPL Compatible License"). In accordance
with the terms of the GNU GPL, NETSCOUT will make available a complete, machine-readable copy of the source code
components of this product covered by the GPL or applicable GPL Compatible License, if any, upon receipt of a written request.
Please identify the product and send a request to:
To the extent applicable, the following information is provided for FCC compliance of Class A devices:
This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of the
FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is
operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not
installed and used in accordance with the instruction manual, may cause harmful interference to radio communications.
Operation of this equipment in a residential area is likely to cause harmful interference, in which case users will be required
to correct the interference at their own expense.
Modifications to this product not authorized by NETSCOUT could void the FCC approval and terminate your authority to
operate the product. Please also see NETSCOUT's Compliance and Safety Warnings for NetScout Hardware Products
document, which can be found in the documents accompanying the equipment, or in the event such document is not
included with the product, please see the compliance and safety warning section of the user guides and installation
manuals.
No portion of this document may be copied, photocopied, reproduced, translated, or reduced to any electronic medium or
machine form without prior consent in writing from NETSCOUT. The information in this document is subject to change without
notice and does not represent a commitment on the part of NETSCOUT.
The products and specifications, configurations, and other technical information regarding the products described or referenced
in this document are subject to change without notice and NETSCOUT reserves the right, at its sole discretion, to make changes at
any time in its technical information, specifications, service, and support programs. All statements, technical information, and
recommendations contained in this document are believed to be accurate and reliable but are presented "as is" without
warranty of any kind, express or implied. You must take full responsibility for their application of any products specified in this
document. NETSCOUT makes no implied warranties of merchantability or fitness for a purpose as a result of this document or
the information described or referenced within, and all other warranties, express or implied, are excluded.
Except where otherwise indicated, the information contained in this document represents the planned capabilities and intended
functionality offered by the product and version number identified on the front of this document. Screen images depicted in this
document are representative and intended to serve as example images only.
992-0638-08-001
200331
T a b le o fC o n te n ts 4
What’s New 7
Revision History 8
1 Purpose 9
2 Installation Prerequisites 11
2.1 Linux Operating System and Software Packages 11
2.2 Administrative Privileges 11
2.3 Upgrade Prerequisites 11
3 Preparing to Install or Upgrade 12
3.1 TrueCall Software Packages 12
3.2 Intended TrueCall Use 12
4 Installing TrueCall (New Installation) 13
4.1 TrueCall Server Installation 13
4.2 GSR Services Installation 13
4.3 Run the Post-Installation Configuration Script 14
4.4 Configuration 14
4.4.1 TrueCall Server Component Configuration 14
4.4.2 TrueCall COMMON Vendor List Configuration 17
4.4.3 TrueCall PLMNID Configuration for LTE 18
4.4.4 TrueCall Server Administration Installation 19
4.4.5 TrueCall Cylinder Cleanup 21
4.4.6 Enabling the cylinder-optimize.sh Script 21
4.4.7 Configure Cron Jobs 21
4.4.8 Enable TrueCall Service to Start on Boot 22
4.5 Next Steps 22
5 Upgrading TrueCall from the Previous Version 23
5.1 Known Changes When Upgrading from a Previous Version 23
5.1.1 Installation Changes 23
The common core components required for a TrueCall system to be able to visualize the customer’s
network are TrueCall Web Admin Console, ETL, Cylinder, TcsTcpServer, Handset Database Auto-
Upload, and Network Element Table Auto-Upload.
Refer to the TrueCall Configuration Guide, Version 6.3.0 for procedures for configuring optional
features.
l NB-IoT Calls
l 5G Calls
Refer to the Radio Access System Compliance Document for information on which data versions
are supported per vendor technology.
Note: If the current version is earlier than 17.3, upgrade the software to 17.3 using the TrueCall
Installation and Upgrade Guide, Version 17.3 before proceeding with the upgrade instructions
outlined in this document.
Run the following command to determine the version of the existing TrueCall installation:
rpm -q truecall-server
l GSRservices-V17.6.3.0.XX-0_el7.x86_64.rpm
l TrueCall-Server-6.3.0.X-X-gef929c5-el7-x86_64.rpm
Note: Replace XX and X-X with the correct version required for the deployment.
The instructions below assume the current working directory is the directory where the software
packages were placed on the TrueCall server.
It is important to install TrueCall and GSR in the order presented in this section. Install the TrueCall
server first, then install GSR services.
Note: Replace x-x with the correct version required for the deployment.
As user “root”:
rpm -ivh TrueCall-Server-6.3.0.X-X-gef929c5-el7-x86_64.rpm
As user “root”:
rpm -ivh GSRservices-V17.6.3.0.XX-0_el7.x86_64.rpm
As user “root”:
/opt/tc3/bin/conf-truecall.sh
4.4 Configuration
The TrueCall server will need to be configured for the intended use. This install guide only covers the
configuration of the common core components that are required for the TrueCall application to
display call records in the TrueCall client application.
The common core components required for a TrueCall system to be able to visualize the customer’s
network are TrueCall Web Admin Console, ETL, Cylinder, TcsTcpServer, Handset Database Auto-
Upload, and Network Element Table Auto-Upload.
Note: Refer to the TrueCall Configuration Guide for install or upgrade instructions for the
optional TrueCall features.
The TrueCall server configuration parameters must be entered into the TrueCall configuration file
named /opt/tc3/etc/config.ini. The common core components can reside on one TrueCall server, or
can reside on multiple TrueCall servers.
When TrueCall is installed, the configuration file, /opt/tc3/etc/config.ini, has every TrueCall task
enabled. Modify the configuration file to only start the TrueCall components required for the current
deployment and restart TrueCall services for the changes to be applied.
Templates do exist which can be used to configure the TrueCall configuration file for a particular
vendor technology. The template files are in the /opt/tc3/etc directory and are named config_VDR_
TECH.ini, where VDR_TECH is replaced with COMMON_LTE, HUA_UMTS, etc.
Note: TrueCall services must be restarted after the TrueCall configuration file has been modified
on a TrueCall server.
N/label=processor-vendor-tech
N/fullpath=/opt/tc3/bin/processor-vendor-tech
N/workingdir=/opt/tc3
N/args=--input-stream-port=NNNN
Note:
l Replace N with the actual number used for that TrueCall component.
l Replace vendor-tech with the actual vendor technology in use; i.e., common-lte, hua-umts,
etc.
l Replace NNNN with the actual port number used for that TrueCall component.
l Add any additional arguments required in the “args=” line.
Note:
If the ETL component is not running on the same machine as the query server, disable the
crontab entry for /opt/tc3/update-bookmarks.sh (for the daemon user) on this machine.
Otherwise, it can delete daily updated bookmarks.
The ETL can be configured in Common LTE to send to multiple cylinders to increase performance. To
use this feature, more than one cylinder must be provisioned. To enable the feature, add the
following arguments to processor-COMMON-LTE:
--cylinderd-address=IP1:PORT1,IP2:PORT2,IP3:PORT3,IP4:PORT4
Where IP(1-4) are the IP addresses of the cylinders and PORT(1-4) are the ports. Separate each
IP:PORT pair with a comma.
Note:
l Replace N with the actual number used for that TrueCall component.
l Replace VDR_TECH with the actual vendor technology in use; i.e., COMMON_LTE, HUA_
UMTS, etc.
l Replace NNNN with the actual port number used for the cylinder.
l Add any additional arguments required in the “args=” line.
Note:
If the Cylinder component is not running on the same machine as the query server, disable the
crontab entry for /opt/tc3/update-bookmarks.sh (for the daemon user) on this machine.
N/label=prdd
N/fullpath=/usr/share/GSRservices/runprdd
N/workingdir=/opt/tc3
N/args=
Note:
l Replace N with the actual number used for that TrueCall component.
l Replace VDR_TECH with the actual vendor technology in use; i.e., COMMON_LTE, HUA_
UMTS, etc.
l Replace NNNN with the actual port number used for that TrueCall component.
l Add any additional arguments required in the “args=” line.
Note:
l Replace N with the actual number used for that TrueCall component.
l Add any additional arguments required in the “args=” line.
Refer to Appendix D: Handset Database Naming Convention to view the naming requirements for
the handset database.
Refer to the TrueCall Automatic Handset Ingest MOP for specific instructions on configuring this
feature.
Add the following task to the TrueCall server configuration file where the TcsTcpServer process will
reside.
N/label=ne_watcher
N/fullpath=/opt/tc3/bin/NE_Watcher.py
N/workingdir=/opt/tc3/bin
N/args=
Note:
l Replace N with the actual number used for that TrueCall component.
l Add any additional arguments required in the “args=” line.
Refer to Appendix C: Network Element Table Naming Conventions to view naming requirements.
Refer to the TrueCall Automatic Upload of NE Tables MOP for specific upload guidelines.
As user "root:"
service truecall-server restart
Note: The vendor list configuration should be performed on the server where the TcsTcpServer
process will reside.
When the TrueCall server is configured to use one of the COMMON vendor technologies, the vendor
list will need to be modified for the TrueCall client to only display KPIs for the vendors that are in use.
Based on the COMMON technology chosen, the vendor list will reside in one of the files listed below:
l /opt/tc3/etc/TcsServerSettings_COMMON_GSM/NewfieldWireless/TcsServerSettings_
COMMON_GSM.ini
l /opt/tc3/etc/TcsServerSettings_COMMON_LTE/NewfieldWireless/TcsServerSettings_
COMMON_LTE.ini
l /opt/tc3/etc/TcsServerSettings_COMMON_UMTS/NewfieldWireless/TcsServerSettings_
COMMON_UMTS.ini
In the files above, there is a line that contains “VendorList=”. Edit that line to only include the
vendors the TrueCall server will process.
You can have more than one vendor enabled. Separate each vendor with a comma (,).
Example of setting the vendor list to process vendors Ericsson and Huawei on COMMON_LTE:
VendorList=Ericsson,Huawei
After the vendor list has been modified, restart TrueCall services to apply the changes using one of
the following commands:
As user "root:"
service truecall-server restart
After restarting the TrueCall server, run the following command to verify that the processes have
started:
ps -flwwu daemon
Customers may use ECI in their cell IDs on their network. For TrueCall to be able to geolocate the call
records, the cell IDs must be converted to ECGI.
Modify the file below to include the PLMNID of the customer so that TrueCall can convert the ECI to
ECGI to geolocate the call records. By default, the PLMNID is set to zero (0).
l /opt/tc3/etc/ne-table-config.ini
Modify the line below to include the correct PLMNID for the customer, i.e., replace zero (0) with the
6 digit PLMNID of the customer.
plmn_id=0
After the PLMNID has been modified, restart TrueCall services to apply the changes using one of the
following commands:
l As user "root:"
service truecall-server restart
l Using sudo permissions:
sudo service truecall-server restart
After restarting the TrueCall server, run the following command to verify that the processes have
started:
ps -flwwu daemon
If the TrueCall components will be installed on separate servers, the TrueCall Web Admin Console
should only be configured on the TrueCall server where the TcsTcpServer component resides.
Perform the following procedure to prepare the server for either Web Admin installation or nCM
support.
1. If the operating system was not installed by NETSCOUT, verify that the umask value for root is
set to either 022 or 0022.
umask
If the value is anything other than 022 or 0022, set it for the current session.
As root:
umask 022
Setting the umask is not persistent and only applies to the current session.
2. Configure Ruby on Rails for the TrueCall Web Admin Console by running the commands
below.
cd /opt/tc3/share/WebClient5/config
As user “root”:
cp local_settings.rb.sample local_settings.rb
vi local_settings.rb
Using sudo permissions:
sudo cp local_settings.rb.sample local_settings.rb
sudo vi local_settings.rb
3. Edit the /opt/tc3/share/WebClient5/config/local_settings.rb file and set all enabled vendor
technologies to “true”.
In the example below, the enabled vendor technology is COMMON_GSM, therefore “GSM” is
set to “true”.
--- SNIPPET ---
ENABLED_TECHNOLOGIES = {
"ALU_CDMA" => false,
"NOR_CDMA" => false,
"HUA_CDMA" => false,
"ALU_EVDO" => false,
"NOR_EVDO" => false,
"ERC_UMTS" => false,# Use this one for ERC_UMTS with GSR
"ERC_UMTS_LEGACY" => false,# Use this one for ERC_UMTS without
GSR
"HUA_UMTS" => false,
"UMTS" => false,# Use this one for COMMON_UMTS
Continue with either Integrating with nCM for Administrative Functions or Configure the Web Admin
Console.
1. Log into the TrueCall Web Admin Console and upload the Network Element Table, upload the
Handset Database Table, configure the time zone, create user groups, and create user
accounts. Use a web browser and navigate to the IP or hostname of the TrueCall server where
the TcsTcpServer component resides. For the hostname to resolve, the TrueCall server must
have an entry in the DNS table.
Possible TrueCall Web Admin Console URLs (dummy IP and hostnames used below, replace
with real values):
IP - http://10.0.2.2
Hostname - http://tctest03
FQDN - http://tctest03.example.com
TrueCall cylinder servers are designed to hold a certain amount of historical data. This is directly
related to the number of days you can go back in time within the TrueCall client.
The number of days of historical data to keep is maintained by cylinder-cleanup-all program that is
installed but not started by default when you load the TrueCall software package. The cylinder-
cleanup script is not started by default because its parameters need to be set according to the
specific customer.
To enable cylinder-cleanup-all, uncomment the above section, replace 'N' with an appropriate
number and change the value of 'size' on top to an appropriate number.
Where:
l --schedule-time-local is the time of day (in 24-hour format HHMM) when the program removes
data.
l --min-filled-days is the minimum number of populated days. This value should be > 0.
Additionally, the crontab entry for the script is commented out. Remove the comment statement to
enable the crontab entry in /opt/tc3/etc/crontab.
This script should be configured and enabled on the server where the LSR process resides.
Enable this script on the server where the Cylinder process resides. Uncomment out the entry for
disk-cleanup.sh in/opt/tc3/etc/crontab to enable it.
As user “root”
systemctl enable truecall-server
Using sudo:
sudo systemctl enable truecall-server
Note: If the current version is earlier than 17.3, upgrade the software to 17.3 using the TrueCall
Installation and Upgrade Guide, Version 17.3 before proceeding with the upgrade instructions
outlined in this document.
This section only applies if an upgrade of an existing TrueCall installation is being performed, i.e.
upgrading the TrueCall software on server that currently has the TrueCall software installed. If a new
TrueCall installation is being performed, refer to Installing TrueCall (New Installation).
Before beginning, ensure that the prerequisites for upgrading are met and preparation has been
completed as outlined in the following sections:
Each section is marked with the applicable release(s). Skip the sections that do not apply to the
release you are upgrading from.
Because the numbering scheme changed in 6.3.0, the installer thinks you are trying to install an
older version of the software when upgrading from 17.6.2.2. You need to add the following flag
when installing to force the installer to upgrade:
l --oldpackage
As of 6.3.0, Ring Search Method (RSM) is now the default geolocation algorithm for LTE and 5G
implementations. Upon upgrade to 6.3.0, RSM will be set as the default, regardless of which
algorithm was in use before.
Extra configuration is required, which is outlined in the upgrade section of this document.
Refer to the Configuring Ring Search Method chapter in the TrueCall Configuration Guide, version
6.3.0 for more information.
This feature adds changes to improve performance when reading and writing from the database.
These changes remove the end time index from cylinder.
This feature is available for GSR-compatible processors for GSM, UMTS, or LTE and is enabled by
default upon new install or upgrade.
Note: If you are disabling the feature, it is important to keep the options on the processor and
cylinder in sync or there could be irretrievable data loss.
Tag names now contain the end time at the end of the filename.
Old cylinder tags and data are not updated to the new format. Cylinder is able to read both formats
and will continue to read the old tags and data until they age out.
Note: To change any of the default cyl-stats options, you must add them to
/opt/tc3/etc/config.ini.
--cyl-stat-enabled (=1) Enables the use of cylinder statistics. Required when the
end time index is not used
--cyl-stat-output-console arg (=0) If true, cylinder statistics output is sent to console
--cyl-stat-output-logger arg (=1) If true, cylinder statistics output is sent to logger (which
may be to the console or a file). This option is specified in
the /etc/sysconfig/truecall-server settings file, so should
not be specified in a config.ini.
--cyl-stat-output-file arg If set, cylinder statistics output is sent to the specified file.
This option is specified in the /etc/sysconfig/truecall-server
settings file, so should not be specified in a config.ini.
--cyl-stat-output-final arg (=1) If true, cylinder statistics output one last set of statistics
when we shut down
--cyl-stat-output-verbose arg (=1) If true, Display cylinder statistics verbose messages, one
line per statistic.
--cyl-stat-output-taglist arg (=1) If true, Display all cylinder statistics on a single line as tag-
value pairs.
--cyl-stat_tag_inactive-interval arg (=900) Interval be used to detect tag become inactive, if tag over
more than this interval not receive data, tag be marked as
inactive. in seconds.
l bzip2-devel
l xz-devel
l libcurl-devel
l openssl-devel
l protobuf
You should no longer use Carrier Aggregation Service Time [s] as a column name in the LSR
configuration file. The field name has changed to Carrier Aggregation Service Time [ms].
If the old name is used, an error is logged in the log and the column is treated as an unknown
column, which results in either no data for the column or complete removal depending on whether
the --allow-unknown-cols option is enabled.
/opt/tc3/etc/TcsServerSettings_COMMON_LTE/NewfieldWireless/TcsServerSettings_COMMON_
LTE.ini now contains the parameterOvershootingEnabled=true.
Refer to the Overshooting Cells configuration section in the TrueCallConfiguration Guide for more
information.
Beginning in 17.6.2, support for S6A/Diameter has ended. Diameter Parser, TCE, and TCM are no
longer supported.
The following arguments should be removed from the COMMON_LTE ETL task if present:
--tc-e-connect-string arg Diameter connection string for Tc-e.
--tc-e-worker-threads arg (=2) Number of Tc-e worker threads.
--nas-db-worker-threads arg (=1) Number of NAS DB worker threads.
--libtce-server-port arg The port for LibTce to run as a Server.
--libtce-row-logging arg If set, where to log query/response rowData
records.
--request-throttle-size arg (=100) Number of TCE requests before
throttling.
--drop-when-full If set, skip diameter lookup instead of waiting when
Tc-e is throttling.
--update-hybrid-key arg (=1) Send hybrid key in updates from NAS Engine
to Tc-E.
--block-list-rate arg (=30) Diameter block list rate (in minutes)
Refer to the Configuring MDT section in the TrueCall Configuration Guide, 17.6.2 for more
information.
Beginning in 17.6.2 several command line options related to log file rotation are removed. Presence
of these options causes TrueCall to fail on startup. The TrueCall RPM upgrade will detect these
options and attempt to fix the config.ini file automatically.
If these options are detected in the preConfig.json file, there will only be a warning and manual
modification is necessary.
Refer to the PLP Configuration section in the TrueCall Configuration Guide for more information.
Beginning in 17.3 you no longer need to remove the TrueCall server RPM then re-install.
Many configuration files are preserved across upgrades, please see any file named <file>.pkg as
these are the newer versions. You should check these files for new content that may need to be
manually incorporated into the active version or entirely replace the old file.
Beginning in 17.6.2 you can optionally integrate with nGenius Configuration Manager for
administration functions. Performing this integration requires multiple changes to standard TrueCall
configuration. The following is an overview to changes required:
As user “root”:
crontab -u daemon -l > /path/to/daemon_crontab_$(date +%d%b%y)
Note: Replace /path/to/ with a valid directory on the TrueCall server, preferably a directory where
anyone can read and write.
Note: It is possible that some or all the TrueCall processes could exist on one node.
Note: If secure LDAP is in use, make a copy of the certificate referenced in the tcaccess.ini file in
the setting labeled “TlsCaCertPath=”.
If COMMON_GSM is in use:
/opt/tc3/etc/TcsServerSettings_COMMON_
GSM/NewfieldWireless/TcsServerSettings_COMMON_GSM.ini
If COMMON_LTE is in use:
/opt/tc3/etc/TcsServerSettings_COMMON_
LTE/NewfieldWireless/TcsServerSettings_COMMON_LTE.ini
If COMMON_UMTS is in use:
/opt/tc3/etc/TcsServerSettings_COMMON_
UMTS/NewfieldWireless/TcsServerSettings_COMMON_UMTS.ini
Note:
l Replace VDR_TECH with the vendor technology in use; i.e, COMMON_LTE, ALU_CDMA, etc.
l LSR is a licensed feature and may not be enabled in the customer’s environment.
l If LSR is licensed, the Cylinder node has the “LSR-server” TrueCall task enabled along with
the “cylinderd” task.
l The stand-alone LSR node would have the “LSR-standalone” TrueCall task enabled without
the “cylinderd” task.
Note: Replace /path/to/ with a valid directory on the server, preferably from where anyone can
read and write.
1. Copy the newly created /opt/tc3/etc/necal_config.ini.pkg over the old necal_config.ini file.
cp /opt/tc3/etc/necal_config.ini.pkg /opt/tc3/etc/necal_config.ini
2. Copy any parameters file with .pkg extensions over the existing copies. These files are in the
/opt/tc3/etc/ directory and begin with nle_parameters_*.
Example: cp /opt/tc3/etc/nle_parameters_common_lte.ini.pkg
/opt/tc3/etc/nle_parameters_common_lte.ini
3. Run the nle setup script.
/opt/tc3/bin/nle_setup.sh
If using LSR, compare the modified lsr/tc3/etc/lsr_config_VDR_TECH.config files against the lsr_
config_VDR_TECH.config backup file created earlier to ensure that everything is as expected.
After configuration files have been modified, restart TrueCall services to apply the changes using one
of the following commands:
As user "root:"
service truecall-server restart
Note:TrueCall Log files are NETSCOUT internal access only. These are used by NETSCOUT
Service & Delivery teams for support purposes. TrueCall engineering reserves the right to
change any information as appropriate in the TrueCall log files. Changes to log files are not
documented.
Note: DO NOT SKIP THE PID AND LOG FILE VERIFICATION STEPS.
It is possible that certain arguments used in the previous version of TrueCall may not be valid in the
new version of TrueCall. The only way to verify this is by checking the stability of the TrueCall
processes and by inspecting the TrueCall log files.
If the value in the “PID” column is changing for any of the TrueCall processes, inspect the log file for
the TrueCall process whose PID is changing to see what errors are being reported.
To access the log file for a given TrueCall task, you will need the label of the bin file used to run the
affected TrueCall task. Open the TrueCall configuration file (/opt/tc3/etc/config.ini) and find the
four-line stanza for the affected TrueCall task. Look at the value of the “label=” argument. The log file
will be accessed using that label value.
Run the command below to access the log file for a given TrueCall task.
less /var/lib/truecall/log/label
Note: Replace label with the value of the “label=” argument in the TrueCall configuration file.
To access the help content for a given TrueCall task, you will need the fullpath of the bin file used to
run the affected TrueCall task. Open the TrueCall configuration file (/opt/tc3/etc/config.ini) and find
the four-line stanza for the affected TrueCall task. Look at the value of the “fullpath=” argument. The
help content will be accessed using that fullpath value.
Run the command below to access the help content for a given TrueCall task.
source /opt/tc3/bin/tc3-env.sh && /full/path/to/binfile -h | less
Note:Replace /full/path/to/binfile with the value of the "fullpath=" argument in the TrueCall
configuration file.
Modify the configuration file accordingly and then restart TrueCall services for the new configuration
file to take effect.
Run the command below to restart TrueCall services if the configuration file was changed:
As user “root”:
service truecall-server restart
After restarting the TrueCall services, run the following command to verify that the processes have
started:
ps -flwwu daemon
For each TrueCall server that has the TrueCall Web Admin Console installed, verify that the TrueCall
Web Admin Console is accessible and that all previous settings still exist. Items that should still exist
and not have changed post upgrade are the users, user groups, NE tables, handset database, and
server settings such as the time zone and BING maps credentials.
Any port number above 1024 can be used for each TrueCall component if the port is not already in
use by another application. If a non-default port number will be used by a TrueCall component, the
port number will need to be specified in the TrueCall configuration file.
If the customer enables a firewall, TCP Ports 49152 - 49168 should be opened to allow for Cylinder
and Query Server communication.
Note: Customers should contact their NETSCOUT representative to obtain copies of any of
the following documents. NETSCOUT employees should use the internal documentation
portal to access documents.
TrueCall provides templates in .txt and .xlsx format from the TrueCall Administrator WebClient in the
following location:
l Network Element Tables > <vendor><technology> Network Element Table > Upload >
Download Templates. The templates (.txt and .xlsx for GSM, LTE, and UMTS) are contained in a
zip file.
The NE table format can change between TrueCall releases. Please ensure that the latest NE table
format is being used for upload.
Note:NETSCOUT recommends that you use either the provided .txt or .xlsx templates for
your data. However, you may also create your own Excel spreadsheet.
l The following LTE vendors can use the naming convention COMMON_LTE_Timestamp.xxx
o Ericsson
o Huawei
o Nokia
o Alcatel-Lucent
o Samsung
o ZTE
l The following GSM vendors can use the naming convention COMMON_GSM_Timestamp.xxx
o Huawei
o Ericsson
o ZTE
l The following UMTS vendors can use the naming convention COMMON_UMTS_
Timestamp.xxx
o Nokia
o Huawei
o ZTE
o Alcatel-Lucent
l Other VTs should use the naming convention VENDOR_TECH_Timestamp.xxx
Example: ALU_CDMA_201402121757.txt
This is also the default naming convention of NE table output from the TrueCall WebClient.
It will also support the addition of a comment string at the beginning of the file-name.
Example: dummy-table_ERC_CDMA_201402121757.txt
The NE Table file name shall consist of less than 255 characters.
Type_start and type_end can be used to create MEID/TAC ranges for certain make/model types. For
MIN and IMSI tables, type_start and type_end would be identical. The table is tab-separated. This is
an example for TAC:
PREFIX_YYYYMMDDHHMMSSddd.txt
Example:
l imsi_20140611191224339.txt
l imei_20140611171524339.txt
l meid_20140421203144321.txt
l tac_20140521113255222.txt
The prefix corresponds to the type of key used for lookup (MIN, IMSI, TAC, MEID).
The above naming conventions must be obeyed. (The milliseconds part of the name may be
omitted.) The purpose is that the handset tables sort properly so that if a table is bad the most
recent good table can be used in its place, and so that older tables can be archived.
Note: If multiple matching methods are being used (e.g. IMSI and TAC) then a file of each type will
need to be uploaded to the server before TrueCall will ingest the files.
l Rename the NE table to include the COMMON technology in the file name.
l Modify the TrueCall configuration file to reference the COMMON technology.
l Reconfigure the TrueCall Web Admin Console for the COMMON technology.
l Move the Cylinder (call records) from the non-COMMON technology to the COMMON
technology directory.
l Upload the renamed NE table for the COMMON technology.
l Configure the TcsTcpServer task to use the correct vendor for the COMMON technology.
The chart below shows which vendor technologies can be migrated to the corresponding COMMON
technology.
Vendor_Tech COMMON_Tech
ERC_LTE COMMON_LTE
HUA_LTE COMMON_LTE
NSN_LTE COMMON_LTE
SAM_LTE COMMON_LTE
ERC_UMTS COMMON_UMTS
NSN_UMTS COMMON_UMTS
l Old ERC_LTE data will lose IMSI/IMEI because the old Cylinder (call records) data has encrypted
IMSI/IMEI, which cannot be decrypted after the migration to COMMON_LTE.*
l If the non-COMMON vendor technology supported Layer 3 messages and did not use GSR
prior to the COMMON migration, the Layer 3 messages for the old call records will no longer
work as the COMMON technology will try and retrieve the Layer 3 messages from a GSR node
post migration to COMMON.*
l For the old call records, any new columns that exist in the COMMON technology will not be
populated in the TrueCall client as those columns did not exist in the non-COMMON
technology.*
*Resolved after the old call records age out of the Cylinder.
*New call records received post migration to COMMON are not affected.
1. Perform the normal TrueCall upgrade with the non_COMMON vendor technology in place.
This includes re-running the “conf-database.sh” and “conf-webclient.sh” scripts.
2. Log into the TrueCall Web Admin Console and download the current NE table for the market.
3. Rename the file to include the new COMMON_TECH in the name.
Example of renaming the downloaded NE table to include COMMON_LTE in the name:
LTE_201705241003.txt -> COMMON_LTE_20170525.txt
4. After the TrueCall upgrade is complete and the NE table is downloaded, stop TrueCall services.
l As user “root”:
service truecall-server stop
l Using sudo permissions:
sudo service truecall-server stop
5. Modify the TrueCall configuration file (/opt/tc3/etc/config.ini) and change the TrueCall tasks
from the non-COMMON tasks to the COMMON tasks. This includes changing the names of
the labels and port numbers used.
Example of migrating the cylinderd task from ERC_LTE to COMMON_LTE:
2/label=cylinderd_ERC_LTE -> 2/label=cylinderd_COMMON_LTE
2/fullpath=/opt/tc3/bin/cylinderd -> 2/fullpath=/opt/tc3/bin/cylinderd
2/workingdir=/opt/tc3 -> 2/workingdir=/opt/tc3
2/args=ERC_LTE|--port=19840 -> 2/args=COMMON_LTE|--port=54101
Configure the TrueCall Web Admin Console to use the COMMON_TECH by modifying the
“/opt/tc3/share/WebClient5/config/local_settings.rb” file and enabling the COMMON
technology.
Refer to the TrueCall COMMON Vendor List Configuration for specific details.
Important: Read this entire section before beginning the installation. This section outlines the
aspects of the standard installation that are different for a MIQS installation than a standard
installation.
N/label=processor-vendor-tech
N/fullpath=/opt/tc3/bin/processor-vendor-tech
N/workingdir=/opt/tc3
N/args=--input-stream-port=NNNN|--ne-db-connection=DB-IP-Address|--
ne-db-name=DB-Name
Where:
l DB-Name is the name of the database on the Query Server. If this argument is not specified,
the processor will default to use 'production' which is the current default database name.
During installation, determine which NE table this processor needs to access and supply that
name using this argument.
/opt/tc3/etc/tcaccess.ini
/opt/tc3/etc/tcaccess2.ini
/opt/tc3/share/WebClient5/config/database.yml
tcaccess.ini refers to the first database called 'production' in database.yml. tcaccess2.ini refers to the
second database called 'production2'.
These database configuration files are specified for the TcsTcpServer applications as command line
configuration items in /opt/tc3/etc/config.ini.
Both databases share the handset database, which can only be updated using the web interface for
'production'.
To access the Web Admin tool, the first server is accessed as it normally is at http//<server>/admin.
The second server is accessed at http://<server>/admin2.
The Clean Server Cache script helps prevent excessive disk space usage by the cache. To enable it on
the Multi Instance Query Server, go to /opt/tc3/bin and rename clean-server-cache-multi-query-
server.pkg to clean-server-cache. You can then edit this file to adjust the maximum and preferred
sizes of the cache.
The Update Bookmarks script runs periodic queries during off hours. To enable it, go to /opt/tc3/bin
and rename update-bookmarks-multi-query-server.sh.pkg to update-bookmarks.sh. You will then
need to make two edits to the script.
Uncomment the appropriate TOOL, LOG_FILE_1 and LOG_FILE2 lines for the appropriate tech. You
should ONLY uncomment 1 of each of these.
Near the bottom of the file, update the ARGS_1 and ARGS_2 lines by adding the correct cylinderd
addresses and pull hosts for the different query servers. These should match the arguments for the
TcsTcpServer applications in opt/tc3/etc/config.ini
12.5 Ports
Using the UMTS or GSM installations will require the customer to open the default UMTS or GSM
ports in their firewall as opposed to LTE. Default ports are listed in the table below.
Note: These are default values and can be changed during configuration.
13.1 Architecture
The following diagram illustrates the differences between TrueCall deployed with Web Admin and
TrueCall deployed with nGenius Configuration Manager.
b. Refer to TrueCall Server Administration Installation to install the portion of the Server
Administration necessary for nGenius Configuration Manager.
c. After TrueCall is installed or upgraded, run the following command:
service httpd stop
Note:
l Hostname should not include https:// or http://
l If using an IPv6 address, enclose it in square brackets.
4. Register the server as a trusted server.
source /opt/tc3/bin/tc3-env.sh
python /opt/tc3/bin/tc_ncm_trusted_server.py --ncm-username={username} --ncm-password=
{password} --enable-stdout-log
Where username and password are the nCM administrator username and password.
5. Create the directory structure for the uploaded files, where each directory owner is
daemon:daemon. These directories are the defaults that the uploader watches.
a. NE Table:
l For a single global setup:
/var/lib/truecall/ne_tables/uploads/
l For a multi-market setup one directory per market is required
/var/lib/truecall/ne_tables/uploads/market1/
/var/lib/truecall/ne_tables/uploads/market2/
/var/lib/truecall/ne_tables/uploads/market3/
/var/lib/truecall/ne_tables/uploads/market4/
b. IMSI whitelist:
/var/lib/truecall/cpni_imsi_whitelist/uploads/
c. handset database
/var/lib/truecall/handset_database/uploads/
d. validation files
/var/lib/truecall/log/ncmvalidations/
6. All TrueCall instances use the same set of handset files. From the upload server, upload
generated files using tc_configuration_uploader to the nCM server, where they can be
downloaded by TcsAdminServer to all TrueCall servers.
Configure /opt/tc3/etc/config.ini to run tc_configuration_uploader and handset_upload_
watcher. The tc_configuration_uploader program uploads the required input files (NE table
and IMSI whitelist) and output files (handset DB):
[TcsTasks]
size=1
1/label=tc_configuration_uploader
1/fullpath=/opt/tc3/bin/tc_configuration_uploader.py
1/workingdir=/opt/tc3/bin
1/args=--cleanup-retention-days=0
2/label=handset_upload_watcher
2/fullpath=/opt/tc3/bin/handset_upload_watcher
2/workingdir=/opt/tc3/bin
2/args=--reqd-handset-file-types=LTE:imsi,LTE:tac
Where cleanup-retention-days determines the cleanup policy of both the local watched
directories and the files stored on the nCM server (=0 means cleanup is disabled). If cleanup is
enabled, cleanup is performed one time per day at midnight. The script retains the newest
three files regardless of file age. Omit the argument if cleanup is not required or will be
manual.
The handset files for the tc_configuration_uploader are generated by the handset_upload_
watcher. The handset_upload_watcher creates output files at two locations.
l <parent-handset-database-dir>/<tech-family>/active
l <parent-handset-database-dir>/<tech-family>/ncmUploads
The files meant for nCM are prefixed with 3gpp/3gpp2.
If, for testing purposes, you manually put generated handset files in the directories specified
by --source-handset-database-3GPP-output-directory and --source-handset-
database-3GPP2-output-directory, ensure that you prefix the file names with 3gpp or
3gpp2.
tc_configuration_uploader performs a check in each watched input directory and uploads any
new files to the nGenius Configuration Manager server. It also downloads any validation files
stored on the nGenius Configuration Manager server to the target directory.
The handset_upload_watcher can be configured to watch for one or more file types. Following
are the valid values:
--reqd-handset-file-types=LTE:imsi,LTE:tac
--reqd-handset-file-types=LTE:imsi
--reqd-handset-file-types=LTE:imsi,LTE:tac,CDMA/EVDO:min,CDMA/EVDO:meid
7. Run the following scripts to setup and initialize the postgreSQL database file structure:
/opt/tc3/share/WebClient5/conf-database.sh
/opt/tc3/share/WebClient5/conf-webclient.sh
8. Customer scripts to upload files to the new upload server need to be modified. Move all input
files to the watched directory.
9. Restart TrueCall services:
As user "root:"
service truecall-server restart
Using sudo permissions:
sudo service truecall-server restart
Refer to the Converting a Standby to a Primary Server topic in the nGenius TrueCall online help when
the primary server no longer functions properly and needs to be replaced.
If you are converting the Standby Server only as a test procedure, refer to the Testing the Standby
Server topic.
1. Login into the nGenius Configuration Manager GUI using the administrator account.
2. Open the User Management module.
3. In the Roles tab create any desired roles, assign each role the required TrueCall privileges.
4. In the User Groups tab create as many groups as desired, to each user group assign the
desired roles depending on the required privileges. (The created user group name must
correspond to a group stored in the query server postgres database).
5. In the Users tab create as many users as required. Make sure to:
a. Assign each user to at least one group.
b. Add the configuration manager (nCM/nG1) server in the Server Access section for
authentication.
c. Add any TrueCall servers that this user will connect to in the Server Access section.
Note: All migration scripts discussed in this section are installed by the TrueCall-Server-XXX.rpm.
Role Privilege
TCLOGINC TrueCall Client Login
TCCPNI TrueCall Display CPNI Information
TCEMAILD TrueCall Enable Daily E-Mails
TCEMAILS TrueCall Enable Server E-Mails
TCSELFSERVICE Configure User Account Self-Service
l The central server can be any TrueCall server but the best choice would be to use the Upload
server as the central server.
Note: To avoid conflict between the nGenius Configuration Manager system administrator user
"administrator" and the TrueCall group name "administrator," the TrueCall group name is
replaced with "tcadministrator."
Option Description
--enable- print the log to standard out (default: False)
stdout-log
--tcaccess- TCACCESS_CONFIG specifies whether a non-default tcaccess file should be used
config (default: /opt/tc3/etc/tcaccess.ini)
--send-file Turn on this option to send the user information file to --destination-hostname.
(default: False)
-- DESTINATION_HOSTNAME Hostname of the computer to which the user information
destination- file will be copied. (default: None)
hostname
-- DESTINATION_DIRECTORY Name of the directory on the destination hostname to
destination- which the user information file will be copied. (default: /var/lib/truecall/user_
directory migration/remote_profiles)
--username USERNAME Name of the account on the destination computer. (default: None)
--local- LOCAL_DIRECTORY Name of the directory on the local computer in which the user
directory information file will be written. (default: /var/lib/truecall/user_migration/local_profiles)
This program takes TrueCall PostgreSQL as input and writes the following files as output:
<hostname>-TcUserInfo.txt
<hostname>-TcGroupInfo.txt
It sends the two files over scp to a central server to a location specified by the --destination-
directory.
Run this program only on the central server where all the <host>-TcUsersInfo.txt <host>-
TcGroupInfo.txt files are collected. The add_group_<group name>.txt file is used to create groups.
The output directory specified by --output-directory is created when the program is run.
Option Description
--input-directory INPUT_DIRECTORY Input directory where to look for group information
files. (default: /var/lib/truecall/user_migration/remote_profiles)
--output-directory OUTPUT_DIRECTORY Output directory where to put output files. (default:
/var/lib/truecall/user_migration/groups)
--enable-stdout-log Print the log to standard out (default: False)
--server-access SERVER_ACCESS Name of the nCM server, defined as "Server Name" in
the nCM interface in the Server Management Module. Provides nCM
server access to group members so that they can be authenticated.
l add_group_<group name>.txt: It has groups along with their respective permissions in the
following format:
<userGroups>
<userGroup>
<name>nCMadmin</name>
<description>Test user group for nCM testing</description>
<digitsToMask>14</digitsToMask>
<isSliceSize>true</isSliceSize>
<sliceSize>14</sliceSize>
<isDataCaptureOverride>false</isDataCaptureOverride>
<servers>
<server>Configuration Manager</server>
</servers>
<roles>
<role>
<roleCode>TCCPNI</roleCode>
</role>
<role>
<roleCode>TCLOGINC</roleCode>
</role>
</roles>
</userGroup>
</userGroups>
This file does not contain conflicting groups. A conflicting group is defined as a group which is
present in more than one PostgreSQL database and has different set of permissions. This
program writes conflicting groups to the conflicting_groups.txt file.
This program does not resolve any conflicting group. You can resolve a conflicting group by
looking in the conflicting_groups.txt file and moving it to the add_groups.dat file after making
appropriate adjustments to the permission set.
l all_groups.txt: It has all the groups.
l conflicting_groups.txt: It only has conflicting groups.
In both cases, individual users are written in XML format in add_user_<User Name>.txt files at --
output-directory.
It also writes users_info.txt file which contain users information (in the format: e-
mail:username:password) to be used by 05EmailSender.py program to send new nCM passwords to
respective users.
Options Description
--input-directory INPUT_DIRECTORY Input directory where to look for group information
files. (default: /var/lib/truecall/user_migration/remote_profiles)
--output-directory OUTPUT_DIRECTORY Output directory where to put output files. (default:
/var/lib/truecall/user_migration/users)
--add-groups- ADD_GROUPS_DIRECTORY Filepath to where add_group_<group name>.txt
directory being generated by 02GroupsGenerator.py is located. (default:
/var/lib/truecall/user_migration/groups)
--enable-stdout-log print the log to standard out (default: False)
--server-access SERVER_ACCESS Name of the nCM server (defined as "Server Name" in
the nCM Server Management module). Provides nCM server access to
users so that they can be authenticated.
The program takes user information from <hostname>-TcUserInfo.txt in the --input-directory. The
group information is located in the directory specified by –add-groups-directory.
Note:
Options Description
--ncm_host nGenius Configuration Manager server host. The nGenius
Configuration Manager only accepts secure http connections, so specify
https in the host address.
--ncm_port nGenius Configuration Manager server port.
--ncm_username nGenius Configuration Manager user name and password. If the
--ncm_pwd underlying server is registered as a trusted server, the username and
password are not required.
--directory Directory where user/group files are located.
--file_type group|user
Sample commands:
./04CreateUsersAndGroups.sh -ncm_host nfw-qencm-01.newwireless.com -ncm_port 8443 -ncm_username
administrator -ncm_pwd netscout -file_type group -directory /var/lib/truecall/user_
migration/groups
/04CreateUsersAndGroups.sh -ncm_host nfw-qencm-01.newwireless.com -ncm_port 8443 -ncm_username
administrator -ncm_pwd netscout -file_type user -directory /var/lib/truecall/user_
migration/users
Option Description
--users-info-file USERS_INFO_FILE Input file where to look for user information. The format
is: email:username:password. (default: /var/lib/truecall/user_
migration/users/users_info.txt)
--tcaccess-config TCACCESS_CONFIG Specify if a non default tcaccess file should be used.
The tcaccess.ini requires a [Email] section. The section shall contain
MailServer and EmailAddress options. (default: /opt/tc3/etc/tcaccess.ini)
--email-content-file EMAIL_CONTENT_FILE Specify email content in the file specified by this
option. (default: /var/lib/truecall/user_migration/users/email_content.txt)
--enable-stdout-log print the log to standard out
users_info.txt: This file takes its input from users_info.txt file specified by the command line option
--users-info-file. This file is generated by 03UserMigrationUsersGen.py program. The users_info.txt
file has one row per each user and its format is:
email:username:pwd
email_content.txt: This file contain subject and content for outgoing mails. There should be two
lines one per subject/content. The format must be following:
subject: <subject>
content: <content>
This program sends email to all the users specified in users_info.txt. The outgoing email format is:
Hi <username>,
<content>
Username: <username>
Password: <pwd>
Thanks,
TrueCall team
Where:
<content> is from the 'content' section in the file specified by the command-line option --email-
content file
<ncmadmin> you might want to give it its own group property cn=ncmadmin
l nG1 database password
l Get familiar with the LDAP documentation on the nGenius Configuration Manager by reading
the online help, accessed from the Settings menu in the upper right corner of the console.
Refer to CONFIGURING AND MANAGING nGenius ONE > MANAGING SERVERS AND USERS >
Settings Tab > Authentication > LDAP
Login to nGenius Configuration Manager using the <ncmadmin> account. If the ldap configuration is
correct the <ncmadmin> will have access to the server configuration
Note: This <ncmadmin> account will be needed by TrueCall to perform upload/download of files
as well as user authentication
Note: nGenius Configuration Manager seems to reject short passwords even if the password is
valid in LDAP
If login for <ncmadmin> works configuration is correct you can skip to Assign the Correct Roles to
Each Group Configured in LDAP. If not, proceed to the next section.
If the LDAP configuration is wrong you will no longer have access to the web GUI for nGenius
Configuration Manager since enabling LDAP disables nGenius Configuration Manager local users.
User: administrator
Password: netscout1
The following table explains which TrueCall components require which files from nCM.
Files
By default, the list of recipients is obtained from the local PostgreSQL database. After nGenius
Configuration Manager is enabled, the list of email recipients is obtained from nCM and are those
with EMAILD privilege granted.
Change all the configured cronjobs by passing the command line argument --want-ncm-
configuration:
LD_LIBRARY_PATH=/opt/tc3/lib PI_APP_FRAMEWORK_
PATH=/opt/tc3/lib/python/site-packages/appFrameworkPython/
PYTHONPATH=/opt/tc3/lib/python/site-
packages/appFrameworkPython/:/opt/tc3/lib/python/site-
packages:/opt/tc3/bin /opt/tc3/bin/daily-report --cylinderd-host
HOSTNAME --vendortech COMMON_LTE COMMON_UMTS HUA_CDMA --want-ncm-
configuration 1 >> /var/lib/truecall/log/daily-report-cron.log 2>&1
Replace HOSTNAME with the actual hostname where the cylinder is located. This generates the
report for each of the technologies specified in --vendortech, but only if the technologies are
using the default port. If using non-default ports, use --cylinderd-port to specify the port for
one vendor tech at a time.
For these servers, the trusted registration tool detects the IPv6 interface and prioritizes it. Then the
nGenius Configuration Manager associates the trusted key with the IPv6 address not the IPv4
address. Requests using this key coming from the IPv4 address will be rejected by the nCM and, as a
result, a 401 or 403 error (unauthorized access) appears in the TrueCall logs. Connections made
using IPv6 will not have problems.
Check the route used between two servers by using either ping or traceroute as shown in the
following examples:
ping hostname-to-ncm-server
ping6 hostname-to-ncm-server
traceroute hostname-to-ncm-server
Note which of the two pings work (ping for IPv4 and ping6 for IPv6) or note the final hop of the
traceroute output. The traceroute determines the correct IP version to use. Compare that to the
address reported in the nCM GUI.
If the nCM GUI shows an IPv6 address, but the test result shows an IPv4, then the registration tool
needs to be forced to use the IPv4 address instead. Remove the IPv6 address from the nCM using
the GUI and register the server again using the following command on the server to register it as a
trusted server.
source /opt/tc3/bin/tc3-env.sh
python /opt/tc3/bin/tc_ncm_trusted_server.py --ncm-username={username} -
-ncm-password={password} --local-hostname={trusted server hostname} --
local-ipv4={trusted server ipv4 address}
--enable-stdout-log
Run registerGroupsWithHostname.py
Option Description
--enable- Print log messages to stdout. (default: False)
stdout-log
--tcaccess- TCACCESS_CONFIG Specify if a non default tcaccess file should be used. The
config tcaccess.ini requires a [Email] section. The section shall contain MailServer and
EmailAddress options. (default: /opt/tc3/etc/tcaccess.ini)
--ncm-scheme NCM_SCHEME Scheme or protocol used for communication with the nCM server.
Scheme will override the scheme provided in tcaccess.ini. If the scheme is provided as
a command-line argument, the hostname and port have to be provided as well. If the
hostname is provided but not scheme, the scheme will default to https. (default: None)
--ncm-hostname NCM_HOSTNAME Hostname will override the hostname provided in tcaccess.ini.
Enclose IPv6 addresses in square brackets. (default: None)
--ncm-port NCM_PORT Port will override the port provided in tcaccess.ini. (default: None)
--ncm-username NCM_USERNAME Provide an administrator username to authenticate with the nCM
server. (default: None)
--ncm-password NCM_PASSWORD Provide the administrator password to authenticate with the nCM
server. (default: None)
--local- LOCAL_HOSTNAME Hostname with which to register user groups available on the
hostname underlying QueryServer. The hostname will be automatically determined by the
program. Use this option to set --local-hostname manually. (default: None)
Sample command:
/opt/tc3/bin/registerGroupsWithHostname.py --enable-stdout-log
The user groups are fetched from the PostgreSQL database. If the fetched user group is present on
the nCM server, it gets registered with the Query Server hostname. To verify, log into the nCM GUI
and open the User Management module and the User Groups tab. Users should appear in the group
with access to the host (Server Access pane).
Refer to the appropriate section in the TrueCall Configuration Guide for configuration procedures
specific to each service.