Applies To:

Show Versions Show Versions

Release Note: Data Manager version 2.0.1 and 2.0.2
Release Note

Updated Date: 07/07/2009

Summary:

This Release Note documents version 2.0.1 of the F5 Data Manager.

Contents:

- User documentation for this release
- Minimum system requirements and supported browsers
- Network requirements
- Supported ARX releases
- Supported file servers
- Upgrading Data Manager
- General notes
- Enhancements in this release
- Known issues
- Contacting F5 Networks


User documentation for this release

The documentation is available from the following locations:

  • From the Data Manager GUI navigation panel Documentation link.
  • On the AskF5 Technical Support web site, along with an extensive solutions database.
  • In the root directory of the product CD-ROM.
[ Top ]

Minimum system requirements and supported browsers

You can install and run Data Manager on any Microsoft® Windows® platform that meets the following set of minimum requirements:

  • Operating System: Windows operating system (2000, XP, Vista, or 2003 Server)
  • CPU: Pentium 4 or equivalent
  • Memory: 1Gb available RAM

Supported browsers for accessing the Data Manager GUI:

  • Microsoft Internet Explorer®, version 6.0 or higher
  • Mozilla® Firefox® 1.5 (or higher) and other browsers that use the Mozilla engine

    Note that Javascript must be enabled on the web browser.

 

[ Top ]

Network requirements

  • Access to administrator credentials for the file server management interfaces.
  • TELNET or SSH enabled on file servers to be discovered.
  • Verified network connectivity to the file server(s) that the ARX will be communicating with.
  • Access credentials to CIFS shares and NFS exports (for the File System Inventory Module).
[ Top ]

Supported ARX releases

Data Manager supports the automatic generation of configuration files suitable for uploading to all F5 Acopia switch models. You can use the configuration files generated on switches running FFNOS 3.x and above. FFNOS 3.x is required because the generated Data Manager configuration files implement support for the following FFNOS 3.x features:

  • CIFS Share-ACL support
  • Auto-volume file credits
  • Active Directory auto-discovery
  • Local group SID translation enhancements

The File System Inventory Module may be used to inventory an ARX VIP from any FFNOS version.

[ Top ]

Supported file servers

Using SSH and TELNET, Data Manager supports discovery of configuration information and use of the File System Inventory Module on the following file servers:

  • IBM N Series. At code levels: ONTAP 6.1.x, 6.3.x, 6.4.x, 6.5.x, 7.0.x, 7.1.x, 7.2.x, 7.3.x. Protocols: CIFS, NFS. F5 Data Manager v2.00.001 supports the discovery of N-Series Vfilers.
  • IBM 500 G. At code levels: AIX 5L, 5.2B.

    Protocol: NFS.

  • IBM 300 G02. At code levels: Windows 2000 Server, Windows 2003 Server.

    Protocol: CIFS.

  • IBM AIX. At code levels: AIX 5.1, 5.2, 5.3.

    Protocol: NFS.

  • EMC Celerra NSX. At code levels: DART 5.4.x, 5.5.x, 5.6.x.

    Protocols: NFS, CIFS.

  • NetApp FAS. At code levels: ONTAP 6.1.x, 6.3.x, 6.4.x, 6.5.x, 7.0.x, 7.1.x, 7.2.x, 7.3.x.

    Protocols: CIFS, NFS.

    F5 Data Manager v2.00.001 supports the discovery of NetApp Vfilers.

  • Microsoft Windows. At code levels: Vista, Windows 2000 Server, Windows XP, Windows 2003 Server.

    Protocol: CIFS.

    F5 Data Manager v2.00.001 provides enhanced support for Microsoft Windows Clustered File Servers. In addition, Data Manager v2.00.001 provides enhanced support for localized Microsoft Windows distributions. Microsoft Windows provides localized versions of its Windows operating system. For Data Manager, each distribution must be qualified separately. Currently, Data Manager provides support for the following language distributions: Japanese, Simplified Chinese, Korean, German, Czech, Russian.

  • Linux Intel-based. At code levels: Redhat Enterprise 3.x, 4.x, 5.x.

    Protocol: NFS.

  • Solaris. At code levels Solaris 8, 9, 10.

    Protocol: NFS.

[ Top ]

Upgrading Data Manager

When upgrading to a new version of Data Manager, follow these steps:

  1. Uninstall the current version of Data Manager. From the Start menu, click Programs > F5 Networks > Data Manager > Uninstall Data Manager.
  2. When the screen appears asking which items to retain, leave all the checkboxes checked. In other words, retain everything. These items are saved in their current location; for example: <application root dir>\db
  3. Install the new release of Data Manager.
  4. Stop the Data Manager service. From the Start menu, click Programs > F5 Networks > Data Manager > Stop Data Manager.
  5. Copy the files you retained in step #2 to the new location; for example, the default location which is:

     

    C:\Program Files\F5 Networks\Data Manager

  6. Start Data Manager. From the Start menu, click Programs > F5 Networks > Data Manager > Start Data Manager.
[ Top ]

General notes

