Configuration

How can I monitor an additional web application in my SharePoint farm?

When I run the IIS Logs Import, I get the following error, "Cannot run process cmd.exe: Cannot open : Error opening files: Error opening file 'C:\inetpub\logs\LogFiles\W3SVC1\ex110101.log': The system cannot find the file specified. "

This issue occurs when running a 32-bit version in 64-bit systems. Ideally, upgrade to the latest 64-bit release version.

In order to workaround this issue, edit the CardioLog machine registry (and the CardioLog Installation key): 
Copy: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Intlock\CardioLog 
To: HKEY_LOCAL_MACHINE\SOFTWARE\Intlock\CardioLog

Why do I get "Missing or invalid product license" error, even though my license is valid?

The CardioLog Scheduling Service is started but all the jobs fail. Why do I see the "Exception has been thrown by the target of an invocation" error in my log file.

Why are my SharePoint Publishing Sites not being tracked when using the "CardioLog Analytics SharePoint Feature"

The CardioLog Analytics SharePoint Feature will work only for master pages which contain the following control in the head section: 
<SharePoint:DelegateControl runat="server" ControlId="AdditionalPageHead" AllowMultipleControls="true"/>

This control is included in the master pages for all SharePoint templates, except for the MOSS Publishing Site master page.

Add this control to each of your master pages, right before the closing </HEAD> tag. Alternatively, you can perform a single update, by using a top master file which is included in all of the Publishing Sites master pages.

Why do I get the error "Error: trying to remove main branch, persist stopped" when running Portal Tree Updates?

This is a safety mechanism which is triggered in order to prevent the removal of a monitored environment from CardioLog (eg. a SharePoint farm, a custom website). It is raised when removing a tree adaptor web service URL from the web services list in Portal Tree Updates service configuration.

If you wish to bypass the safety mechanism and remove a monitored environment (eg. a main tree branch in the CardioLog tree structure), follow these steps:

1. Execute the following query against the CardioLog database:
   

   SELECT [url],[location]
   FROM [CardioLog].[dbo].[tab_sharepoint_tree]
   WHERE LEN(location) = 12

2. Copy the [location] value of the monitored environment you wish to remove from the above query. Place it in the following query (replace 'location to remove' with the actual value):
   
   INSERT INTO [CardioLog].[dbo].[tab_exclude_main_branches]
   ([location])
   VALUES
   ('location to remove here')
   GO 
    
3. Run the Portal Tree Updates service.

Note: The monitored environment you have removed will be marked as deleted in the CardioLog tree structure. In order to view history usage data in reports for it, go to the Analysis Center and click Show Deleted Items.The removed monitored environment tree branch will appear in red in the tree structure and will be available for reporting.

Why do I get the error "Navigation to the webpage was canceled" when exporting a report to PDF?

When exporting a report to PDF and opening the PDF file, you may encounter the "Navigation to the webpage was cancelled" error. 

The export operation is executed on the CardioLog server. It opens a web browser object with the report, takes a screenshot of it and saves it as a PDF file. This process can fail if the report URL is inaccessible locally on the CardioLog server, due to insufficient permissions or security restrictions.

In order to resolve the issue, open [CardioLog Installation Folder]\CardioLog\web.config and edit the following key value: 

<add key="CardioLogPDFRoot" value="http://[CardioLog Host Name]:[CardioLog Port Number]/" />

[CardioLog Host Name] - the CardioLog server name
[CardioLog Port Number] - the CardioLog port number (the default port is 29999)

Change the [CardioLog Host Name] value to "localhost",  CardioLog server IP or to the CardioLog server name including the fully qualified domain name and try the export again.

If this did not resolve the error, try the following steps:

1. Verify that the CardioLog application pool user has local administrator permissions, and that there are no group policy settings or security restrictions (popup blockers, proxy rules, disable scripts etc.) on the CardioLog server default browser. 
2. Turn off User Account Control (UAC) on the CardioLog server. To do this: Open the system Control Panel > System and Security > Change User Account Control Settings > Adjust it to "Never Notify"
3. Make sure to have all CardioLog URLs (localhost, IP, server name, FQDN) in Trusted Sites both in server and client. If the CardioLog server's default browser is Internet Explorer, go to Internet Options, and in the Security tab, uncheck "Enable Protected Mode" and lower "Security Level For This Zone". Close IE. 

