Keywords: unable to connect to interaction, lists not loading, forms or activities not writing back.
If you are experiencing issues with Vuture establishing a connection with InterAction or are unable to connect to the web client, use the following article to help diagnose the issue.
You will need the following information to help you through:
- Your internal InterAction URL: this is the address where you connect to the InterAction Web Client
- An InterAction user account
- *Understand how & where Vuture connects to your InterAction environment
- The server details and URL for the server Application that Vuture connects to
*Vuture connects to your InterAction environment via a publicly available URL, based on valid SSL certificate, over port 443. The InterAction Application Server we connect to may or may not be the same as the internal server that internal InterAction users connect to when they log in to the Web Client. Please refer to your IT / Networking team to confirm details and access rights.
Have there been any changes at all to your InterAction environment that could have caused connectivity issues?
Please work with your internal IT team to review any patches, hot-fixes, updates, changes security settings, policies etc for the SQL Server where the DB is hosted, the InterAction Application server and the firewall that may have taken place before the outage began.
Please let Vuture Support know what changes were made so that we can assist you to resolve the connection issues.
If no changes have occurred, please follow the steps below prior to contacting Vuture support:
1. Log on to the InterAction application server that Vuture connects to
- Vuture may not necessarily be integrated with your InterAction environment via the application server(s) that your users connect to. It is possible that Vuture is connecting to a specific or dedicated InterAction Application server
- The server IP address can be found by resolving the URL that Vuture is configured with
- All the checks below should be run from the InterAction Application Server that Vuture connects to.
2. Are you able to log on to the server with Vuture credentials?
3. Is IIS running?
- In Internet Explorer, browse to http://localhost . If the IIS holding page is not displayed check the IIS service is running.
4. Is Tomcat (the InterAction Application Service) running?
- In Internet Explorer, browse to http://localhost:8100. If the Tomcat Apache page is not displayed the InterAction Application service is not running.
5. Is the InterAction Application Service connecting to the InterAction database?
- In Internet Explorer, browse to http://localhost:8100/interaction. If the InterAction login page is not displayed the service is not able to communicate with the database
- Check the amount of memory being used by the InterAction Application Service listed as Tomcat6 in Task Manager. If this is less than 100,000K the service has not properly initialised for InterAction
- Check the application log file for additional error information. This file is located in ….\Program Files\LexisNexis\InterAction\AppServer\log
6. Restarting the IA Application Service
- Restarting the InterAction Application Services from the services console is the fastest way to clear the application cache and restart the application.
- It may be useful to note how much memory the InterAction Application Service uses by monitoring tomcat6.exe in Task Manager
- Restarting the InterAction Application Service will introduce a period of "downtime" for all users, services and applications that connect to this server whilst the Application service recycles
- If you have changed any IIS settings, an IIS restart is required as well and can be completed using the command "iisreset". Alternatively rebooting the server will restart both IIS and InterAction, although this will require more time than restarting the individual services.
7. Intermittent Connectivity
If you are having intermittent connectivity issues it implies that there is a load balancer involved here and potentially one of the server(s) within the farm is having some connection problems. Traces and logs will need to be tracked to identify what is causing this. Otherwise, another option is to connect to each server individually to see if you can identify where this is coming from.
Unable to load InterAction lists
If you are unable to load InterAction lists when on the Send Email screen, check the following:
1. Public URL and IP Address
We connect to your Vuture Application Server using a public URL that should resolve to an IP address that points at the firewall that connects Vuture to your InterAction Application Server. Vuture support can provide you with this URL. Check that this URL has the correct public IP address.
2. Firewall
There should be rules allowing incoming traffic from Vuture to your InterAction Application Server on port 443 - check these rules haven't been changed . Vuture support can provide you with the IP addresses that Vuture is using to connect.
3. IIS Bindings
There should be a secure binding on the IIS on the InterAction Application Server for the public URL in 1. above. Check this binding has not been removed or changed
4. SSL Certificate
There should be a valid public SSL certificate for the public URL in 1. above installed on the InterAction Application Server.
If the SSL certificate has expired there is a temporary workaround that can be put in place until the certificate is renewed which should be done as soon as possible. See this helpdesk article for details.
5. Hosts File
Sometimes we have seen the requirement for a hosts file entry for the public URL in 1. above pointing at the internal IP address of the IA Application Server
6. Web Client
Check the web client is running - try restarting IIS, the InterAction Application Service and the Server itself - this will cause downtime for any internal users connecting to this IA App Server. See this helpdesk article for details
7. Usernames and Passwords
Typically there is an IIS username and password and an InterAction username and password. Confirm that Vuture has the correct value for these.
Further settings to check
- If you are using IIS authentication (this is recommended), ensure Windows Authentication is enabled, Anonymous Authentication is disabled on the default website on IIS, the Windows account username and password are valid, and an Authorisation Rule for the windows account being used exists on default website and is inherited by the IAHome sub-directory
- Using Windows Authentication, ensure that Extended Protection is enabled
- Ensure that the server has adequate disk space, and older log files are being archived or removed as required
- The Server OS is patched and up-to-date and has a regular restart policy in place
- IIS has been optimised as per LexisNexis recommendations which can be found on the InterAction Support site
- Review the server event logs to find the root cause of any errors
- The InterAction Application service is patched to appropriate & matching version as the InterAction database
- If you have multiple InterAction Application servers, that each is running the same software & patch version for InterAction
- If continuing to have authentication issues such as receiving 401 messages when trying to authenticate, we have a setting with Vx which helps to PreAuthenticate HTTP requests. To have this disabled please speak to your Account Manager to disable this setting: Admin.System.Advanced Options.PreAuthenticate HTTP Requests