Installing LiveCycle Data Services Manually
To be able to use LiveCycle Data Services ES 2.6.1 with
ColdFusion 9, you need to manually install it, after completing
your ColdFusion installation. To install LiveCycle Data Services,
a .zip file is provided.
Note: The following instructions use the term “lcds_install_root”
to refer to the installation home directory for LiveCycle Data Services
ES 2.6.1.
Before you start the installation process:
Shut down your ColdFusion 9 server if its running.
Copy the ColdFusion9/lib/flex-messaging*.jar files to a backup
location. If you are running a multiserver instance or a J2EE installation,
these files are in the WEB-INF/cfusion/lib directory.
Copy the lcds_install_root/resources/lib/flex-messaging*.jar
files and overwrite them into the ColdFusion /lib directory.
Retain a backup of your old services-config.xml, data-management-config.xml,
to refer to your old channels and destinations.
After extracting LCDS2.6.1_for_CF9.zip file, copy services-config.xml,
flex-sdk-description.xml, and data-management-config.xml from LCDS2.6.1_for_CF9/WEB-INF/flex
directory to ColdFusion 9 WEB-INF/flex/.
Copy the following SWC libraries from LCDS2.6.1_for_CF9/WEB-INF/flex/libs to
the ColdFusion 9 directory:
/WEB-INF/flex/libs/fds.swc
file to the /WEB-INF/flex/libs directory
/WEB-INF/flex/libs/player/playerfds.swc file to the /WEB-INF/flex/libs/player/
directory
/WEB-INF/flex/locale/en_US/fds_rb.swc file over the /WEB-INF/flex/locale/en_US/
directory
Copy cfdataservicesadapter.jar from LCDS2.6.1_for_CF9/WEB-INF/flex/jars
to ColdFusion WEB-INF/flex/jars.
If your LiveCycle Data Services applications use RTMP channel,
open the ColdFusion WEB-INF/flex/services-config.xml file and uncomment
"cf-rtmp" channel. By default it is commented.
Set the value for <use-mappings> to true,
if it is not already set and create a mapping for your application
folder.
If your old Channel had the <instantiate-types> present
under <serialization> xml tag, then either remove <instantiate-types>,
or set it to true. ColdFusion now has its own custom serializer
and deserializer, so the instantiate-types needs to be true.
Also,
set the <enable-small-messages> flag to false.
Either
of the following samples of the serialization constructs is expected
at channel level.
Sample 1:
<serialization>
<instantiate-types>true</instantiate-types>
<enable-small-messages>false</enable-small-messages>
</serialization>
Sample 2:
<serialization>
<enable-small-messages>false</enable-small-messages>
</serialization>
Add your data management destinations from the old file to
the new data-management-config.xml file. In ColdFusion 9 release,
there are few changes in the destination and channel structure due
to changes in the serialization process.
The following properties
have been moved from destination to channel level.
You need to move these properties under <channel-definition> > <properites> > <coldfusion> from
your destination level in your data-management-config.xml file:
<access>
<use-mappings>
<method-access-level>
</access>
<use-accessors>
<use-implicit-accessors>
<use-structs>
<property-case>
<force-cfc-lowercase>
<force-query-lowercase>
<force-struct-lowercase>
</property-case>
For details, see Changes
in the XML configuration files for Flash Remoting in ColdFusion
9 in Developing ColdFusion Applications.
Start ColdFusion server.