Why do I get the error "Server Error in '/CardioLog' Application - Access is denied." when I open Administration > System Diagnostics?

First, verify that the CardioLog application user account has local administrator permissions on the CardioLog application server and has permissions for starting and stopping the CardioLog services.

Secondly, open IIS Manager and navigate to IIS > Connections > Application Pools > Actions > Stop, and restart the CardioLogApplicationPool.

What is my product version number?

Why does the 'Last Event #' in the tracking agent display as 'None' or 'N/A'?

Why do I get the error "A configuration error has occurred." on my SharePoint WFEs?

The following error may occur on the SharePoint WFEs Event Log when installing the CardioLog Analytics Tracking Agent Feature:

3008 
A configuration error has occurred. 
6/17/2013 3:01:05 PM 
/LM/W3SVC/12345/ROOT-1
WSS_Minimal
C:\inetpub\wwwroot\wss\VirtualDirectories\SharePoint - 80\ 
WFESERVER01 

1032 
w3wp.exe 
MYCOMPANY\useraccount
ConfigurationErrorsException 
It is an error to use a section registered as allowDefinition='MachineToApplication' beyond application level. This error can be caused by a virtual directory not being configured as an application in IIS. (C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\template\layouts\cardiologagent\web.config line 36) 
http://sharepoint/_layouts/CardioLogAgent/CardioLogAgent.js 
/_layouts/CardioLogAgent/CardioLogAgent.js 

at System.Configuration.ConfigurationSchemaErrors.ThrowIfErrors(Boolean ignoreLocal) at System.Configuration.BaseConfigurationRecord.GetSectionRecursive(String configKey, Boolean getLkg, Boolean checkPermission, Boolean getRuntimeObject, Boolean requestIsHere, Object& result, Object& resultRuntimeObject) at System.Configuration.BaseConfigurationRecord.GetSection(String configKey) at System.Web.Configuration.RuntimeConfig.GetSectionObject(String sectionName) at System.Web.Configuration.RuntimeConfig.GetSection(String sectionName, Type type, ResultsIndex index) at System.Web.Configuration.RuntimeConfig.get_Identity() at System.Web.HttpContext.SetImpersonationEnabled() at System.Web.HttpRuntime.ProcessRequestNotificationPrivate(IIS7WorkerRequest wr, HttpContext context)

These errors may appear when the CardioLogAgent web application under the SharePoint website /_layouts folder in IIS is not configured as a web application.

In order to resolve it, open IIS Manager > Right click the CardioLogAgent directory located under the SharePoint website (http://sharepoint in this example) /_layouts folder and select "Convert to Application"

Why do I get the error "Invalid object name 'tab_iis_log_import_temp'" when I run the IIS Logs Import?

CardioLog Analytics uses the Log Parser tool in order to parse the IIS log files. 

Verify that the following key in the [CardioLog Installation Folder]\CardioLog\web.config file contains the correct path to the Log Parser tool installation folder, which should be:

<add key="IISLogParserPath" value="C:\Program Files (x86)\Log Parser 2.2\LogParser.dll" />

You can download the latest version of Log Parser from Microsoft.

How do I change my user interface's language and date format?

In order to change your user interface language and date format, perform the following steps:

1. Open CardioLog Analytics > Administration > System Configuration > Configuration Wizard.
2. In Step 1 select the language and date format.
3.  Click Next and close the browser.
4. Perform IISRESET on the CardioLog application server.
5. It is recommended for end users to delete their browser cache after changing the language. 

Available languages:

• English - Great Britain
• English - United States
• French - France
• German - Germany
• Japanese
• Portuguese - Portugal
• Spanish - Spain (Traditional)

Why do I get the warning "Failed to collect SQL statistics" when I run the Usage Data processing job?

How do I create the CSV of my Site Collection for the SharePoint Online Adaptor?

To import your SharePoint Online Site Collection using CSV that will then be applied via the SharePoint Online Tree Adaptor, follow these steps:

1) Create a folder on the root drive (If not C:/ just change location in script) called Scripts.
2) Make a .CSV file called NewSiteCollections.csv (c:\scripts\NewSiteCollections.csv)
3) Open the SharePoint Online Management Shell and input these lines of code:

