Capacity Reporter 6.0.1 Release Notes


Part No. 816-4731-11

This document provides late-breaking information not included in the documentation for the Capacity Reporter 6.0.1 (Capacity Reporter) software. See the documentation provided with Capacity Reporter for additional installation and use information.

Contents

*** Special Global Reporter Update ***

Installation and Configuration Issues

Known Issues

*** Special Global Reporter Update ***


Patch for Quota Used Percentage Errors
If you receive error #80040e57 or #2147749463 while running the Global Reporter software, download and install Patch ID#[TBD] from www.sunsolve.sun.com.

Back to Contents

Installation and Configuration Issues


The following are known installation and configuration issues relating to this release of Capacity Reporter:

Windows NT file MSINET.OCX may be required for installation of NAS or NetWare devices
The Windows NT file MSINET.OCX is provided on the product CD at \capacity\i386\MSINET.OCX. If you receive an error message informing you this file is missing, copy it from the product CD.

Additional Capacity Reporter Software Prerequisites

Prerequisite Check Does Not Fail on Incorrect Windows NT Service Packs
The prerequisite check fails to display an error message when it encounters a Windows NT Service Pack lower than SP5, which is the required Service Pack for an installation of Capacity Reporter software.

Do not Change the Web Destination Location When Installing Capacity Reporter
During installation, the installation procedure prompts the user for the SRM Web destination location. For the installation to work properly, do not change the destination location after clicking Next on the Choose Destination Location dialog box. Otherwise, the installation starts prematurely.

Capacity Reporter Database and SQL Maintenance
Upgrade to SQL 7.0 SP2 for SQL maintenance tasks to work properly. If you do not want to upgrade, use SQL Enterprise Manager to remove the CkCat qualifier from the SQLMAINT command. Contact Customer Support for more information on editing the SQL maintenance task.

Ksh (Korn Shell) is Required When Installing a Capacity Reporter Agent on a Linux Machine
As a prerequisite, a Linux machine must have ksh installed on it before a successful Capacity Reporter Agent installation on that machine can occur. The latest pdksh rpm can be downloaded from the Red Hat web site.

Solaris Agent Upgrade Causes Disks to be Rediscovered
If you upgrade from a version 5.0.5 (or earlier) Solaris agent to the version 6.0 Solaris agent, subsequent scans "rediscover" existing disk drives. The original disk drives are reported as missing and will eventually be removed during system clean up.

Solaris Agent Upgrade Installation Directory
When you upgrade a Solaris agent from version 6.0.0 to version 6.0.1, the installation directory remains 6.0.0.

Installing the Capacity Reporter Agent for Solaris multiple times leaves port numbers reserved
Each time you install the Agent for Solaris you will be asked to supply a new, unused service name and port number for the Agent to listen on.  This information is used to generate entries in the /etc/services and /etc/inetd.conf files.  When the Agent is removed, these entries are deleted.  Reinstalling the Agent without removing the prior instance will result in multiple entries being left in the /etc/services and /etc/inetd.conf file, effectively reserving multiple ports for use by the Agent.  Only the entries from the last installation will be removed from these files when the Agent is uninstalled, so you will have to remove any additional entries manually.  This can be avoided by uninstalling any instance of the Agent before reinstalling it rather than attempting to install over the existing kit.

Database Scanning: Reporting on a Mirrored Sybase Disk Device
The Capacity Reporter software does not report on Sybase device status or on device mirror status.

Database Scanning: Reboot Proxy Machine after Installing Oracle PC Client
If you install the Oracle PC client on the proxy machine, you must reboot the proxy machine before scanning.  Failure to do so may result in database scans hanging. 