Cannot use mounted drives for location of SAT Inventory and SAT Report directories (31143)

Since Data Manager starts as a system service, it does not have access to drive mounts by a user account. If space on the local Data Manager machine is inadequate for storing the statistics files and report files that result from file system inventories, you will need to store these files in a separate location.

Workaround: Use the following procedure to change the default location for storing these files:

  1. Log out of Data Manager.
  2. From the Data Manager machine Windows Start menu, click Administrative Tools and then click Services.
  3. In the list of services, locate Apache Tomcat F5DM.
  4. Right-click Apache Tomcat F5DM and select Properties.
  5. In the Properties dialog, click the Log On tab.
  6. Select the This account radio button and enter the credentials to an account that has access to the share where you want to store the files.
  7. Click Apply or OK to save your changes.
  8. Right-click Apache Tomcat F5DM and select Restart to restart F5 Data Manager with the new account credentials.
  9. On the File System Inventory Module Settings page, enter a share name in the Statistics File Directory field and/or the Report File Directory field in the format: \\remote-system\directory\share-name\

The next time you save a statistics or report file from Data Manager, the file should be stored in the new location.

Note that if you reboot your system or restart Data Manager through the Start menu, you will need to readjust the Log On credentials as outlined above.

In the Configuration wizard, protocol selection drives what the user sees in subsequent pages (30641)

In the second page of the Create ARX Configuration wizard, the user is asked to select protocols for the configuration about to be created (NFS, CIFS, NFS and CIFS, or Multi-protocol). The wizard is asking for the user's intent. The protocols selected then drive what the wizard shows in subsequent pages (import paths, AD credentials, ARX configuration options).

ACL warnings appear in the discovery log as "not supported." (30927)

ACL warnings appear in the discovery log as "not supported." The customer receives these warnings even though the storage can be mounted and accessed from an ARX.

For most of the NFS ACL option warnings there is a general explanation. Many of these flagged options are associated with changing the filer's behavior on a per client basis and are not associated with client authorization and access. These behavioral options are not implemented on the ARX and therefore will not be enforced by the ARX. Secondly, since the ARX is acting as a proxy between the file server and the client machine, the file server cannot distinguish between different client machines.

For example, suppose there are 2 different clients for an NFS export, 1 client has an option and the other does not. The ARX as a proxy does not distinguish between those clients and appears to the filer as a single client. So, both clients will get the same option setting.

[ Top ]

Enhancements in this release

SSL

To provide increased security, Data Manager now requires SSL. When you open a browser and enter a URL, be sure to specify a secure HTTP connection in the following format:

HTTPS://<IP-ADDRESS>:<PORT-#>

Where

<IP-ADDRESS> is either the full IP address or hostname of the host where Data Manager is running (localhost if you are running Data Manager on your local host).

<PORT-#> is the application port number assigned to Data Manager during the installation process (default: 443).

The default URL is HTTPS://localhost:443.

You can specify an alternative port number during the installation process or from the General Settings page. If you change the port number, change your URL accordingly:

HTTPS://<IP-ADDRESS>:<NEW-PORT-#>

In addition, although Data Manager does not ship with a keystore file, it generates one on installation by invoking the following command.

"%JAVA_HOME%"\bin\keytool.exe -genkey -alias tomcat -keyalg RSA -dname "CN=%COMPUTERNAME%" -keypass changeit -storepass changeit -keystore "%FFNM_INSTALL%"\tomcat\conf\.keystore -validity 360

You can learn more about keytool at: Key and Certificate Management Tool documentation.

The command relies on you having defined the following environment variables:

  • JAVA_HOME. Set this variable to the top level JRE install directory.
  • COMPUTERNAME. Set this variable to your computer's name (typically its hostname).
  • FFNM_INSTALL. Set this variable to the top level Data Manager installation directory.

On installation, Data Manager creates a basic certificate that lasts 360 days. You can use this certificate to get started using Data Manager securely. You can replace the Data Manager certificate with your own self-signed certificate which you can either add to the existing keystore or add to your own newly-created replacement keystore. If you do not create your own certificate and allow the default Data Manager certificate to expire, you will need to generate a new certificate or reinstall Data Manager.

User-Settable Password and Port Number

As part of the installation procedure, you can set the password for logging in to F5 Data Manager and you can also change the default port number. The default password is password and the default port number is 443.

[ Top ]

Known issues

The following items are known issues in the current release. For issues that are being tracked on the F5 Acopia internal database, note the tracking numbers that appear in parentheses.

File server does not prompt for a username.

Some file servers may not automatically prompt for a username during a TELNET or SSH connection attempt. Entering a username when using the Data Manager Discovery wizard will cause the discovery to fail.

Workaround: If this occurs when performing a discovery of these file servers using the File Server Discovery wizard, leave the username field blank and simply specify the password.

User experiences longer than expected discovery connection times.

In some cases when using SSH to discover a Network Appliance file server, the discovery can take longer than normal. This is because F5 Data Manager is issuing connection retries for a particular class of connection issues. (The default connection timeout is 60 seconds.).

F5 Data Manager does not persist data for partially configured or invalid objects.