$csvfile = 'c:\scripts\NewSiteCollections.csv'

Connect-SPOService -Url https://[login]-admin.sharepoint.com/ -Credential [Login].onmicrosoft.com

Get-SPOSite | Export-CSV $csvfile

4) Change login to correct variable.
5) If you get an error that reads "Failure to recognize Connect-SPOService" , update to the latest Sharepoint Online Management Shell from Microsoft.
6) Place the attached file in [CardioLog Installation Folder]\CardioLog\Bin
7) Open CardioLog and via the navigation pane, go to Administration > System Configuration > SharePoint Tree Adaptor and select the relevant version of SharePoint.
8) Enter the location of the CSV file containing the Site Collection list and click apply.
9) Choose the websites you would like to track.

Please run this script on a regular basis either manually or using automation to update the CSV frequently. We recommend keeping this updated daily in order to keep all changes made in your Online environment in sync with your Portal Tree and your reports.

How do I configure the CardioLog Agent to collect users' real IP addresses when they go through a Proxy?

If your users access your site through a proxy, then the CardioLog Agent will collect the proxy IP address instead of the users real IP address.

By default, CardioLog Agent looks at the  "REMOTE_ADDR" HTTP request server variable. When using a proxy, this variable will only contain the IP of the proxy server.

Alternatively you can set the CardioLog Agent to look at the "HTTP_X_FORWARDED_FOR" HTTP server variable, which will in most cases contains the end user real IP address behind the proxy.
To do that, change the "UserIpBehindProxy" key value in the CardioLogAgent\web.config file to 'true':

 <add key="UserIpBehindProxy" value="true" />

If the "CardioLog Analytics" SharePoint feature is installed on your SharePoint on-premise farm, the CardioLogAgent folder should be located on all SharePoint WFEs within the SharePoint website "_layouts" folder:

SharePoint 2007 - "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\LAYOUTS\CardioLogAgent\".
SharePoint 2010, 2013, 2016 - "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\LAYOUTS\CardioLogAgent\".

Otherwise, the CardioLogAgent folder should be located in the CardioLog Installation folder, which is located by default in C:\Program Files\Intlock\CardioLog\CardioLogAgent.

How do I configure email in CardioLog?

You can automate different actions by configuring email contacts using the CardioLog Scheduling Service. This will allow you to:

• Share Reports automatically with colleagues using a distribution list.
• Automatically alert system administrators about errors running system jobs

Why do I get an authentication login box when I try to access the CardioLog web site locally on the server, even after submitting correct network credentials?

This issue may occur when the server tries to browse to itself recursively. Try to browse to the CardioLog web site from your workstation or from a different server to confirm that this is the issue.

To resolve this issue on the server, you will have to disable the Loop Back Check in the registry.

1. Go to Run and type regedit to open the Registry Editor.
2. In the Registry Editor, select the registry key that reads: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa
   
3. Right-click Lsa, select New, and then select DWORD Value.
4. Type DisableLoopbackCheck, and then press ENTER.
5. Right-click DisableLoopbackCheck, and then click Modify.
6. In the Value data box, type 1, and then click OK.
7. Quit the Registry Editor, and restart your computer.

Why do I receive the error "Access to the path 'C:\Program Files\Intlock\CardioLog\CardioLogAgent\CardioLogAgent.js' is denied" in the Configuration Wizard?

When selecting "Yes, install and activate the 'CardioLog Analytics' SharePoint Feature" in Step 2 of the Configuration Wizard, the following error may appear at the top of the window:

