Adding Queues and Segments

Use this information to troubleshoot common Configuration issues.

Activation Issues

Detailed information on activation results, including any errors that occurred.

Summary Details

Use for troubleshooting a partial or failed activation.


Field	Description
Successes	The total number of queue and segment records saved. Each corresponds to a single database commit + a corresponding message to Queue Manager. For a queue, this includes: Queue Variables Operation Schedules Holiday Operation Days to Offer Scheduled Callbacks Scheduled Callback Limits Business Hours
Already Existing	The number of records flagged as duplications of existing data. Duplicate records will not cause the activation to fail, but you should investigate these records and correct them if needed.
Exceptions	The number of records where something went wrong with the activation process.
Missing Parents	The number of records which contained a child record with missing parent data.
Rollbacks	The number of records rolled back to their original state after data was saved to VHT_Config, but not QMCL or vice versa. See Lost Connection to Queue Manager or VHT_Config, below.
SQL Errors	The number of SQL errors which occurred while saving to the VHT_Config database. See Lost Connection to Queue Manager or VHT_Config, below.
SQL Exceptions	The number of SQL exceptions which occurred while saving to the VHT_Config database. See Lost Connection to Queue Manager or VHT_Config, below.
Errors Returned - Table Name	The table name where the error occurred.
Errors Returned - Result	The error text which was returned.
Errors Returned - Column Name	The column name where the error occurred.
Errors Returned - Column Value	The column value which triggered the error.

Lost Connection to Queue Manager or VHT_Config

Partial or failed activation can occur if the service loses connection either to Queue Manager or to the VHT_Config database.

Rollbacks, SQL Errors, or SQL Exceptions in the summary details state if this is the case. If so, wait until the connection restores and reactivate the change group.

Other Issues


Issue	Cause	Action
Configuration icon does not display in Launchpad -or- 401 Unauthorized	User is not logged in with with correct access level.	See User Access Levels for which icons will be displayed by access level.
Configuration icon does not display in Launchpad -or- 500 Unable to get to Sites Info	The Configuration datastores were not configured correctly after installing or upgrading the VHT Callback^® system.	On each management instance of Callback, navigate to the Configuration installation directory (default is C:\Program Files (x86)\Virtual Hold Technology\ConfigurationManagement) and confirm that a Mnesia node named Mnesia.confmgmt@domain_name has been created. If the Mnesia node does not exist: Stop the VHT Configuration service. Navigate to the \bin directory inside the Configuration installation directory (see above). Double-click the first_time_initialization_of_configuration_management_datastore_connection.cmd file. Confirm that the Mnesia node now exists in the location listed above. Start the VHT Configuration service. Repeat these steps on each Management instance.
The service is temporarily unavailable. Please retry your request.	The Configuration service cannot connect to the VHT_Config database.	Try your action again. If you receive the message a second time, SQL Server may not be functioning or there may be a connectivity issue.
Unable to locate a change group with ID "xxxxxxxxxxxx".	User pasted a URL in the browser for a change group that no longer exists	Return to the Configuration home page. From here you can create queues or segments for a new change group, or click Search Pending Changes to search for an existing change group.
Unable to remove a segment from a change group	Clicking Remove only Segment is the only segment in the change group	Click Remove, Yes to confirm, then Save & Review. The last segment from a change group cannot be removed. The change group must be deleted. Choose Pending Changes from the main Queues page to search for the change group containing the segment to be removed. Click Review. Click and Yes to confirm.
Cannot see a newly-created queue in Configuration drop down	The queue list needs to be manually refreshed
Incorrect uid in site.config causes the Configuration service to shut down	Incorrect username prevents a connection to the VHT_Config database	Enter the correct uid in the site.config file. Restart the service.