DeployDirector Readme

Version 2.6.0

Installing DeployDirector

To begin installing DeployDirector, execute one of the included files that matches your target platform:

PLATFORM EXECUTABLE FILE EXECUTE COMMAND
Solaris solaris_dd_260.bin sh solaris_dd_260.bin
IBM AIX aix_dd_260.bin sh aix_dd_260.bin
RedHat Linux linux_dd_260.bin sh linux_dd_260.bin
HP-UX hpux_dd_260.bin sh hpux_dd_260.bin
Windows windows_dd_260.exe double-click icon or ./windows_dd_260.exe from command prompt

Once executed, DeployDirector will be installed, after which the Configuration Wizard will run, and allow you to customize your installation.

Please note that these instructions supercede those given in the product documentation.

Installation Notes

The Configuration Wizard is a Java application, but is packaged with a startup script. To manually execute it, use the following command:

$(DD_HOME)/standalone/bin/wizard.[bat|sh]

using the ".bat" file on windows and the ".sh" file on Unix/Linux/MacOSX.

If you are integrating DeployDirector with Websphere (all versions) you must edit the file WEB-INF/web.xml in the WAR file and remove the JSP servlet mapping. This section is labelled "Remote Administrator."

Changes Since Version 2.5.0

Changes Since Version 2.0.8

Changes Since Version 2.0.7

Changes Since Version 2.0.6

Changes Since Version 2.0.5

Changes Since Version 2.0.4

Changes Since Version 2.0.3

Changes Since Version 2.0.2

Changes Since Version 2.0.1

Changes Since Version 1.5.3

Changes Since Version 1.5.1

Changes Since Version 1.5.0

Changes Since Version 1.4.2

Changes Since Version 1.4.1

Changes Since Version 1.4.0

Changes Since Version 1.3.1

Changes Since Version 1.3.0

Changes Since Version 1.2.0

Known Problems

The following are known problems that are being addressed for the next DeployDirector release.
PR Synopsis
Standalone Server
12029  Standalone server will not run with JDK 1.2.0.
WORKAROUND: use another 1.1, 1.2, or 1.3 JVM 
Linux
16888  Mandatory bundle updates does not work properly on RedHat Linux 7.0. A bug in its JVM prevents the CAM from restarting during an update. (Logged as Sun bug #4388732, whose details can be viewed at: http://developer.java.sun.com/developer/bugParade/bugs/4388732.html).
WORKAROUND: Upgrade to RedHat 7.1. 
Solaris
13668  If Netscape Navigator is not on the path then "Show Admin Page" does not work from within the AdminTool 
Windows
29298  JComponent.paintImmediately will occasionally throw an exception when viewing tabular data in the Admin tool. (This exception can be ignored.) 
29283  Installation of the Admin Tool will fail on Windows XP if the user doesn't have local administrator privileges. 
Client
29758  Spaces are not allowed in the install directory name on UNIX, Linux or MacOS X.
WORKAROUND: Avoid spaces in the install directory name if deploying to UNIX, Linux or MacOS X.  
26659  Bundle update fails if updated JAR entries, when unpacked in the bundle update directory, have path lengths longer than the system limit (256 characters in Windows, 1024 for most Unices.)
WORKAROUND: Keep path lengths within JARs under 150 characters. 
24041  An IllegalArgumentException is thrown if an attempt is made to update from a version with no Authorization restrictions (AuthenticateAll/AuthorizeAll) to a version that uses authorization.
WORKAROUND: Delete the non-authorized version from the vault, forcing the update to replace the existing version. 
17242  When uninstalling a bundle, files not belonging to the bundle which had been added to the install directory on client machines are also removed. 
16952  Exception reporting dialog cannot be dismissed using the "x" button in the window title bar.
WORKAROUND: Since the exception cannot simply be ignored, the user must select one of the option buttons. 
11860  Dialogs can sometimes be obscured by the app they should be on top of. 
WORKAROUND: Minimize windows until the dialog is visible or on Windows use alt-tab to get to the dialog. 
Server
29206  If a bundle is using authorization, version names are restricted to the form of "n", "n.n" or "n.n.n" where "n" is a number.
28315  Log size limits will be ignored when using JDBC. Use the table size limiting facilities in your database.
24331  Bundles should not contain files whose names contain the comma (",") character as this can cause validation errors.
23802  Clustering servers does not synchronize the available set of bundles on those servers. Only bundles added after the cluster is created are replicated.
WORKAROUND: Use the Admin Tool's Transfer mechanism to synchronize the servers before clustering them. 
21919  The SAM cannot replicate over SSL.
WORKAROUND: Use regular HTTP connections between cluster members, or use Transfer groups to replicate bundles.
17675  Bundles whose names contain spaces cannot be uploaded to a Unix based SAM (AIX, HPUX, Linux, Solaris), and cannot be installed by Unix-based CAMs. 
17299  Checks are not performed for sufficient space before unpacking archives or zip streams.
WORKAROUND: Ensure adequate vault and tempfile space.
15312  The SAM cannot replicate through an authenticating proxy. 
12423  Using a mail server that requires username/password authentication causes a SendFailedException.
WORKAROUND: Replace mail.jar with an implementation of the JavaMail api that supports this ability. 
AdminTool
25596 Bundle Admins cannot create a valid install CD image. 
WORKAROUND: Create install CDs as a server Administrator.
20393 Uploading bundle with invalid Authentication and Authorization paramaters causes Admin Tool to generate an exception.  WORKAROUND: Check values entered carefully before commiting them.
14151  When creating an application using scheduled connection, ensure that the specified schedule interval is greater than the time required to perform an update of the application. (Too short an interval can result in a race condition arising.) 
13897  The AdminTool can run out of memory when using multiple instances of very large bundles.
WORKAROUND: Increase the maximum memory size of the JVM by setting the VM flag "-Xmx<size>" in the VM params field of the DDAdmin bundle, upload the changes and restart the admin tool. 
13175  In the reporting tool the load average column reads "Avg30Min" when the interval is really 15 minutes. 
12967  Constant refronting of the admin tool prevents the user from doing any other work while the tool is busy. 
Standalone Installer
26937  CD Installer not supported on Mac OS X. 
23710  CD Installer freezes on *NIX systems if the temp directory runs out of available diskspace. 
17394  Standalone installer does not correctly install platform-specific files in application bundles. 
WORKAROUND: Create platform-specific bundles.