For EMC file servers, F5 Data Manager will not discover partially configured CIFS servers. The discovery report will report these partial configurations as warnings.

In a NetApp configuration, if any qtrees in a volume do not have the same security as the parent volume, you cannot import at the NetApp volume level. (28272)

The ARX FFNOS does not support importing at the volume level if any qtree under the volume has a different security mode from the parent volume. F5 Data Manager enforces this rule by making it impossible to select the volume when using the Create ARX Configuration wizard.

If the F5 Data Manager port setting has been changed, you may need to log out to refresh the desktop shortcut to F5 Data Manager. (28676)

When the application port setting is changed, the F5 Data Manager URL file is updated. This file directs the desktop icon and "Launch F5 Data Manager" to open a web browser to the F5 Data Manager application.

Workaround:If your web browser does not successfully connect to F5 Data Manager after these settings are changed, you may have to log off and log in again to the operating system to clear any file data cached in the web browser.

Running inventory tasks when low on disk space and memory can cause problems and unpredictable results. (30733)

If the machine you are running F5 Data Manager on is low in disk space and memory, the inventory tasks may crash, creating incomplete statistics files or failing to create statistics files at all. If memory is sufficiently low, F5 Data Manager may not be able to create dump files or diagnostic files. (The f5dm.zip file created will be corrupt.)

File servers that asynchronously log messages to the console could interrupt discovery (30868)

File servers that allow messages to be streamed to the console asynchronously, run the risk of interrupting the F5 Data Manager file server discovery process. F5 Data Manager recognizes the prompt character and uses it to identify the completion of discovery commands. If console messages corrupt the prompt string, F5 Data Manager will fail to recognize the completion of the command.

Workaround: Due to the logging level, environmental issues, or a chronic issue with the file server, you may need to disable console messages during the discovery process.

Do not attempt to open the discovery.wsf script from the browser (30957)

When preparing to execute a local discovery, do not attempt to open the discovery.wsf script from the browser. Always save the script first to a shared storage location on your network where the script can be accessed by you, the F5 Data Manager server, and all the file servers that you need to discover.

Report.exe returns different values for same operation on Windows 2000 (31802)

Windows 2000 does not come with the correct version of dbghelp.dll needed by Inventory and Report. You can acquire dbghelp.dll as a part of the user mode process dumper tools provide by Microsoft. You can download these tools from: User Mode Process Dumper Version 8.1.

The downloaded file will be a self extracting zip file. Locate the dbghelp.dll and copy to the Program Files\F5 Networks\Data Manager\bin directory. (You do not need anything else from the downloaded files). Alternatively it could be copied to the Windows\system32 directory if it does not already exist there (Windows may over-write this newer copy if it an older copy is already there).

 

Unable to connect to F5DM service if there is another service already running using port 443 (31815)

We have successfully installed the product and verified that the Apache Tomcat F5DM service has started by checking Administrative Tools -> Services. In addition, the command netstat -an shows that TCP port 443 in the following output:

TCP    0.0.0.0:443    0.0.0.0:0    LISTENING

However, the user cannot launch the login web page because there is another service already running on the machine and port 443 is being used by the other service instead of Data Manager. Commonly, all the server editions of OS like 2000 or 2003 Window's web server could already running causing the F5DM service to start in a bad state.

Workaround: Find out which service is using port 443 from Administrative Tools -> Services. If the user has not installed any web server then it could be World Wide Web Publishing Service running on the server edition of OS which can be turned off by stopping the IIS Admin Service. Then, restart the F5DM service.

 

Default licensing changed to include license for 4 units (file server base discovery) and an unlimited IP license (file server discovery) (31765)

On installation and in addition to the base product license, the user is now provided with the following licenses:

  • File Server Discovery Base
  • File Server Discovery Expansion License (unlimited IP units)

NFS File System Inventory tasks fail (no available drives letters) (31853)

NFS Inventory tasks require that the NFS file system be mounted to the F5 Data Manager Server. If you have many simultaneous NFS inventories running, you may run out of available drive letters. If an NFS inventory task fails, attempt the task again, when the current list of running NFS inventory tasks has diminished. If NFS inventories continue to fail, verify that the system has not exhausted its list of available drive letters. To verify the availability of drive letters for the system services, execute the following command in a windows command shell:

at <time> /interactive cmd.exe

where <time> is some time in the near future.

When the command window is displayed, execute the "mount" command to see the list of currently used drive letters and mounted file systems. Next, compare this list of file systems to those of running File System Inventory tasks. If any drive letter is attached to a file system that is not connected to a running task, you should consider running the "unmount" command to unmount that file system and free that drive letter.

[ Top ]

Contacting F5 Networks

  Phone: Contact your local Sales Engineer.
Fax: (206) 272-6802
Web: http://support.f5.com
Email: *F5DM@f5.com

For additional information, please visit http://www.f5.com.


Was this resource helpful in solving your issue?




NOTE: Please do not provide personal information.



Incorrect answer. Please try again: Please enter the words to the right: Please enter the numbers you hear:

Additional Comments (optional)