Database Scanning: Edit the CLASSPATH Environment Variable for Viewing Charts and Graphs (Sybase only)
If a typical Sybase PC Client installation has been performed on the same machine from which you are browsing to Capacity Reporter for Database Servers, the charts and graphs do not display properly. This problem is caused by an older version of the graphing package embedded in certain Sybase PC Client components. The recommended solution is to browse to Capacity Reporter for Database Servers from a machine that does not have Sybase PC Client installed. However, if this is not possible and you want to view charts and graphs, you must edit the CLASSPATH environment variable, as follows:

  1. For Windows NT 4.0

    1. From the Start menu, go to Control Panel > System.

    2. Select the Environment tab.

    3. Select CLASSPATH under System Variables.

    4. Remove or change all the paths to the 3pclass.zip file to prevent detecting the 3pclass.zip file, thereby preventing the old classes from being loaded.

      Note: Any Sybase PC Client tools that depend on the 3pclass.zip file may fail because the 3pclass.zip file will no longer be detected in the CLASSPATH variable. To fix this problem replace the original 3pclass.zip settings in the CLASSPATH.

    5. Append the absolute path, including the filename, of the netcharts.jar file to the CLASSPATH variable. The netcharts.jar file is typically found under the \Inetpub\wwwroot\StorageResourceManager\Chart directory.

      Example:
      CLASSPATH=C:\Inetpub\wwwroot\StorageResourceManager\Chart\netcharts.jar

  2. For Windows 2000

    1. From the Start menu, go to Control Panel > System.

    2. Select the Advanced tab.

    3. Click on the Environment Variables... button.

    4. Select CLASSPATH .

    5. Click on the Edit... button.

    6. Remove or change all the paths to the 3pclass.zip file to prevent detecting the 3pclass.zip file, thereby preventing the old classes from being loaded.
      Note: Any Sybase PC Client tools that depend on the 3pclass.zip file may fail because the 3pclass.zip file will no longer be detected in the CLASSPATH variable. To fix this problem replace the original 3pclass.zip settings in the CLASSPATH.

    7. Append the absolute path, including the filename, of the netcharts.jar file to the CLASSPATH variable. The netcharts.jar file is typically found under the \Inetpub\wwwroot\StorageResourceManager\Chart directory.


      Example:
      CLASSPATH=C:\Inetpub\wwwroot\StorageResourceManager\Chart\netchartschart.jar

  3. Clear the Internet Explorer cache.

    1. From the Internet Explorer Tools menu, select Internet Options...

    2. On the General tab, under Temporary Internet files , click on the Delete Files... button.

Database Scanning: Virtual Memory problems on Capacity Reporter Server
Using equipment that does not meet specified prerequisites for the Capacity Reporter Database Plug-In software can cause virtual memory errors. To avoid this problem, be sure your equipment meets the Capacity Reporter Server prerequisites listed in \PlugIns\Database\database_readme.htm on the product CD-ROM.

Plug-In Registration Wizard for the 6900/3900 device does not accept the period (".") as a valid character in the SRM Display Name field.
The Plug-In Registration Wizard for the 6900/3900 device does not allow the input of the period (".") as a valid character in the SRM Display Name field. If you wish to enter a fully qualified name, you may cut-and-paste content into the field.  Alternatively, when filling out the Service Processor Name field, the SRM Display Name field is populated with a fully qualified name including the port number; delete the port number and leave the name.

Install may fail when installing databases whose names contain a hyphen
When attempting to install a database with a name that includes a hypen ("-"), the install may fail.  Do not use hyphens when installing databases to avoid this issue. 

Exchange not accessible through Master Console in Capacity Reporter v6.0 
If you upgrade to Capacity Reporter v6.0 from a previous version, there are no longer any links to SRM for Exchange.  If you need to manage existing SRM for Exchange Agents, visit the following URL to gain access:
http://%SRMServer%/SRM/SRMforExchange.asp where %SRMServer% is the server where Exchange is installed.

File Reporter: Do not Install a Capacity Reporter Server or a Capacity Reporter Agent on the Same Machine as the File Reporter Software
Installing File Reporter software on a machine that is running Capacity Reporter or a Capacity Reporter Agent is not supported.

File Reporter: Windows 2000 Installations
When installing File Reporter software on a Windows 2000 server, you must manually establish the Microsoft Transaction Server account as follows:

  1. From the Control Panel select Administrative Tools -> Component Services -> Computers ->My Computer -> COM+ Applications
  2. Right-click IIS-Default Web Site//Root/FileReporter
  3. Choose Properties -> Identity tab
  4. Change the User name to the installation account of the Capacity Reporter Server that File Reporter has registered with (the default is <Domain> \SRMSVCUser)
  5. Enter and confirm the password for this account.
  6. Click OK .