Access to the path 'C:\Program Files\Intlock\CardioLog\CardioLogAgent\CardioLogAgent.js' is denied

This error is raised when the CardioLog service account has insufficient permissions.

Please confirm that the CardioLog service account is a local administrator on the CardioLog server and that it has all required permissions, then run the the Configuration Wizard when you are logged on to the server with the CardioLog service account.

Why do I get the error "Error installing the 'CardioLog Analytics' Feature: Failed to restart service. Server Response: Service SPAdminV4 was not found on computer'" in the Configuration Wizard?

When selecting "Yes, install and activate the 'CardioLog Analytics' SharePoint Feature" in Step 2 of the Configuration Wizard, the following error may appear at the top of the window:

Error installing the 'CardioLog Analytics' Feature: Failed to restart service. Server Response: Service SPAdminV4 was not found on computer '.'

This error is raised when the CardioLog service account has insufficient permissions.

Please confirm that the CardioLog service account is a SharePoint farm administrator and a local administrator on all SharePoint servers and that it has all required permissions, then run the the Configuration Wizard when you are logged on to the server with the CardioLog service account.

Why do I get the error "stsadm addsolution error: Object reference not set to an instance of an object." in the Configuration Wizard?

When selecting "Yes, install and activate the 'CardioLog Analytics' SharePoint Feature" in Step 2 of the Configuration Wizard, the following error may appear at the top of the window:

There was some problem with the installation or activation of the 'CardioLog Analytics' SharePoint Feature: 
stsadm addsolution error: Object reference not set to an instance of an object. The Solution installation failed. 

This error is raised when the CardioLog service account has insufficient permissions.

Please confirm that the CardioLog service account is a SharePoint farm administrator, a local administrator on all SharePoint servers, a "db_owner" on the SharePoint config database, and it has all required permissions, then run the the Configuration Wizard when you are logged on to the server with the CardioLog service account.

Why do I get the error "HTTP Error 407 - Proxy Authentication Required" in the CardioLog UI main window?

When a proxy is configured in your network you may encounter the following error in the CardioLog UI:

To resolve this issue, insert the following code into the [CardioLog Installation Folder]\CardioLog\web.config file:

<system.net> 
      <defaultProxy useDefaultCredentials="true" /> 
</system.net>

Why do I get the error "'Error in '_layouts/CardioLogAgent' Application: That assembly does not allow partially trusted callers" when troubleshooting malfunctioning tracking?

You may notice that once you have completed the installation of CardioLog and/or updated to the latest minor version, that tracking has stopped functioning correctly and you may have received the error while using Browser Dev Tools. When downloading any minor updates, make sure to right click on the .zip file and select Properties > Click Unblock. In some environments with strict security settings, any compressed files that contain .dll files will be blocked automatically.

The two methods to resolve this are:

1. Go to the original downloaded .zip files and unblock the file as described above. Then copy the contents of the unzipped folder, which should be identical to your current version, to the CardioLog installation folder. If you are using our Feature WSP through SharePoint Central Admin, also copy the contents of the CardioLogAgent Folder found in the .zip file to the CardioLog Agent File on all your WFEs within the layouts folder.
2. Go to each individual API.dll and unblock it. This is time consuming and not advised.

Clear your Browser Cookies and Cache and test to see if tracking is now functional.

Sometimes an IIS Reset is also required on the WFE and CardioLog Application Server to restart the tracking action. 

Why do I receive error 401.1 when I browse to a web site that uses Integrated Authentication?

The source of this error is usually LoopBack, a JavaScript framework, which typically uses the address 127.0.0.1 for tests. LoopBack can keep transferred information internal and block some communication between networks, which causes the 401.1 Error to appear.

There are two methods to resolve this issue. Either specify a host name, which is preferred if NTLM Authentication is required, or simply disable LoopBack Check, which we don't recommend unless completely necessary.

Method 1: Specify host names (This is the preferred method if you would like to use NTLM authentication)

To specify host names that are mapped to the LoopBack address and can connect to Web sites on your computer, follow these steps:

