
Release Notes
Welcome to ColdFusion Server 5. These release notes include the following sections and links to other documentation:
ColdFusion Studio Tag Update
- A special CFML tag update for ColdFusion Studio 4.5.2 is included with ColdFusion Server 5. This update installs tag editors for the new tags introduced with ColdFusion Server 5 and updated documentation. This update can be found in the following places:
back to
top
Installation Notes
- For information about system requirements, installation procedures, and initial administration tasks for ColdFusion Server, see the Installing and Configuring ColdFusion Server book, which can be found in the following locations:
- On the ColdFusion Server 5 CD at \CFServer50\ColdFusionServer50\Documentation\PDF\ (Adobe Acrobat Reader required)
- Installed with ColdFusion Server 5 when documentation is selected and available from the ColdFusion Administrator homepage
- On the Macromedia site at http://www.coldfusion.com/developer/documentation/ColdFusion.cfm
- Upgrades from ColdFusion Server 5 betas and release candidates are not supported and will require an uninstall first.
- ColdFusion Server 5 supports upgrades from ColdFusion Server 4.5 and later.
Earlier versions of ColdFusion must be uninstalled before installing ColdFusion
Server 5. On Solaris, to preserve your Registry during an upgrade
from ColdFusion Server 3.x, 4.0, and 4.01, you must must run the registry
migration utility and run
pkgrm
.
- ColdFusion Server Enterprise Edition for Windows requires 500MB of free disk space for installation.
- On Windows NT 4.0, ColdFusion Server 5 requires Service Pack 5, Service Pack 6a or later, but the Installer will permit an install on Service Pack 4 or later. The ColdFusion Server documentation incorrectly states that Service Pack 6a is required.
- On Windows, when Advanced Security is installed in ColdFusion Server 5,
a pre-initialized Microsoft Access Policy Store is provided for you to use
while exploring the basic Advanced Security functionality in the ColdFusion
Administrator.
- Customers are strongly cautioned against using Microsoft Access as a
permanent Policy Store location, since the use of Microsoft Access with
SiteMinder is known to produce unpredictable results. Macromedia strongly
recommends that customers switch the active SiteMinder Policy Store from
the default Microsoft Access database to a Microsoft SQL Server database,
Lightweight Directory Access Protocol (LDAP) directory, or Oracle Server
database.
- A Wizard will open in the Administrator when Advanced Security is installed
to assist you in completing the Policy Store Migration and Upsizing steps. The wizard will prompt to initialize a new MS SQL Server or Oracle policy store (links are provided for full manual upsizing / migration instructions
and LDAP). The wizard will recognize customers upgrading from ColdFusion
4.5x and will step through the additional process of importing the ColdFusion
4.5x Policy Store data into a new ColdFusion Server 5 Policy Store. The
Policy Store wizard is available directly at http://localhost/cfide/administrator/securitywizard/index.htm.
- The ColdFusion Server 5 installation sets permissions to SYSTEM. If your ColdFusion Server permissions have been modified to something different, you will need to reset them after the installation.
- Mapped Verity Collections on a multi-server site: An important consideration in upgrading multi-server web sites
using Mapped-Verity-Collections is the Verity Collection migration that is performed during the installation. The
first server upgraded will migrate the mapped verity collections to the new verity format. This new format is not compatible
with ColdFusion 4.x search requests. It is therefore important to immediately upgrade all of the servers to
ColdFusion Server 5 to prevent failed search requests from the 4.x servers.
- Migration of Advanced Security Policy Store in a multi-server configuration will require immediate upgrade of all servers accessing the policy store. The policy store is converted to the new format during the migration and will no longer be compatible with 4.x software.
- Customers currently using a non-English language version of ColdFusion Server
cannot upgrade to the English version of ColdFusion Server 5 using a US upgrade serial number. Localized versions
of ColdFusion Server 5 will be available in the near future.
- Verity collections created or imported into ColdFusion Server 5 will no longer
work with earlier releases of ColdFusion Server.
- On Linux, the ColdFusion Server 5 installer does not support custom compiled versions of the Apache Web server.
Users of custom Apache builds must manually configure Apache to work with ColdFusion. For more information, see the
directions in the /opt/coldfusion/webserver/apache/ directory.
- Uninstalling ColdFusion Server will not remove K2 Server-managed collections that use the K2 Server alias scheme
to map existing ColdFusion collections. In other words, if you inserted a collection alias into the k2server.ini file and the K2 Server is running during the ColdFusion uninstall, that collection will not be removed..
- When a ColdFusion Server 5 uninstall is run, the following files are left on the system:
- IIS virtual directories
- IIS cfm/dbm mappings
- Folders created by CF 4.5 and earlier
- SiteMinder registry keys created by CF 4.5 and earlier
- Shortcuts created by ColdFusion Express 4.5
- ColdFusion Express 4.5 registry keys
- In upgrades from ColdFusion Server 4.5, if documentation was install on ColdFusion Server 4.5 and not installed
on the ColdFusion Server 5 upgrade, the old 4.5 documentation is not deleted and the documentation link in the
ColdFusion Server Administrator will point to the old 4.5 documentaion.
back to
top
Resolved Issues
The following list represents a partial list of issues resolved in ColdFusion Server 5. The corresponding bug tracker number(s) appear in parentheses after the issue description.
Authentication
- On Solaris, ColdFusion Server no longer experiences authentication problems with Advanced Security and LDAP servers. (16176)
- ColdFusion Server no longer returns inaccurate results if Advanced Security can connect to the necessary user directories, including LDAP servers and user databases. An error will be generated instead. (15810)
CFML Functions
- To prevent confusion over day and year in the LSParseDateTime() function, the LSDateFormat() function uses 'yyyy-mmm-dd' as a default format mask for locales with a date format starting with the year. (23544)
- ColdFusion Server returns the correct error message for an attribute set validation error in the
cfregistry
tag. (23574)
- StructGet() handles structures specified using the alternate (array-style) syntax. (21844)
- When the
cfdirectory
attribute FILTER string name is longer than 259 characters, ColdFusion Server no longer returns an "unknown exception condition". (17023)
- NumberFormat correctly rounds 16 digit integers. (16570)
- Using the tobase64 function no longer appends an equal sign ("=") to the end of the converted data string. (15233)
ColdFusion Reporting (including Crystal Reports)
- Hyperlinks in multiple page reports now work correctly. (21265)
CFML Tags
cffile
now supports uploading large files. (8601)
cfexecute
now translates quotation marks (") in arguments correctly. (25207)
cfhttp
preserves ampersands (&) in form fields. (24630)
- On Unix,
cfexecute
no longer creates defunct processes when run with a timeout set to 0
. (24392)
cfhttp
no longer adds an extra carriage return after the content length header when posting multi part form data. (24915)
- You can provide the referrer header in a
cfhttpparam
tag to override the default referrer provided by cfhttp
. (24291)
- Using the MAXROWS and STARTROW attributes together in the
cfldap
tag when ACTION=QUERY returns the correct results. (24209)
- CFHTTP.STATUSCODE now works on the Windows version of ColdFusion Server. (23463)
- Java byte value is treated as a numerical value, rather than a Boolean value. (23053)
- On Windows NT 4.0, the LIST action for the
cfdirectory
tag when sorting by filename on windows performs a case-insensitive sort and generates an error when the DIRECTORY attribute is empty. (22685)
- On Linux and Solaris, when
cfexecute
tries to execute something for which it doesn't have permissions, it no longer creates a core file but generates an error message. (22085)
cfhttp
no longer consumes a large percentage of system memory when performing GET operations on large files. In addition, after performing GET operations on large files, cfhttp
returns system memory resources back to the OS. (21646)
- When RESOLVEURL is enabled, ColdFusion Server no longer becomes unstable if the attribute value contains the attribute name. (21530)
cfftp
now generates an error if a CONNECTION attribute is invalid. (20988)
- On Linux and Solaris,
cfpop
no longer generates an error related to MIME attachments. (20899)
- On Unix,
cfmail
correctly calculates the time zone offset from GMT. (20656)
cfhttp
accepts port numbers in the URL attribute. It also follows redirections correctly when the URL contains a port number. Note that a port number in the URL overrides the port tag attribute. (19931)
- When using
cfgrid
controls, Netscape 4.x browsers no longer cause ColdFusion Server to generate the "Error resolving parameter 'GridName'"
. (19907)
cfobject
no longer causes a Linux server to become unstable. (19854)
- On Unix,
cfexecute
no longer times out immediately if the timeout attribute is set to 0
. (19321)
cfexecute
generates accurate error messages related to waitpid(). (19321)
cfexecute
unlocks all files after it finishes operations. (19123)
cfhttp
follows up to five redirections on a single request. cfhttp
also handles location redirection headers that do not conform to RFC 2616. (18559)
cfscript
FOR loops no longer cause the server to become unstable. (17980)
cfpop
retrieves the contents of the reply to field in emails and populates the replyto variable. (17867)
cfpop
retrieves e-mail attachments. (17865)
- Whitespace suppression operates within parameters set in ENABLECFOUTPUTONLY. (17794)
cfreport
works with Crystal Reports 8.5. (17468)
- INIT method returns a copy of the ColdFusion Java object. Internally, both objects point to the same Java object. (17187)
- On Windows,
cffile
no longer converts spaces in file names to underscores. (17127)
cfform
controls no longer malfunctions when adding rows. (14898)
Coding
- ColdFusion Server no longer crashes when validating data in form fields using the _range suffix, if both a min value and a max value are not specified. (23951)
DB - Native (DB2)
- DB2 client variable support is functional. (20559)
- DB2 client table creation now operates successfully.(20547)
DB - Native (General)
- Passing null and a CLOB value in the same query no longer results in the CLOB being set to null. (23555)
DB - Native (Informix 7)
- A native Informix data source can be used for client variable storage. (16967)
DB - Native (Oracle 7.3)
- Oracle 7.3 Native Driver using 7.3.4 client libraries against a 7.3.4 database correctly produces an error when using to_char(to_date) function. (18147)
DB - Native (Oracle 8.0)
- The number of connections shown at the database server no longer exceeds
the number of simultaneous connections configured in ColdFusion
Administrator for the data source. (22790)
- When using the Oracle 8 native driver and REFERENCE CURSOR in a Stored Procedure, if you include a maxrows parameter in the
cfprocpram
that calls the stored procedure, ColdFusion Server no longer maximizes CPU processing causing the system to become unresponsive. (19312)
- When a ref cursor returns a null from a stored procedure, it no longer causes
ColdFusion to stop responding to requests. (21510)
- The problem with
cfstoredproc
writing large amount of data into an Oracle table
with a field defined as varchar2(4000) has been resolved. (19818)
DB - Native (Sybase System 11)
- When using Sybase native connections and retrieving money field data on Solaris, the returned unformatted data no longer has an inconsistent format after the decimal. (19668)
DB - ODBC (General)
- When a data source fails to verify in the ColdFusion Administrator, you can no longer connect to the data source via Macromedia UltraDev. (25039)
- Merant's Sybase ODBC driver on Linux no longer causes ColdFusion to core and throw errors in server.log under a small load. (21656)
- Retrieval of long text (>65K) no longer fails with Oracle ODBC (Merant and Oracle). (20366)
- Disable database connection in CF administrator now works as described. (18806)
- On Linux, the Microsoft SQL Server driver has been updated to fix a problem with the 'money' and 'smallmoney' data types. (17792)
DB - OLE DB (General)
- Installing ColdFusion will no longer cause problems with existing OLE DB data sources. (20984)
Exception Handling
- CFTHROW TYPE="Application" and CFCATCH may now be used in the calling page without failing to catch this error type. (16842)
- For
cfthrow
/cfcatch
combinations using custom exception types, the TYPE value is case insensitive and will correctly catch partial matches against a user defined exception that is thrown. (15185)
General Server
cfmail
will no longer leak file handles when connecting to a mail server which does not respond. (24728)
- The problem with the NumberFormat function where numbers with a scale of 3 decimal places do not round up when between 1.000 and 2.000 and ending in 5 has been fixed. (24271)
- On Unix, ColdFusion Server correctly caches files with path names that are identical except for case. (20034)
- Client variable operations will no longer fail if additional columns are present in either the CGLOBAL or CDATA tables when using a database as the backend store. (17855)
- When uploading a large file via a form page, the memory footprint of ColdFusion Server no longer grows 3 to 5 times as large, and on subsequent uploads of the same file, the memory footprint no longer further increases. (16899)
Installation and Configuration
- In Solaris, the ColdFusion Server installation no longer causes superuser permissions errors. (17847)
- The ColdFusion Server installation no longer allows you to install only Advanced Security. (16600)
- The ColdFusion Server installation no longer corrupts existing MDAC installations. (15561)
LDAP
- With
cfldap
, ColdFusion Server automatically maps illegal variable characters in resulting query columns to underscore characters. Therefore, column names of the query result set returned by cfldap
might not match the names of the LDAP attributes. (24348)
- The SORTCONTROL attribute of the
cfldap
tag accepts the value desc
(or dsc
) as an option. (17403)
Performance
- Depending on your environment and applications, ColdFusion Server 5 now performs as well or better on Windows 2000 then Windows NT. (21399)
Scheduling
- ColdFusion Server now allows for the creation of a daily scheduled task specifying a start and end date. (23725)
Security
- ColdFusion Server now refreshes username and password policy stores automatically. (18959/17358)
- Deleting a rule after restarting ColdFusion Server and Advanced Security no longer produces an error message. (16187)
Server Side Scripting Language
- When using the duplicate function, an update to the copied structure or variable is no longer applied to the original structure or variable. (20833)
- CFScript no longer ignores a specified timeout value. (12123)
Verity Searching and Indexing
- Optimization no longer fails for non-English language collections. (16735)
WDDX
- The WDDX JS serializer no longer suffers from a performance problem with large WDDX packets. (22210)
Miscellaneous
cfmail
ensures that the body of a mail message terminates each line with a carriage return and a new line. This is to support certain Mail Transfer Agents, such a Qmail, which strictly enforce end of line characters. (23283)
- An improperly formatted file in the ColdFusion Server mail spool file no longer causes all spooled mail to remain in the spool file and never be sent. (21649)
back to top
Known Issues
back to
top
CFML Language
back to
issues
ColdFusion Administrator
back to
issues
Database
back to
issues
Miscellaneous
- If an error is encountered while processing a page request, ColdFusion Server
now returns a 500 status code by default. This allows automated monitoring
services using HTTP probes to detect ColdFusion-generated errors. To change
this default behavior, add the registry entry key named
HKEY_LOCAL_MACHINE/SOFTWARE/Allaire/ColdFusion/CurrentVersion/HTTP
,
and give it a string value of EnableHTTPStatus
. Set its value
to 0
.
cfgraph
is not supported on Windows 98 in ColdFusion Server 5.
- The example applications installed with ColdFusion Server 5 require that "Full checking" not be set as the Variable Scope Lock Settings in the ColdFusion Administrator.
- To use ColdFusion Server in distributed mode in Solaris, Linux, and HP-UX, in opt/coldfusion/cfremote.ini, change the
MESSAGE
property value to NO
. After making this change, restart the Web server. For more information on configuring ColdFusion Server to run in distributed mode, see the corresponding PDF file in the \CFServer50\ColdFusionServer5\Documentation\PDF directory on the installation CD-ROM.
- ColdFusion requires the initialcontext class, home interface, remote interface,
and stub classes generated by the deployment on the client Java class path.
- Before using the Verity command-line tools, such as the "mkvdk" and "VSpider"
utilities, the appropriate Verity library paths must be added to the PATH
(Windows), LD_LIBRARY_PATH (Solaris and Linux) or SHLIB_PATH (HPUX) environment
variable.
- On Windows, add "C:\CFusion\Verity\_nti40\bin" to the "System"
PATH environment variable (substitute the installation directory for
"C:\CFusion")
- On Solaris, a symbolic link must first be created in the /opt/coldfusion/verity
directory by entering "ln -s _ssol26 _solaris", then add "/opt/coldfusion/verity/_solaris/bin"
to the LD_LIBRARY_PATH.
- On Linux, add "/opt/coldfusion/verity/_ilnx21/bin" to the LD_LIBRARY_PATH
- On HP-UX, add "/opt/coldfusion/verity/_hpux11/bin" to the SHLIB_PATH.
- Only a single probe should be configured to restart the ColdFusion Server; if
multiple probes are configured for restart, the ColdFusion Server may terminate
abnormally and not restart. The probe selected to restart the ColdFusion
Server must be directed at a local URL, or the probe will not correctly detect
a server failure. In general, probing remote URLs is not recommended.
- To use a licensed full version of Macromedia Generator for ColdFusion
Server's
cfgraph
functionality, follow these steps:
- Install Macromedia Generator.
- To determine which port Generator uses to listen for incoming requests,
open the local.properties file in the <generator-install-dir>/jrun/servers/default
directory. Look for the line that contains jcp.endpoint.main.port. This
value is the port number.
- Add a ColdFusion registry string named:
HKEY_LOCAL_MACHINE/SOFTWARE/Allaire/ColdFusion/CurrentVersion/Graphing/JRunPort
,
and set the value to the port number from Step 2.
- Copy the AllaireGraphingServlet.class and QueryStringHolder.class files
from <CFHOME>/JRun/servlets to <generator-install-dir>/jse/servlets.
- Restart the JRun Default Server.
- When using IIS security, enabling the MIB agent to work properly requires anonymous file access be given
to getmetricdataXML.cfm and serverinfo.cfm.
These files are located in the <docroot>\cfide\mib\ directory.
- For CORBA support, ColdFusion Server includes VisiBroker 3.3 (3.3.3.C4.06)
Orb for Windows NT 4.0 and HP-UX 11. The ColdFusion Server documentation incorrectly states
VisiBroker 3.3.
- On Solaris, Linux, and HP-UX systems, the examples in the Developing
ColdFusion Applications book do not function correctly with the supplied dBASE-format
CompanyInfo database. These examples function correctly with the Access database
that is shipped with the ColdFusion Windows editions.
- A limited set of Verity International Language support is included in ColdFusion
Server 5.
- To configure ColdFusion Server to operate in distributed mode:
- When the configuration includes a Windows server frontend, the NT drive
letters in the remote.ini file must be capitalized to work.
back to
issues
Copyright © 2001, Macromedia All rights reserved.