Ektron
Ektron's Diagnostics Utility provides comprehensive information about you network's servers that are related to the website to which you are logged on. (An Ektron network consists of your Ektron server, connected database servers, and other servers with which your website has an Synchronizing Servers Using eSync or Load Balance relationship.)
The utility gives you and Ektron's support staff a real-time snapshot of all servers in the network, and includes the following for each node.
NOTE: Most Diagnostics fields are read-only. The utility lets you perform only a few actions.
The following video provides additional information about the Diagnostics Utility: The Making of Ektron eSync Diagnostics
This section explains what you need to know about the Diagnostics Utility: how to install it, the information it provides, and how to "capture" its current state. You can save the captured files for comparison with previous and future versions, and send them to Ektron's support staff for diagnosis.
An opportunity to install the Diagnostics Utility appears during the installation or upgrade of Ektron(see Diagnostic Utility checkbox).
If Diagnostic Utility is not checked during installation, you can install it by going to Windows Start button > All Programs > Ektron > CMS400vxx > Utilities > Ektron Diagnostic Utility.
Install the utility to every website and server in your Ektron network. This includes Ektron Web servers, as well as servers used in Load Balance and eSync configurations.
You do not need to install the utility on client workstations.
The Diagnostics Utility installs the following files on each server.
web.config
file additionsNOTE: If the Diagnostics Utility is not installed on a server, a node for that server appears, but information about it is not available in the lower section of the screen, and additional relationships are not visible.
For example, you have an eSync relationship between development and staging servers, and between staging and production servers. If the Diagnostics Utility is installed on the development server but not on staging, and you view the network from the development Workarea, you see nodes for development and staging, but not production. You can view details for development, but not staging.
Prerequisites
- You are a member of the Ektron Administrator's group
- The Diagnostics Utility was installed on every server with which your website has an eSync or Load Balance relationship
- The Diagnostics Utility requires Silverlight 4. If a client does not have it, you are prompted to install it before you can view the screen.
Access the Diagnostics Utility from the Workarea, by going to Settings > Configuration > Diagnostics.
The Diagnostics screen consists Ektron network nodes connected by lines that indicate relationships. Use the slider on the right side to adjust the zoom level.
You may drag the nodes around for easier viewing.
This section also contains the following topics, which explain the information on the Diagnostics screen.
A connecting line's color indicates the type of relationship that exists between nodes.
The arrowhead direction indicates the direction of the profiles. For example:
Appears even if the database resides on the same server with Ektron.
This section describes icons that may appear within a network node.
You can run a bandwidth test between any 2 network nodes. The test checks the speed of the selected server's connections. To accomplish this, the test sends a 32 MB file in both directions then reports the transfer time.
As an example of when you would conduct a bandwidth test, assume it takes a long time to sync a production server with a staging server. Use a bandwidth test to diagnose the problem.
The lower section of the Diagnostics Utility screen provides a wealth of information about your Ektron network.
The tabs across the top indicate main areas of interest.
IMPORTANT: The Diagnostics screen runs as a Windows Service. So, that service must have administrator access to perform the tests and retrieve the necessary information.
The basic diagnostics screen has several subtabs:
See Also: Securing Ektron
See Also: Checking Document Management Permissions
See Also: Using Active Directory with Ektron, Using LDAP with Ektron
The Server Details tab provides information about the selected server.
The tab displays the following information.
Use this tab to view the site's encoded eSync certificate, copied from the web.config
file.
The tab also displays all remote certificates for this server. Checks in the lower section indicate the presence of certificate files on all servers. See Also: Managing eSync Security Certificates
NOTE: The tab does not indicate if the certificates on the servers in the sync relationship match.
The Sync Scope tab retrieves details from the serverinfo.xml file. The tab also shows information about saved eSync profiles. See Also: Setting up eSync Profiles
The bottom section of the Sync Scope tab shows information for the eSync Logs. See Also: Viewing eSync Activity
The Site Details tab shows Files over 100 MB in the site and the Knowledge and Metadata Files Screen.
The Service Status tab provides information about EWSEktron Windows Service. It also lets you stop and start the service. See Also: Ektron Windows Service
This screen tells you
The Assets tab display a recursive list of assetan external file, such as a Microsoft Word document or image, stored in Ektron. It can be managed like native Ektron content.s under each folder.
You can easily "capture" the current Diagnostic information. The captured files can be saved for comparison with previous and future versions, and sent to Ektron's Support staff for diagnosis.
The export file collects all information described in Details in the Lower Section of the Diagnostics Utility from each server. The file also includes a copy all configuration files and logs for all servers in your website's network. This information is packed into a .zip file for easy storage and transfer.
To capture Diagnostics information, click Export Map.
Inside the .zip file are
NetworkMap.ekd
file. This file may be loaded in the Diagnostic utiilty, in the Silverlight viewer, or in a text editor, such as Notepad (the saved data is XML.) See Also: View an Exported MapThe values of all files are those that existed when you clicked the Export Map button.
Prerequisite
The location of the exported map file on your computer. The file's name is DiagExportdate-time.zip.
DiagExportdate-time.zip
file.NOTE: You can also use the
C:\Program Files\Ektron\EktronDiagnosticsService\Tools\EktronDiagnosticsWPF.exe to view a networkmap.ekd file.