The following is a list of issues known to exist at the time of this release.
Feature | Known Issue | Defect ID |
---|---|---|
General | Spotlight data not displayed when overhead settings are restored to default values: In some cases, restoring Overhead Management settings on a Spotlight component may prevent the display of Spotlight data in one or more drilldown pages. To view the data, disconnect the original Spotlight connection and then reconnect. | |
Queued Spotlight queries will complete despite changes to Overhead Management settings: When you use Spotlight's Overhead control to reduce or halt the collection of data from a connection, any existing queries that have been queued for execution will complete as if started under the previous overhead setting. | ||
Installation issues |
Brackets not permitted in installation path names: Prior to Oracle 11g, the Oracle client does not support an installation path for Spotlight that contains the brackets "(" and ")". For example: C:\Program Files (x86)\... Tip: For 64-bit operating systems we recommend not installing Spotlight on Oracle (Windows 32) in "c:\Program Files" since Windows re-directs this back to "C:\Program Files (x86)". |
|
Installing for multi-user access. If Spotlight is installed for use by multiple users of a system, the additional users must be local administrators. | ||
Upgrade issues |
When upgrading to Spotlight on Oracle 10.3.2 history data will be reset. If you would like to keep history between upgrades then you can change the folder spotlight stores history to, through Spotlight Options | storage->History Location. |
Feature | Known Issue | Defect ID |
---|---|---|
Connections | After connecting once with an Oracle 11g or Oracle 12c client, if you change the Oracle home to use a different client, the next time you connect you may see the error Entry Point Not Found… | 2226 |
From a Spotlight on Oracle connection where the Oracle database is installed on a Windows operating system, from drilldown Operating System | OS Processes right click on an Oracle process and select Top Sessions to open the Top Sessions drilldown - results in error: Unable to file Oracle session for this process. |
2197 | |
Limitations with automatic reconnection to Oracle systems:
|
||
Spotlight on Oracle connections: Spotlight on Oracle RAC automatically creates Spotlight on Oracle connections for each instance in the cluster. If, for example, you name your Oracle RAC connection "My cluster", and it has two instances with instance names of "CL1" and "CL2", then two Spotlight on Oracle connections named "My cluster CL1" and "My cluster CL2" will be created automatically when you first connect Spotlight to the cluster. If you already have Spotlight on Oracle connections with those names, the connection details will be overwritten by Spotlight on Oracle RAC. If you subsequently delete the Oracle RAC "My cluster" connection, you will need to delete the associated Spotlight on Oracle connections manually. | ||
Avoid simultaneous REXEC and SSH connections: Spotlight supports both REXEC and SSH connections to Oracle servers, but raises an error when you try to open simultaneous REXEC and SSH connections to the same Oracle server. | ||
Home Page / Drilldowns | Changing column order may disable sub-pages in SQL Analyze Trace drilldown page: Changing the order in which columns are displayed in the Trace File Details grid of the Trace Files page may disable the Summary, SQL Statements, and SQL Statement Details tabs, limiting your access to the other pages within SQL Analyze Trace. To counter this problem, right-click the Trace File Details grid and choose Restore Default Settings from the shortcut menu. | |
The Spotlight on Oracle Data Guard Standby icon is disabled for a connection to an instance that is part of an Oracle RAC cluster. This is by design. The metrics would not be accurate if the primary connection was not Oracle RAC. If the primary connection was to an Oracle database then the metrics would not be for the whole cluster. | ||
Negative value for Shared Pool Used component: The Shared Pool Used component on the Spotlight on Oracle home page may display a negative value when Oracle is first started or when the shared pool is flushed out. This occurs when the value for "shared pool free memory" in v$sgastat is larger than the original shared pool size (Oracle bug 3288917). | ||
Inaccurate value for Total RAM after network timeout error: After a network timeout error, Spotlight may display an inaccurate value for the Total RAM metric on the Spotlight on Oracle RAC home page. When this occurs, Spotlight's calculation of Total RAM has omitted data from one or more nodes in the cluster. | ||
Operating system Drilldown: (OS) statistics not reported by Spotlight on Oracle: Differences between versions of operating systems mean that Spotlight is unable to collect all OS statistics in all environments. The following list shows statistics in the Operating System drilldown pages that are not reported by Spotlight on Oracle for each operating system.
|
||
Installing and configuring DTrace scripts (Solaris 10 and later): DTrace, a dynamic analysis tool for Sun operating systems, was first introduced in Solaris version 10. You can enable and use Spotlight's DTrace drilldown to capture details about the interaction between Oracle and Solaris that would otherwise be unavailable.
Before doing this, you must configure the Solaris server under investigation. To do so:
For more information, see the DTrace User Guide. |
||
Predictive Diagnostics | Predictive Diagnostics is disabled for Read Only connections. Read Only databases cannot run (Predictive Diagnostics) jobs therefore no data will be gathered. | ST11604 |
Oracle configuration | OCI error displayed when the Oracle client setting is changed in a connection profile: In some circumstances, changing the Oracle client setting within a profile can cause problems with loading the correct OCI.DLL. To resolve this issue, set the Oracle client global option to the desired client. | |
Restarting Spotlight to change selected Oracle Home: Normally, you can change the Oracle Home setting for Spotlight on Oracle whenever the selected home is NOT being used for an active Spotlight connection. In certain circumstances, however, disconnecting from a database causes the termination of one or more executing queries. When this happens, you can select a new Oracle Home in a connection profile (or in the Spotlight on Oracle Options window) ONLY AFTER Spotlight itself has been restarted. |
||
Unable to create or open a Spotlight connection because of missing PATH entry for Oracle client:
|
||
Error when connecting to Oracle 10g database on LDAP server: Spotlight may encounter access violation errors when attempting to connect to an Oracle 10g database on an LDAP 9.2.0.1 server via an Oracle 11g client. To resolve this problem, we recommend using an Oracle 10g client to connect to the 10g database. | ||
Oracle error ORA-1031 when connecting to an Oracle database: To resolve the error ORA-1031: insufficient privileges in table Parameter when you try to connect to an Oracle database, add the following entry into the SQLNET.ORA file on the Spotlight client machine:
Note: This error is seen most often for the Parameter table, but can also occur for others. |
||
Read access required to analyze Oracle trace files: Before you can use Spotlight's SQL Analyze Trace facility to analyze trace files from a target Oracle database, the Spotlight OS User must have read access to the directory on the server specified by the Oracle parameter UserDumpDest. | ||
Open_cursors parameter: The open_cursors parameter for the database instance needs to be greater than 70 to allow Spotlight to diagnose the database instance correctly. | ||
Oracle error ORA-12154 when connecting to Predictive Diagnostics with Oracle Names Server: The known Oracle bug #2048583 may cause an ORA-12154 error to be raised when you navigate to the Predictive Diagnostics drilldown, preventing the display of the drilldown. A possible workaround is to upgrade your Oracle client. | ||
Oracle archiving | Close and re-open Spotlight connections to detect new archive destinations: When you add a new archive destination to a monitored Oracle database, it may not be detected by Spotlight. Disconnect from the database and then reconnect to view the details of the new archive destination. | |
Unreliable historical data for archive destinations: When viewed in History mode, the Spotlight connection may on occasion display incorrect data for archive log destinations. | ||
Information shown for a single node only in Alert Log and Archive Log diagnostics: In a clustered environment where the global_names parameter is set to TRUE, alert log and archive log diagnostics within Spotlight on Oracle RAC will display data for one node only. To work around this, add the entry
to the SPOTLIGHT.ORA file in the Plug-ins\SoO sub-folder of the Spotlight installation folder. This will change the global_names parameter for the relevant Spotlight session. |
||
Limited support for Archive Destinations on mapped network drives (Windows): Spotlight does not as yet calculate or display Time to Failure estimates for Oracle RAC systems on Windows platforms whose archive destinations are not local drives. | ||
Oracle 12c |
In an Oracle 12c Data Guard environment, in some circumstances the Transport Process Running alarm fails to fire when log shipping is stopped. Spotlight on Oracle expects the Oracle process to stop when log shipping is stopped, but in some circumstances the Oracle process continues to run (idle). |
SoO-1759 |
Plugged database sessions sometimes don't show in the Top sessions drilldown. To fix the issue, run alter system flush shared_pool |
SoO-1374 | |
When the Spotlight connection is to the container database, the Container drop down menu may not populate with all the plugged in databases. This applies to the Activity | Summary and Pluggable Databases | Resource Usage drilldowns. To fix the issue, run alter system flush shared_pool On Oracle RAC, run alter system flush shared_pool on every node of the RAC. |
SoO 1426 | |
When the Spotlight connection is to the container database:
When the Spotlight connection is to the plugged in database:
The problem is v$iostat_file is empty on the pluggable database. |
SoO-1376 SoO-1417 | |
When the Spotlight connection is to the container database:
When the Spotlight connection is to the plugged in database:
The problem is with Oracle counters not always incrementing correctly for plugged in databases. |
SoO-1377 SoO-1410 | |
Oracle Exadata |
After heavy use of the cellcli utility, CPU utilization on the cell host may hit 100% and stay there. The runaway processes appear to be java and cellsrv. To fix, identify the cell host on the Exadata | Cell Balance drilldown then enter the following Unix command on the appropriate cell host:
|
|
Windows Firewall has blocked some features of this program: You may see this Windows Security Alert while Spotlight is running.
|
PT32653067 | |
Oracle 11g | Spotlight support for Oracle 10g or 11g Instant Client: Spotlight on Oracle supports the use of the Oracle 10g or Oracle 11g Instant Client when it is the default Oracle client, but the Oracle Instant Client may not be available in the list of Oracle clients shown in the Spotlight connection profile or in the Oracle home item in the Spotlight on Oracle Options window. | |
Bad data in Latch Misses chart: The Latch Misses chart in the Activity Latches drilldown can show bad data for Oracle 11gR2 under category "Other". This is due to intermittent bad data being returned from Oracle for latch "JS slv state obj latch". Bug 9534870 has been raised with Oracle. Using the Filter button to remove the "Other" category from the chart is a possible workaround for this issue. | ||
Oracle 10g | Asynchronous I/O failure in Oracle 10g (Release 2) on Linux: In some Linux implementations, Oracle 10G (Release 2) is not able to report I/O activity or events to the operating system while using asynchronous I/O. This problem can cause database writer contention in Oracle and cause Spotlight to raise database writer alarms. To correct the problem, you need to stop the database and relink the base Oracle binary with the option async_on. [For more information, see Document 365416.1 on the Oracle Metalink Web site (https://metalink.oracle.com/).] | |
Oracle 10g bug may affect display of SGA data: A bug introduced in Oracle 10g may result in several Spotlight components – in particular, the SGA Current Size component on the home page, and various components on the SGA Utilization page of the Configuration & Memory drilldown – to display the message "Unknown – Oracle Bug". The bug responsible for causing this error has been fixed in Oracle release 10.2.0.3. |
Feature | Known Issue | Defect ID |
---|---|---|
Connections |
REXEC and SSH protocols and Unix commands: Spotlight uses the REXEC or SSH protocols to submit various Unix commands (for example, netstat, vmstat, iostat, sar) to observe system activity. These commands must be accessible to an REXEC or SSH session for Spotlight to be able to observe Unix activity. If these commands are not located in the search path for REXEC or SSH sessions, Spotlight displays an error. |
|
'iostat' command may not be installed. Spotlight on Unix works with full functionality only when the iostat command is installed on the server under diagnosis. This may NOT be true for all Unix systems. If iostat is NOT installed, Spotlight may display an error message such as 'iostat: command not found'. If you encounter this error, you can: Install the iostat command on the server. (On Red Hat Linux, this command is included in the sysstat package.) |
||
Logging on as "root". When connecting to a Unix OS, you need to do so from a logon other than "root". Remote login as "root" has been disallowed for security reasons. |
||
Public-key cryptography available for SSH2 connections only: Spotlight can now use public-key cryptography (via DSA or RSA) to communicate securely with Unix systems, but this functionality is made available only under the SSH2 protocol. |
||
Password authentication for SSH connections that do NOT use public-key cryptography. To allow Spotlight to make SSH connections to any Unix or Linux hosts that permit SSH connections, you may need to alter the PasswordAuthentication configuration item in the sshd_config file. Set the value of PasswordAuthentication to yes. |
||
Password Authentication when using SSH to connect to Linux servers: To allow Spotlight to make SSH connections to Linux machines via username/password authentication, you may need to set the value of the PasswordAuthentication configuration item in /etc/ssh/sshd_config to yes. | ||
AIX Limitations |
Specific implementations of AIX may limit Spotlight's ability to collect data. These include:
|
|
HP-UX Limitations |
Specific implementations of HP-UX may limit Spotlight's ability to collect data. These include:
|
|
Linux Limitations |
Specific implementations of Linux may limit Spotlight's ability to collect data. These include:
|
|
Solaris Limitations |
Unix OS commands. Unix OS commands need version 5.6 of perl or later. If this is not available you should revert to using a shell script to obtain operating system data for this server. To do this, edit the file ScriptConfig.ini (in the ..\Plug-ins\DatasourceUNIX sub-folder of the Spotlight installation folder) according to the instructions supplied in the file. |
|
Problems with diagnosing Solaris 9 machines. A number of Spotlight home page components will not be populated when Spotlight diagnoses lightly-loaded Solaris 9 machines. This is caused by the output from the vmstat command regularly recording a "State Change" event, which in turn resets values for the vmstat command. In this case, the CPU spinner, User % gauge, System % gauge, Queue Length gauge, Free RAM label, Blocked Processes button, Swapped Processes button, Paging In and Paging Out flows, and Swapping In and Swapping Out flows will appear grayed out. |
||
Other Solaris Limitations:
|
Feature | Known Issue | Defect ID |
---|---|---|
Drilldowns |
Error Access denied on the Spotlight on Windows Home Page Open Sessions panel and the current user is in the Administrators group on both the local and the remote machine. To fix this issue: Enable the AllowRemoteRPC property in the registry of the monitored system. [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server] " AllowRemoteRPC"=dword:00000001 or import the registry file AllowRemoteRPC.reg |
PT43095851 |
Processes drilldown. For some versions of Microsoft Windows, the Peak Mem Usage (MB) column in the Processes grid displays bytes or kilobytes rather than megabytes. | ||
Windows 7 error. When diagnosing a Windows 7 machine, the Network / TCPIP drilldown can show errors with the text "Error 80041010: Invalid class". This is due to problems within WMI (Windows Management Interface). | ||
Windows 7 hidden partition. Windows 7 is typically installed with a 200 MB hidden partition which contains the Windows Recovery Environment (WinRE). This partition is not shown on the Spotlight on Windows home page, but data for it will be displayed on the Logical Disk Activity drilldown. | ||
Missing event log message text. Redesigned resource information structures within Windows may prevent Spotlight from reading the content of event log messages on Windows Server 2008 systems. | ||
Missing Open Ports page. Spotlight cannot currently display the Open Ports page in the Network drilldown for Windows Server 2008 systems. | ||
Excessive event log activity. If you are connecting to a machine that has an event log that is being updated excessively (more than two items being logged per minute), it is recommended that you turn off the event log feature for that system. This is because Spotlight on Windows maintains details of all event log items, which may cause the program to use an excessive level of memory. | ||
Incorrect or missing NBT information. When connecting to a local machine, sometimes Windows will not return the correct NBT information. This may cause the NBT flows on the main window to be dimmed. It may also cause the information in the NBT drilldown to be blank. | ||
Errors in performance counters and WMI: Spotlight on Oracle now reports fewer performance counter and WMI errors of the type "Error 80041010: Unknown IWbemLocator.ConnectServer error". It is impossible to eliminate these errors entirely if they are generated by the Windows server under diagnosis. | ||
Event log size. There is a 64 KB limitation to the size of event log records. | ||
Connections | Service Manager is not accessible error on connecting to a Windows 8 or Windows 2008 server image.
Resolution: Ensure the user on the Spotlight Client has administrator privileges on the windows server you want to monitor. |
SOO-34 ST14620 |
Limit to simultaneous connections. It is recommended that no more than 10 simultaneous connections be executed from the same instance of Spotlight on Windows. Depending on the available system resources, the level of response will deteriorate if this number is exceeded. The number of connections possible may also be affected by option settings; for example, setting event log options to access thousands of event log items will degrade Spotlight performance and consume more memory. | ||
Remote Registry service. The Spotlight machine and the machine being diagnosed must have the Remote Registry service running. If you attempt to connect to a machine that has the Remote Registry service stopped, Spotlight will return the following error message: No Windows server called <machine name> could be found on the network. If the address is valid then the Remote Registry service may not be running on the remote server. Make sure the Remote Registry service is running on the Spotlight machine and the machine you are connecting to. |
||
Connecting to a machine running PC Anywhere. If a machine has PC Anywhere loaded and is using the PC Anywhere Performance Monitor extensions (from pcaperfctrs.dll), Spotlight may show "query failed" messages on that connection. To work around this issue, unload the PC Anywhere Performance Monitor extensions from the machine.. |
Before installing Spotlight, ensure your system meets the following minimum hardware and software requirements:
Requirement | Description |
---|---|
Platform |
A Pentium-based or equivalent PC with:
|
Memory |
512 megabytes of RAM (minimum). 1 gigabyte recommended. Memory consumption will increase for multiple simultaneous connections and as the number of instances in an Oracle RAC cluster increases, and will also depend on the connection options chosen. |
Hard Disk Space | 1 gigabyte of free disk space. This should exist on a local disk drive rather than a network drive. Extra disk space will be required if you choose to log historical snapshots from within Spotlight. |
Operating System |
Microsoft Windows Server 2019 64-bit and above Microsoft Windows Server 2016 64-bit and above Microsoft Windows Server 2012 64-bit R2 and above Microsoft Windows Server 2012 64-bit Microsoft Windows Server 2008 64-bit R2 and above Microsoft Windows 10 32-bit and 64-bit Microsoft Windows 8 32-bit and 64-bit Microsoft Windows 7 32-bit and 64-bit |
Additional Software (Monitor Oracle Database Servers) |
|
Requirement | Description |
---|---|
Oracle |
The following Oracle database servers are supported for database queries. (You must have the Database Administrator [DBA] user ID and password for the database you want to diagnose.)
Notes:
|
Oracle RAC |
Spotlight supports up to 16 instances in a cluster, with a theoretical limit of 36 instances. |
Oracle Exadata Storage Servers (Cells) |
Spotlight monitors Exadata Storage Server (Cells) hosted on the following Operating System: Linux Kernel V2.6. Ensure CellCLI is in the PATH of the Operating System account on the Exadata Storage Server (Cell) hosts. This is required for Spotlight to collect performance information. |
Cloud Database Services |
Oracle Database as a Service. Oracle databases running on Amazon EC2. |
Requirement | Description |
---|---|
Unix Servers |
Unix servers and versions. Spotlight supports the following server operating systems for O/S Server queries:
|
Unix Server Software |
Unix programs. The following Unix programs must be accessible to the user logged on to the Unix machine.
For HP-UX, additionally
For AIX, additionally
For Solaris, additionally
|
Unix User Permissions and Installation Settings |
|
Requirement | Description |
---|---|
Operating Systems |
Microsoft Windows Server 2019 64-bit and above Microsoft Windows Server 2016 64-bit and above Microsoft Windows Server 2012 64-bit R2 and above Microsoft Windows Server 2012 64-bit Microsoft Windows Server 2008 64-bit R2 and above Microsoft Windows 10 32-bit and 64-bit Microsoft Windows 8 32-bit and 64-bit Microsoft Windows 7 32-bit and 64-bit |
Administrator access |
Ensure your login to the Windows machine has Administrator access privileges. To add a new connection to the Windows machine you are currently using, ensure you are logged in to the machine with Administrator access privileges. If necessary, logout and login again. |
Privileges | Spotlight retrieves its data from Windows performance counters and the windows registry of the monitored system. An administrator login to the Windows machine has such access. |
Remote connectivity | To add a new connection to a Windows machine other than the one you are currently using, ensure the machine is accessible to the Spotlight client. Spotlight uses NetBIOS traffic to retrieve perfmon and registry information, so any firewalls between the Spotlight client and the machine being monitored must allow this traffic to pass through. |
Review the following information about using Spotlight in virtual environments:
Requirement | Description |
---|---|
Application |
Spotlight has been tested on Citrix XenApp 6.5. |
Desktop (VDI) |
Spotlight has been tested on desktop VMware workstations. |
Server |
Spotlight has been tested on VMware ESX server. Spotlight supports Oracle Virtualization (OVM). Limited testing has been done using Oracle VM 3.0. |
Note:Spotlight may work in virtualization environments other than the ones in which it was tested. |
From time to time, Quest Software may make upgrades and patches available on the Internet. Upgrades will be made available from http://software.quest.com/. Instructions for downloading and installing upgrades are provided on the web site.
Notes:
msiexec.exe /i Spotlight.msi UPGRADE_EXISTING_PRODUCT=0
Spotlight is supplied with a time-limited trial key so you may test the product. When the trial key expires Spotlight reverts to a preview mode, which limits access to the Spotlight home page and one connection at a time. If you select to open a drilldown in preview mode the following message is displayed:
The current license does not allow access to this functionality.
When you enter a valid license key and authorization message in the License Viewer, you are licensed to use Spotlight on Oracle.
To activate a purchased commercial license
Make sure you enter the authorization key exactly. The site message is case sensitive.
The Windows user that updates the authorization key must have administrator access to the Windows registry and write access to the Console\Licenses folder in the Spotlight installation folder.
The Spotlight on Oracle release package contains the following products:
Refer to the Spotlight on Oracle Getting Started Guide for installation instructions.
Note: When upgrading to Spotlight on Oracle 10.3.2 history data will be reset. If you would like to keep history between upgrades then you can change the folder spotlight stores history to, through Spotlight Options | storage->History Location.
© 2024 Quest Software Inc. ALL RIGHTS RESERVED. Nutzungsbedingungen Datenschutz Cookie Preference Center