1.1 Agent Controller does not work when
installed in Windows Desktop folder
1.2 Installing Agent Controller on Windows and Linux
1.3 Agent Controller installation cannot locate a default Java
Runtime
1.4 Agent Controller log file might not have public write
permission on non-Windows platforms
1.5 Classes residing on network drives are not accessible on
Windows
1.6 Cannot restart the Agent Controller process on non-Windows
platforms
1.7 Agent Controller install does not detect existing v4.0.3
Agent Controller
Additional readme information associated with TPTP Agent Controller is available in the TPTP V4.4 release notes.
Agent Controller does not work when installed in the Windows(R) Desktop folder on a Windows system. For example, Agent Controller will not work if you specify the install directory as C:\Documents and Settings\Administrator\Desktop.
To workaround this limitation, install Agent Controller in another directory.
Installing Agent Controller on Windows and Linux(R) will remove any existing Agent Controller installation. Make sure you have backed up necessary data before proceeding to installation.
The Agent Controller installation may not detect any JavaTM Runtime installed on the machine.
For win_ia32, win_em64t and linux_ia32, the installer would use the IBM JRE bundled as the default jre. You could provide an alternative Java Runtime installation which you want Agent Controller to use. For win_ipf, the installer would ask for jre path during installation.
The log file <Agent Controller install location >/config/servicelog.log might not have the required permission bits (666). This will prevent any non-root Agent Controller process from writing to the log file.
To workaround this problem, just run the command
chmod 666 <Agent Controller install location>/config/servicelog.log
as root after installation.
The Agent Controller service is configured to log on as "Local System Account". Therefore, it might not have the rights to access mounted network drives, which are usually accessed by means of net use, by the current user ID.
To enable IBM(R) Agent Controller to use the classes on network drives, follow these steps:
Note: This will allow the use of network drives, but will limit Agent Controller's access rights to whatever the current user has.
Agent Controller cannot restart on a non-Windows platform.
To work around this problem, follow these steps:
kill -s HUP < process ID of the inetd process >
(must be root)
<Agent Controller install location>/config/serviceconfig.xml
and restart Agent Controller immediately.
To prevent this from happening, always shutdown all connected workbench before
restarting the Agent Controller process.
If Agent Controller 4.0.3 is installed as a standalone product then it will be detected and properly uninstalled when installing version 7.1.0.1. If Agent Controller is installed as part of WSAD v4.0.3, the v7.1.0.1 installation cannot detect it and will not uninstall the older version. This is a Microsoft(R) Installer limitation.
To work around this limitation, you need uninstall WSAD v4.0.3 completely, since it is the parent product that installed Agent Controller v4.0.3. Ensure that Agent Controller v4.0.3 is properly removed by checking the Agent Controller install directory is empty and verify that the registry values HKLM\SOFTWARE\IBM\IBM Agent Controller and HKLM\SYSTEM\*\SERVICES\IBM Agent Controller no longer exist.
This information was developed for products and services offered in the
IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of LicensingFor license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia CorporationThe following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
IBM CorporationSuch information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
(C) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (C) Copyright IBM Corp. 2007. All rights reserved.
If you are viewing this information softcopy, the photographs and color illustrations may not appear.
Programming interface information is intended to help you create application software using this program.
General-use programming interfaces allow you to write application software that obtain the services of this program's tools.
However, this information may also contain diagnosis, modification, and tuning information. Diagnosis, modification and tuning information is provided to help you debug your application software.
Warning: Do not use this diagnosis, modification, and tuning information as a programming interface because it is subject to change.
The following terms are trademarks of the IBM Corporation in
the
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc.
in the
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the
Intel, Intel Xeon, and Pentium are trademarks or registered trademarks of
Intel Corporation or its subsidiaries in the
UNIX is a registered trademark of The Open Group in the
Linux is a registered trademark of Linus Torvalds in the
Other company, product, or service names may be trademarks or service marks of others.
(C) Copyright IBM Corporation 2000, 2007. All Rights Reserved.