Overview
You rebooted recently one of the Application Gateways (AGW) that belong to your Lithium farm, and all processes were up normally afterward. However, textpass is showing as not active and cannot be started suddenly.
Information
An incomplete manager data file for that server with missing updates on the Routing list might be the key cause behind the failure in the startup of the textpass process on this node. To fix this issue, make sure you complete the following steps:
- Log in to the faulty server.
- Execute
tp_stop
on the server, so it stops the process.
- Search and open the Syslog file.
- Look for a trace with the following information:
You will see that TEXTPASS-SMS-MIB reported an error: listcondition.<index>.<position> (in this case, index is 6 and position 3931).
- Open the Web GUI and go to the list menu:
- Open the list with the index identified in the error.
- Edit the Routing List at the Index number shown in the error, at the correct position (In this example's case, it was index 6 and position 3931). You can cut it and paste it at the end of the list and save the list.
Please keep in mind that the system should not be left in this status when these alarms appear after a change to prevent the RTRs from stopping, and in similar situations. You need to review that incorrect value indicated on the error and correct it immediately when this message appears.
To avoid Textpass issues related to data entry in the MGR, entry validation can be performed at the time of input using a validator tool like a Unicode Character Detector to ensure no invalid characters will be added that may trigger a Textpass error. Once the characters in the list are checked and entered in the GUI, check to ensure there is no space at the beginning and end of the string. - Save the list.
- Go to Settings > Network Layout > Devices and select the device you want to disconnect.
- Make sure that you uncheck the
Allow Connection
checkbox for the RTR instances on this server. - Activate the previously saved list (Select it, and click the menu to get the Activate option shown), as shown in the following pictures:
- Go to Settings > Network Layout > Devices again, and select all the checkboxes on the right side of the screen. Then, select Resync from the drop-down menu.
(Optional) Copy the content of the/usr/TextPass/etc/MGR*
folder into a/tmp
folder.
mv /usr/TextPass/etc/MGR* /tmp
- Repeat steps 10 and 11, but this time, check back the
Allow Connection
checkmark for the RTR instances on this server. - Log back as root and execute the following commands:
systemctl restart mgr - To restart the Server
systemctl status mgr - To reconfirm MGR startup - Once the server restarts, Execute
tp_start
on it so the process can start. - Finally, execute the following command on all nodes to reconfirm if the list entries are up to
date:
tp_walk listcondition