1. Set the DisableStrictNameChecking registry entry to a decimal value of 1. For more information, see the Microsoft Knowledge Base article. This is typically for Windows Server 2003, which we no longer support.
2. Click Start, click Run, type regedit, and then click OK.
3. In Registry Editor, locate and then click the following registry key:
   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\MSV1_0
4. Right-click MSV1_0, point to New, and then click Multi-String Value.
5. Type BackConnectionHostNames, and then press ENTER.
6. Right-click BackConnectionHostNames, and then click Modify.
7. In the Value data box, type the host name or the host names for the sites that are on the local computer, and then click OK.
8. Quit Registry Editor, and then restart the IISAdmin service.

Method 2: Disable the LoopBack check

The second method is to disable the LoopB ack check by setting the DisableLoopbackCheck registry key.

To set the DisableLoopbackCheck registry key, follow these steps:

1. Set the DisableStrictNameChecking registry entry to a decimal value of 1.  For more information, see the Microsoft Knowledge Base article. This is typically for Windows Server 2003, which we no longer support.
2. Click Start, click Run, type regedit, and then click OK.
3. In Registry Editor, locate and then click the following registry key:
   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa
4. Right-click Lsa, point to New, and then click DWORD Value.
5. Type DisableLoopbackCheck, and then press ENTER.
6. Right-click DisableLoopbackCheck, and then click Modify.
7. In the Value data box, type 1, and then click OK.
8. Quit Registry Editor, and then restart your computer.

My SharePoint portal runs on SSL. Why do I get an authentication login box for the CardioLog server after installing the CardioLog tracking agent?

How can I import user data from Extradium into CardioLog Analytics?

Riolinx provides an API that allows you to export Extradium user database to other systems.

A CSV export tool provided along with the source code is available from Riolinx. You will be prompted to sign in in order to access the download.

In order to import Extradium users into CardioLog Analytics, and filter reports by specific users or by specific profile properties, you can develop a web service that generates a relevant XML response. For more information, see Configuring Visitor Segmentation for Authenticated Users.

What is the impact of the CardioLog JavaScript tracking code on the SharePoint page response time?

Can I change the URL for the CardioLog web applications and services in order to include a fully qualified domain name (FQDN) or a different port number?

You can update the domain, machine name or port number for the various CardioLog web applications and services by following these steps:

1. Replace all instances of http[s]://CardioLog-machine-name:port with http[s]://CardioLog-machine-name:new-port or with http[s]://fqdn in the following files located in the CardioLog installation folder (the default path is C:\Program Files\Intlock\CardioLog): 
   
   [CardioLog Installation Folder]\CardioLogScheduleServices\Settings.config
   [CardioLog Installation Folder]\CardioLogMonitoringServices\CardioLog.System.Monitoring.Services.exe.config
   [CardioLog Installation Folder]\CardioLog\web.config
   [CardioLog Installation Folder]\CardioLogAPI\web.config
   [CardioLog Installation Folder]\CardioLogAgent\web.config
   
   Note: If you have implemented the "CardioLog Analytics" SharePoint Feature on your WFEs edit the CardioLogAgent\web.config file located on the SharePoint WFEs:
   
   For MOSS 2007 only:
   C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\LAYOUTS\CardioLogAgent/web.config
   
   For SharePoint 2010, 2013, 2016 only:
   C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\LAYOUTS\CardioLogAgent/web.config
   
   
   Otherwise, edit the http[s]://machine-name:port in the CardioLog Java Script tracking code embedded within a common Java Script file, which is located on your SharePoint WFEs. The code is located at the end of the file, between the comments: "//Intlock tracking code start" and "//Intlock tracking code end".
   
   For MOSS 2007 only:
   C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\LAYOUTS\1033\core.js
   
   For SharePoint 2010 only:
   C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\LAYOUTS\1033\init.js
   
   For SharePoint 2013 only:
   C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\LAYOUTS\init.js
   
   For SharePoint 2016 only:
   C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\TEMPLATE\LAYOUTS\init.js
   
   
   
