Contents |
To compile an application, Flash Builder and mxmlc reference the SWC library files that ship with the Flex SDK in subdirectories of the frameworks directory. In Flash Builder, the frameworks directories for different Flex SDK versions are in the install_root/sdks/sdk_version directory.
LiveCycle Data Services ships the following additional sets of SWC files. Reference the set of SWC files that matches the Flex SDK you compile against.
To add the LiveCycle Data Services SWC files to the Flash Builder or mxmlc library path, copy the subdirectories of the install_root/resources/lcds_swcs/FlexSDK4/frameworks directory or the install_root/resources/lcds_swcs/FlexSDK3/frameworks directory to the corresponding Flex SDK frameworks directory.
Note: Flex 3.5 compatible SWC files are also available in the WEB-INF/flex/libs directory of a LiveCycle Data Services web application. By default, Flash Builder adds these files to the library-path of a project that uses LiveCycle Data Services. However, the Flex 4 compatible versions of these files are not available in that location. Add them manually from the install_root/resources/lcds_swcs/FlexSDK4/frameworks directory.
The Modeler, also known as the application modeling plug-in, is a tool for creating and editing Adobe application modeling technology models. The Modeler is available on the adobe.com site. It consists of a set of Eclipse plug-ins in the Adobe_Application_Modeling_plugin_v102_eclipse35.zip file that you install into a stand-alone Flash Builder installation or an Eclipse installation that contains the Flash Builder plug-in installation.
You must have an installation of the released version of Flash Builder 4 before installing the Modeler. There are three installation options for Flash Builder:
See "Model-driven applications" in Using LiveCycle Data Services for information on configuring and using application modeling. Visit these links to get an overview of model-driven development and its relationship to other features of LiveCycle Data Services and rich Internet application development in general:
The Edge Server is a standard LiveCycle Data Services server specially configured and deployed in an organization’s demilitarized zone (DMZ), which is the subnetwork that contains and exposes an organization's external services to the Internet. The installation process for the Edge Server is identical to the installation process for a LiveCycle Data Services server in the application tier. The only difference is that the Edge Server is installed in the DMZ and configured to use a gateway service that communicates with a gateway endpoint on the LiveCycle Data Services server in the application tier. For information about configuring and using the Edge Server, see "Edge Server" in Using LiveCycle Data Services.
Adobe® LiveCycle® Data Services runs as a J2EE web application. You can install LiveCycle Data Services in the secure application tier of your network environment or as an Edge Server in the Demilitarized Zone (DMZ). Installation for LiveCycle Data Services in the secure application tier and installation of the Edge Server are identical. To enable Edge Server functionality, configure the server as described in Using LiveCycle Data Services. LiveCycle Data Services is available on the adobe.com site.
The installer lets you choose from the following configurations:
LiveCycle Data Services offers installers for the following platforms.
See the list of supported platforms for LiveCycle Data Services 3.1 for officially supported operating system versions, application servers, and JDKs.
The installers include the following Web Application Archive (WAR) files:
Each WAR file is a separate, stand-alone web application. If you are using the J2EE web applications configuration, you must have an existing J2EE application server or servlet container available and understand web application deployment. If you do not have an existing J2EE server or are not familiar with WAR file deployment, use the integrated Tomcat configuration to get started.
These installation instructions refer to the root directory where you installed LiveCycle Data Services as install_root.
The LiveCycle Data Services with integrated Tomcat installation option contains the following files and directories under the installation root:
| readme.htm | Contains overview information. | |
| lcds.war | LiveCycle Data Services web application template, used as a starting point for new applications. | |
| lcds-samples.war | LiveCycle Data Services sample applications. | |
| ds-console.war | Simple monitoring application for LiveCycle Data Services deployments. | |
| license.txt | License information. | |
| /tomcat | Contains an installation of Apache Tomcat that includes lcds, lcds-samples, and console web applications expanded and deployed in the default server. | |
| /resources | Fully commented configuration files, and directories and files used for security, clustering, Flex Ajax Bridge, and WSRP. | |
| /sampledb | Contains an HSQLDB database used by the sample applications. |
Install LiveCycle Data Services in the integrated Tomcat configuration
./lcds3-lin.binfor Solaris:
./lcds3-sol.bin
Note: You can upgrade to a fully functioning version by entering a serial number in the fds line of the lcds-webapp-root/WEB-INF/flex/license.properties file for each LiveCycle Data Services web application. Then restart the server.
On Microsoft Windows, you can start LiveCycle Data Services from the Start menu, or navigate to the install_root/tomcat/bin in Windows Explorer and double-click the startup.bat icon.
On UNIX and Linux, enter the command: ./catalina.sh run.
When you install LiveCycle Data Services, the installer creates the lcds-samples web application that contains sample applications, including the 30 Minute Test Drive application. The sample applications demonstrate basic capabilities and best practices for developing LiveCycle Data Services applications.
The LiveCycle Data Services J2EE web application configuration option installs the following files and directories under the installation root:
| readme.htm | Contains overview information. | |
| lcds.war | LiveCycle Data Services web application, used as a starting point for new applications. | |
| lcds-samples.war | LiveCycle Data Services sample applications. | |
| ds-console.war | Simple monitoring application for LiveCycle Data Services deployments. | |
| license.txt | license information. | |
| /resources | Fully commented configuration files, as well as directories and files used for security, clustering, Flex Ajax Bridge, and WSRP. | |
| /sampledb | Contains an HSQLDB database that the sample applications use. |
Install LiveCycle Data Services web applications
./lcds3-lin.bin
for Solaris:
./lcds3-sol.bin
Note: You can upgrade to a fully functioning version by entering a serial number in the fds line of the lcds-webapp-root/WEB-INF/flex/license.properties file for each LiveCycle Data Services web application. Then restart the server.
Notes: To use the model-driven development
features, you must deploy the web applications as expanded directories
rather than WAR files. For production, you can package web
applications in compressed WAR files.
Many samples applications in lcds-samples web application require
that you deploy the web application as an expanded directory structure.
When you deploy the lcds-samples web application, make sure that you
specify "lcds-samples" as the context-root.
Install LiveCycle Data Services as a J2EE web application by using the Java installer (any platform)
[java_home]/bin/java -jar lcds3-install.jar -i console
When you install LiveCycle Data Services, the installer creates the lcds-samples web application that contains sample applications, including the 30 Minute Test Drive application. The sample applications demonstrate basic capabilities and best practices for developing LiveCycle Data Services applications.
There are additional configuration steps for the following application servers:
To use LiveCycle Data Services with Tomcat when not using the integrated Tomcat configuration, install support for the Java Transaction API (JTA). You might also have to install several other libraries depending on the features that you plan to use. Follow these steps after deploying the LiveCycle Data Services WAR files. These steps are not necessary for the integrated Tomcat installation.
<CONTEXT antijarlocking="false" antiresourcelocking="false" docbase="${catalina.home}/webapps/lcds-samples" path="/lcds-samples" privileged="true"> <TRANSACTION factory="org.objectweb.jotm.UserTransactionFactory" jotm.timeout="60"></TRANSACTION></CONTEXT>
Note: If a context file exists for your web application, add the <TRANSACTION> element under the <CONTEXT> element. <VALVE classname="flex.messaging.security.TomcatValve"></VALVE> You can now perform authentication against the current Tomcat realm. Usually, the default configuration for authentication stores user information in conf/tomcat-users.xml. See the Tomcat documentation for more information on realms. See the LiveCycle Data Services documentation for more information on custom authentication.
<LOGIN-COMMAND>
in /WEB-INF/flex/services-config.xml in each deployment of a LiveCycle
Data Services WAR file. For Tomcat, ensure that the TomcatLoginCommand
is active in the <SECURITY>section:
<SECURITY><LOGIN-COMMAND server="Tomcat"></LOGIN-COMMAND>...</SECURITY>
These instructions create a configuration that matches what is distributed with LiveCycle Data Services. You can integrate Apache ActiveMQ 4.1.1 with earlier versions of Tomcat. You can integrate newer versions of ActiveMQ with Tomcat 6.0.x, but none of these configurations have been tested. These instructions require that you have a valid Apache Ant installation.
ant war
${catalina.home}/lib/activemq4.1.1/*.jar
<CONTEXT-PARAM> <PARAM-NAME>brokerURI</PARAM-NAME> <PARAM-VALUE>/WEB-INF/activemq.xml</PARAM-VALUE> </CONTEXT-PARAM> <LISTENER> <LISTENER-CLASS>org.apache.activemq.web.SpringBrokerContextListener</LISTENER-CLASS> </LISTENER>
<BEANS> <BROKER brokername="myBroker" persistent="false" usejmx="true" xmlns="http://activemq.org/config/1.0"> <TRANSPORTCONNECTORS> <TRANSPORTCONNECTOR name="default" uri="tcp://localhost:61716"> </TRANSPORTCONNECTOR> </TRANSPORTCONNECTORS></BROKER> </BEANS>
This configuration starts an ActiveMQ message broker with a broker name of myBroker listening for requests on the localhost network interface at port 61716.
<CONTEXT antijarlocking="false" antiresourcelocking="false" privileged="true" reloadable="true"> <RESOURCE brokername="myBroker" brokerurl="tcp://localhost:61716" description="JMS Connection Factory" factory="org.apache.activemq.jndi.JNDIReferenceFactory" name="jms/flex/TopicConnectionFactory" type="org.apache.activemq.ActiveMQConnectionFactory"> </RESOURCE> <RESOURCE description="my Topic" factory="org.apache.activemq.jndi.JNDIReferenceFactory" name="jms/topic /flex/simpletopic" physicalname="FlexTopic" type="org.apache.activemq.command.ActiveMQTopic"> </RESOURCE> <RESOURCE brokername="myBroker" brokerurl="tcp://localhost:61716" description="JMS Connection Factory" factory="org.apache.activemq.jndi.JNDIReferenceFactory" name="jms/flex/QueueConnectionFactory" type="org.apache.activemq.ActiveMQConnectionFactory"> </RESOURCE> <RESOURCE description="my Queue" factory="org.apache.activemq.jndi.JNDIReferenceFactory" name="jms/queue/flex/simplequeue" physicalname="FlexQueue" type="org.apache.activemq.command.ActiveMQQueue"> </RESOURCE> <VALVE classname="flex.messaging.security.TomcatValve"></VALVE> </CONTEXT>
There is a known Hibernate 3 integration issue for most WebLogic versions. The LiveCycle Data Services model-driven development and Hibernate assembler features use Hibernate. The easiest solution is to put the antlr JAR file shipped with LiveCycle Data Services in the WebLogic bootstrap class path. The antlr JAR file is in the WEB-INF/lib directory of the LiveCycle Data Services web applications.
LiveCycle Data Services includes a WebSphere-specific implementation of the RTMP server. This version uses threads created by WebSphere.
Configure LiveCycle Data Services for use with WebSphere
jar -xvf [lcds].war
<RESOURCE-REF> <DESCRIPTION>Flex Messaging WorkManager</DESCRIPTION> <RES-REF-NAME>wm/MessagingWorkManager</RES-REF-NAME> <RES-TYPE>com.ibm.websphere.asynchbeans.WorkManager</RES-TYPE> <RES-AUTH>Container</RES-AUTH> <RES-SHARING-SCOPE>Shareable</RES-SHARING-SCOPE> </RESOURCE-REF>
<CHANNEL-DEFINITION id="my-rtmp"><ENDPOINT url="http://{server.name}:2038/">
</ENDPOINT>
<PROPERTIES>
...
<WEBSPHERE-WORKMANAGER-JNDI-NAME>
java:comp/env/wm/MessagingWorkManager
</WEBSPHERE-WORKMANAGER-JNDI-NAME>
...
</PROPERTIES>
</CHANNEL-DEFINITION>
<USE-TRANSACTIONS>false</USE-TRANSACTIONS> for the data service destination in the /WEB-INF/flex/data-management-config.xml file.<SERVERS> section:
<SERVERS> <SERVER id="data-nio-server"> <PROPERTIES> <BIND-PORT>12080</BIND-PORT> <WEBSPHERE-WORKMANAGER-JNDI-NAME> java:comp/env/wm/MessagingWorkManager </WEBSPHERE-WORKMANAGER-JNDI-NAME> </PROPERTIES> </SERVER> <SERVER id="data-nio-secure-server"> <PROPERTIES> <BIND-PORT>2051</BIND-PORT> <WEBSPHERE-WORKMANAGER-JNDI-NAME> java:comp/env/wm/MessagingWorkManager </WEBSPHERE-WORKMANAGER-JNDI-NAME> <KEYSTORE-PASSWORD>changeit</KEYSTORE-PASSWORD> </PROPERTIES> </SERVER> </SERVERS>
jar -cvf [lcds].war *
<SECURITY> section under the
RuntimeManagement destination in the services-config.xml file for the
ds-console web application. The file contains comments instructing
users to do this when running on WebSphere with administrative security
enabled.<SECURITY-CONSTRAINT> section under <SECURITY>
in the services-config.xml file for the ds-console web application.
The file has comments instructing users to do this when running on
WebSphere with administrative security enabled.JBoss web application deployment
JBoss 4 authentication
(Optional) This configuration provides custom authentication against the current JBoss realm. Usually, the default location for this authentication stores user information in jboss_root/server/default/conf/users.properties and roles information in jboss_root/server/default/conf/roles.properties. For more information on realms, see the JBoss documentation. For more information on LiveCycle Data Services custom authentication, see the LiveCycle Data Services documentation and information in the install_root/resources/security directory.
<VALVE classname="flex.messaging.security.TomcatValve"></VALVE>You will now be authenticated against the current JBoss realm.
JBoss 5 authentication
This configuration provides custom authentication against the current JBoss realm:
<VALVE classname="flex.messaging.security.TomcatValve"></VALVE>
<xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role rolename="tomcat"/>
<role rolename="role1"/>
<user username="tomcat" password="tomcat" roles="tomcat"/>
<user username="both" password="tomcat" roles="tomcat,role1"/>
<user username="role1" password="tomcat" roles="role1"/>
</tomcat-users>
<Realm className="org.apache.catalina.realm.MemoryRealm" pathname="../server/default/conf/tomcat-users.xml"/>Note: Many samples applications in lcds-samples.war file do not function within a compressed web application. Therefore, it is advised that you deploy the lcds-samples web application as an expanded directory structure. If you uncompress a WAR file into a subdirectory that you create, that subdirectory must match the name of the prefix of the WAR file. That directory is also the context root of the web application. To use the model-driven development features, you must deploy the web applications as expanded directories rather than WAR files; For production, you can package web applications in compressed WAR files.
Once you have installed LiveCycle Data Services, see "Getting Started with LiveCycle Data Services" in Using LiveCycle Data Services for a quick introduction to features and practical information about building and deploying applications.