File Reporter: If a Capacity Reporter Agent Has no Admin Shares, Change .csv File Path Names
To synchronize partition information between File Reporter and Capacity Reporter Agents that have no Admin shares, edit the agent's .csv file path names.
To do this, perform the following on the Capacity Reporter Agent computer:

  1. Go to Start -> Programs -> Microsoft SQL Server 7.0 -> Enterprise Manager .
  2. Expand SQL Server Group -> <Target Server> -> Databases -> SRMFC -> Tables .
  3. In the right pane, right-click on Partition and select Open Table -> Return All Rows from the menu that displays.
  4. For the appropriate computer, edit the path in the corresponding CSVFileLocation column. Do this by replacing the share name in the path to the actual share name on the Capacity Reporter Agent.

File Reporter: The File Reporter Service Account Must Have Local Admin Privileges on Monitored Capacity Reporter Agents
To collect detailed file information on a Capacity Reporter Agent, File File Reporter needs access to the agent's administrative shares. To gain access, File Reporter's Service Account must have Local Admin privileges.

File Reporter: Use a 'Regular Identifier' for File Reporter Database
During the install process, when entering the name of the File Reporter database, it is necessary to use a 'regular identifier'. See SQL Server documentation for details on identifiers and naming conventions.

File Reporter: Temporary Directory Left Behind
Setup.exe does not remove a directory created in the System Temporary directory. An example of the directory name is GLF10.dir . You must manually delete this directory.

File Reporter: Prerequisite Log Text is Appended
Each time setup.exe is run, a prerequisite check is made on the computer. Errors are written to PrerequisiteLog.txt, available from the Details button on the Prerequisite Failed dialog box. Each time the file is generated, the information is appended, not overwritten.

File Reporter: Windows NT Local Language Must be Set to US English
Windows NT local language must be set to US English for .CSV file creation, or file import will fail.

Back to Contents

Known Issues


The following are known issues relating to this release of Capacity Reporter:

Hitachi Data Systems HiCommand Server reports Storage Capacity Differently than Capacity Reporter Software
The HiCommand Server calculates storage space as follows:

1 KB = 1000 bytes
1 MB = 1000 KB
1 GB = 1000 MB
And so on...

The Capacity Reporter software defines 1 KB as 1024 bytes, 1 MB as 1024 KB, and so on. Because of this difference, you will see discrepancies between storage capacity reported by the HiCommand Server and Capacity Reporter software for a given 9900 Series RAID Array. The actual physical storage capacity of the device does not change.

The Sun StorEdge T3 Array Console Reports Storage Capacity Differently than Capacity Reporter Software
The Sun StorEdge T3 Array console calculates storage space as follows:

1 KB = 1000 bytes
1 MB = 1000 KB
1 GB = 1000 MB
And so on...

The Capacity Reporter software defines 1 KB as 1024 bytes, 1 MB as 1024 KB, and so on. Because of this difference, you will see discrepancies between storage capacity reported by the T3 console and Capacity Reporter software for a given T3 Array. The actual physical storage capacity of the device does not change.

Import from a Universal Security Group
When importing User or Directory Group members from a Universal Security Group defined in Domain A, where the Universal Security Group contains users defined in Domain A and Domain B, only Users or Directories owned by accounts defined in Domain A will be imported. It is possible that Users defined in Domain A that are not part of the Universal Security Group may be imported inadvertently.

When importing User or Directory Group members from a nested Global Group only those Users or Directories listed in the parent group will be imported. Members of any 'sub groups' will not be imported.

Receiving "The page cannot be displayed" Error Message While Accessing Capacity Reporter Software
While accessing the product when running IIS 5.0 in conjunction with an anti-virus software application, you may receive the "The page cannot be displayed" error message. If you encounter this error, close your browser session, and then shut down and restart the anti-virus software.

Missing Package May Be the Cause of Linux Agent not Returning SCSI Information
If computer scans on a Linux machine fail with errors such as "sh:/sbin/scsi_info: No such file or directory", the scsi_info utility is not installed or available. To fix this problem, download and install the kernel-pcmcia-cs package from Red Hat or from your Linux distribution CD.

File Scanner Ignores Alternate Data Streams
Files on NTFS can have an arbitrary number of independent data streams. The Capacity Reporter file scanner, like most programs, ignores all but the primary data stream. Alternate streams are not well known, but are occasionally used to hide information or to maliciously fill up a disk. By ignoring the alternate streams, Capacity Reporter software ignores files that should be on the large file list and, on Windows 2000, produce per-user usage that differs from the Windows 2000 quota code.