2. In the CardioLog database, edit the URL column in the tab_management table by executing the following SQL script:
   
   Use CardioLog
   GO
   
   update tab_management set url = replace (url, '[Old URL]', '[New URL]')
   
   [Old URL] - http[s]://CardioLog-machine-name:port
   [New URL] - http[s]://CardioLog-machine-name:new-port or http[s]://fqdn
   
   Note: If you are using Active-Passive architecture, the URL should be valid for both servers.

1. Execute the following script against the CardioLog database. Edit 'NewPath' (with a backslash '\' after the folder location. i.e. 'E:\Logs\'):
   

   update tab_global_settings
   set Value='NewPath'
   where Name = 'LogFilesPath'

    

2. Edit the 'NewPath' in the following configuration files:

   [CardioLog Installation Folder]\ADTree\web.config

   <add key="logFilePath" value="NewPath\ADXmlTree.log" />

   [CardioLog Installation Folder]\CardioLogAgent\web.config

   <add key="logFilePath" value="NewPath\CardioLogUI.log" />

   [CardioLog Installation Folder]\EventCollector\web.config

   <add key="logFilePath" value="NewPath\EventCollector.log" />

   [CardioLog Installation Folder]\SP2007Tree\web.config

   <add key="logFilePath" value="NewPath\SP2007Tree.log" />

   [CardioLog Installation Folder]\SP2010Tree\web.config

   <add key="logFilePath" value="NewPath\SP2010Tree.log" />

   [CardioLog Installation Folder]\SP2013Tree

   <add key="logFilePath" value="NewPath\SP2013Tree.log" />

   [CardioLog Installation Folder]\SPTree

   <add key="logFilePath" value="NewPath\SPTree.log" />

   [CardioLog Installation Folder]\VisitorSegments

   <add key="logFilePath" value="NewPath\SPTree.log" />

   [CardioLog Installation Folder]\WebsiteTree

   <add key="logFilePath" value="NewPath\WebsiteTree.log" />

   
   

3. Perform an IISReset on the CardioLog server.

Does CardioLog Lite work on a SharePoint farm with multiple front ends?

Why do I get an authentication login box for the CardioLog server when I browse my SharePoint portal even though I have added the tracking code to core.js/init.js?

There are two ways to remove the authentication prompt:

1. Remove the tracking code from core.js/init.js and install the "CardioLog Analytics" SharePoint feature. 
2. Install the CardioLog Tracking Agent web application under the SharePoint web site manually by following these steps:
   1. Copy the [CardioLog Installation Folder]\CardioLogAgent folder to the "_layouts" folder on your SharePoint machine.
   2. Open IIS Manager on your SharePoint machine, create a new virtual directory named CardioLogAgent under the SharePoint website "_layouts" folder, which directs to the newly copied CardioLogAgent folder.
   3. Set the following properties for the new virtual directory: ASP.NET 2.0, Integrated Windows Authentication. Verify that you can browse to  http://sharepointportal//_layouts/CardioLogAgent/AgentEmbed.aspx
   4. Open the copied CardioLogAgent directory, open the web.config file and change the CardioLogAgentRoot location:
      <add key="CardioLogAgentRoot" value="/_layouts"/> 
   5. Open the SharePoint core.js (for SharePoint 2007) or init.js (for SharePoint 2010/2013/2016) file and edit the CardioLogAgent location in the code as follows: (The code is located at the end of the file, between the comments: "//Intlock tracking code start" and "//Intlock tracking code end")
      ca.src = 'http://sharepointportal//_layouts/CardioLogAgent/ca.aspx?_random='+Math.random();
      script.src = "http://sharepointportal//_layouts/CardioLogAgent/AgentEmbed.aspx?env=SharePoint2010&r="+Math.random()*100000;
   6. Delete your browser cache and verify that when you browse to the portal you can see the CardioLog tracking agent popup by pressing Ctrl+F12 on your keyboard, or by clicking the Agent Console link.

How do I fix the CardioLog Tracking Agent solution when it appears stuck on "deploying" in SharePoint?