See the Microsoft web site for more information on working with streams. 

File System Scans Fail when Host of an NFS Mount Point is Unreachable
On UNIX machines, file system scans fail if the host of an NFS mount point is unreachable.

Missing SmartArray Logical Drive
Capacity Reporter software cannot detect that a logical drive has failed or disappeared until the system containing the SmartArray controller is rebooted.

Grown Defects Reporting
By default, Grown Defects reporting is disabled by setting the SKIP_DEFECTS option to TRUE in uagent.cfg. This can reduce scan times and also prevent error messages from accumulating in T3 Array message logs.

If you enable Grown Defects reporting, error messages appear in T3 Array message logs, because T3 Arrays do not support grown defects reporting.

Adding UNIX directories on the Add Directories page
When adding UNIX directory entries on the Add Directories page, it is possible to create an entry whose path appears to be correct, but whose file system component of the path is incorrect. If this happens, the managed directory will appear to be missing after a scan occurs.

To avoid this problem, take one of the following actions:

Importing Capacity Reporter User and Directory Group members from ADS
In all cases when importing User and Directory Group members from ADS "NT Style" naming conventions must be used in place of the Active Directory names. For example:
SERVERNAME\Administrator is required instead of Administrator@SERVERNAME.DOMAIN .

Uninstall/Reinstall Capacity Reporter Server Will Reset Capacity Reporter Settings
If you uninstall/reinstall a Capacity Reporter Server, settings such as Remote Install Scripts and E-mail Alert text changes will be lost.

Upgrade Does Not Remove Backup Plug-In
Capacity Reporter no longer supports the Backup Plug-In. However, if you upgrade to Version 6.0 from a previous version of the software, the Backup Plug-In user interface pages still display. A clean installation of Capacity Reporter software, Version 6.0 removes the Backup Plug-In user interface pages.

Automatic Deletion of Remote Install Scripts
If you uninstall Capacity Reporter software while keeping the database, any remote install scripts created through Capacity Reporter are deleted.

Do Not Use the Help Window's Refresh Button When Using Internet Explorer 5.5 or Internet Explorer 5.5 SP1
Clicking Refresh while viewing the Help in IE 5.5 or IE 5.5 SP1 may display a run-time error and a dialog box asking if you want to debug the application. If this dialog box displays, click No when asked to debug the application.

This problem does not occur on IE 5.0 or IE 5.5 SP2.

Clicking on the Help window's back button when using Internet Explorer 5.5 SP2 can cause Index or Search tabs to blank out
If you enter text into the Index or Search tabs and then click the Help Window's Back button, the Index and Search tabs may blank out. To fix this problem, click on the Help Window's Refresh button, or close the Help Window and reopen it.

Internet Explorer 5.0 SP1, 5.5 SP2, or 6.0 Required for Remote Installation
To perform remote installations of the Capacity Reporter agent, you must use Internet Explorer 5.0 SP1, 5.5 SP2, or 6.0, with appropriate security patches for each version.

Java Virtual Machine (JVM) Must Be Installed to View Charts and Graphs
Any Internet Explorer browser used to view charts and graphs must have the Java Virtual Machine installed.

Java Developer's Kit (JDK) May Interfere with Display of Charts and Graphs
If you open the application from a computer that also has the Java Developer's Kit installed, charts and graphs may not display. To allow charts and graphs to display, disable the Java plug-in on the browser.

Mounted Volumes without Drive Letters not Reported in File System Report
In some cases if a volume has been created but not assigned a drive letter, it may not be reported in the File System Report after a scan. To ensure that volumes are consistently reported they must be given a drive letter upon creation.

Disk Reports on UNIX Platforms Display a "Filesystem Section Start On Disk" value of 0.00MB
The "Filesystem Section Start On Disk" value for Disk Reports on UNIX platforms shows a value of 0.00MB, which may be incorrect.

Solaris Systems Running Solstice DiskSuite Prior to V4.1 are Unsupported
The Capacity Reporter software does not support Solaris systems running Solstice DiskSuite (Sun volume manager) prior to V4.1. To work around this restriction, add the path /usr/opt/SUNWmd/sbin to the root login Bourne shell path environment variable, or make the utilities contained in /usr/opt/SUNWmd/sbin accessible to the Capacity Reporter Agent.

Capacity Reporter Cannot Determine Disk Controller Type on Systems Using SBUS Architecture
On Solaris systems using the SBUS architecture, the Capacity Reporter software cannot determine the type of disk controller in use. The application reports the controller for the disk as "unknown".

Capacity Reporter Cannot Always Collect Information about Physical Disks on Solaris 5.6 or Earlier Operating System
The Capacity Reporter software can have problems collecting information about physical disks, such as make, model, firmware, or rotational speed. In these cases, reports display "unknown" for those items.

Version 6.0.1 UNIX Agent Upgrade on Veritas Clusters
If you upgrade to the version 6.0.1 UNIX agent on a Veritas cluster, subsequent scans cause the cluster alias and virtual servers to appear grayed out. To fix this, rerun the registerca script. NOTE: You may lose some history as a result of rerunning this script.

Capacity Reporter Display Name must Match Network Appliance Device Name
When assigning a Capacity Reporter display name to a Network Appliance device, you must assign the Network Appliance device's true network name. Scans fail if the Capacity Reporter display name does not exactly match the Network Appliance device's true network name.

Date-Time User-Defined Attribute
When using the date-time data type for a user-defined attribute, the following settings are valid:

The following setting is invalid:

Database Scanning: Use a Single Capacity Reporter Proxy Server to Scan Sybase Databases on the Same Database Server Instance
Do not set up two different Capacity Reporter Proxy Servers to scan Sybase databases on the same database server instance. This may cause a temporary database deadlock situation, which could result in Sybase terminating the connection, thereby causing a scan failure.

Database Scanning: Scan Requests Not Functioning
Database scans may timeout. Subsequent scans should continue to function.  If you want to increase the timeout value, contact Sun Support.

Remote Scanning: Scanning Limitations on Windows NT if Disk Administrator Has Not Run
If the disk administrator has not run at least once on a Windows NT computer, the Capacity Reporter proxy agent does not report:

  1. Disk capacity and signature
  2. Volume mapping

Note that the disk drives will be assigned signatures based on index. When the disk registry does become available, it generates true signatures. The user interface reports the new drives while the signatures based on index appear as lost.

Remote Scanning: Download Failures Function Might Be Unreliable with Earlier Versions of Internet Explorer
The Download Failures function of CSV bulk registration behaves reliably with Netscape and Internet Explorer Version 5.5, Service Pack 2. If you use an earlier version of Internet Explorer, you might see unexpected results, which can include "Page not found" messages or unexpected values written to the failure.csv file.

Norton AntiVirus Scanner can Interfere with Capacity Reporter Scanning
The Norton AntiVirus scanner can interfere with Capacity Reporter scanning. To avoid this problem, disable Norton AntiVirus on the Capacity Reporter Server machine.

How to Get Adobe Acrobat Reader
The documentation on the CD-ROM is in PDF format. If you do not have Adobe Acrobat Reader, go to www.adobe.com to obtain a free copy.

Unlabeled Disks not reported when Veritas Volume Manager is present
When Veritas Volume Manager is installed, Unlabeled Disks may not get reported, and will not be visible through Capacity Reporter.  Unlabeled disks will be reported and visible in Capacity Reporter if Veritas Volume Manager is not installed.  

Event Log will Fill Quickly if Computer Groups are Left Empty and Scanned on Schedule
If a computer group is intended to be left empty, it's scan schedule should be set to scan on demand only. This will prevent the application log filling quickly.

LDAP Lookup Does Not Function if Capacity Reporter Server Is Not In Same or Trusted Domain as Exchange Server
In order for the LDAP lookup to work correctly (allowing directory aliasing), the Capacity Reporter Server needs to be in the same, or a trusted domain as the Exchange Server. If it isn't, then other email alert functionality continues to work as expected, making it possibly difficult to troubleshoot the LDAP not working. The Capacity Reporter server can send email by sending it out port 25 (SMTP) and then uses a DNS server to lookup the Exchange Server. The Exchange Server's LDAP directory is configured with access permissions, which will be denied if the Capacity Reporter Server is not in the proper domain.

If the 9900 Series RAID Array Contains an ESCON Card, Some Scan Details May Be Incorrect
Due to limitations of the Hitachi Data Systems HiCommand Server 2.0 API, if the 9900 Series RAID Array being scanned contains an ESCON card, then the mainframe Parity Groups and mainframe LDEVs will list the following discrepancies:

Removing a Failed 9900 Series Device From the RAID Report Does Not Do an Implicit Full Unregister Of The BVO
If you have a failed 9900Series Device in your RAID Report and you click on the device then Remove it, this will remove the device from the RAID Report in Capacity Reporter but will leave the Link and Launch Button in the HiCommand interface.

Do not upgrade to Capacity Reporter v6.0 from the beta version of 6.0.  
Upgrading Capacity Reporter v6.0 from the beta version may result in database layouts working incorrectly.  Do not upgrade from beta to v6.0. 

File Details Report and Directory Details Report icons on the Summary Report for File System page for NAS and NetWare devices may not launch correctly
The File and Directory Details Reports may not launch correctly from the Summary Report for File System page, even when the "Collect file details on these file systems" check box was checked. 

File Reporter: Manually Starting a File Collection Starts Scheduled File Collections
If a partition group file collection is started manually, file collections for other partition groups scheduled for the current day will start once the manually scheduled collection is complete. If you run partition group file collections manually, disable the day's other currently scheduled partition group file collections. Once the manual collection is complete, re-enable the scheduled collections.

File Reporter: Read-only .csv Files Not Deleted After Import
If an SRMFileData.csv file on a Capacity Reporter Agent machine’s partition is Read-only, it will not be deleted from the File Reporter software’s Staged File directory after import into the SRMFC SQL Server database. This will cause the CopyFile in next processing run of the same .csv file to fail. Ensure that SRMFileData.csv files are not Read-only on the Capacity Reporter Agent machine partitions.

File Reporter: SynchLog.log File
During installation, the File Reporter software creates a log file named SynchLog.log in the \wwwroot\FileReporter folder of the File Reporter server machine. This file logs information regarding synchronization attempts between File Reporter and Capacity Reporter. If the file is deleted, it will be recreated during the next synchronization event.

File Reporter: Trace Log Becomes Too Large to Open
If left on, the trace log continues to grow and eventually becomes too large to open. To keep the Trace Log active, periodically suspend FCService (when no jobs are queued) and backup/delete the existing Trace Log.

File Reporter: Do not Open Multiple Sessions of the File Reporter Console
Opening multiple sessions of the File Reporter Console on the same or on different machines can cause database access problems.

File Reporter: Use Certain Operators and Values When Performing Query Builder Date Queries
On the Query Builder page, the second date Value field for each date type (Creation, Access, or Modified) is only applicable to queries using the Between operator. For all other date queries, use only the first date Value field with any of the remaining operators (=,<,>,<>).

File Reporter: Enter the Drive Letter with a Colon When Performing Query Builder Partition Queries
On the Query Builder page, when performing a search on a partition name, you must enter the partition's drive letter along with a colon in the Partition Name's Value field. Otherwise the query may fail.

File Reporter: SQL Server Setup Can Cause Query Builder "All File" Report to Display No Data
If the SQL Server has been configured to restrict tempdb file growth and if insufficient space has been allocated for the tempdb file, the Query Builder all file report may display "No records meet your report criteria", even though data was collected. You may also find error #1105 in the application Event Viewer log.

To correct this problem, Sun suggests that you select the tempdb parameter Unrestricted File Growth.

File Reporter: The File Size (MB) Field Cannot Accept Multiple Values
On the Query Builder page, the File Size (MB) field cannot support multiple values entered in its Value field.

File Reporter: If the File Reporter Machine's SQL Server Service is Stopped, Stop and Restart the FCService Service
If the File Reporter machine containing the SRMFC database stops its SQL Service, the File Reporter Service must be stopped and restarted. Otherwise, .csv file collection will not continue.

File Reporter: Directory, Files, and Data Source Left Behind
When uninstalling the File Reporter software, the Remove All option does not delete the File Reporter program directory, Program Files\File Reporter . In addition, Remove All does not delete the File Reporter ODBC data source. Remove All also leaves two files in the \Install directory:

These must all be deleted manually.

Back to Contents