When you have installed LuciadFusion, the target folder contains at least these subfolders and files:

• build tools for building and deploying samples
• docs API reference documentation, and developer's and user's guides in PDF format
• lib libraries required to run LuciadFusion and its components
• licenses intended for the storage of your product license files
• samples sample source code and resources

More folders may be available.

Install your product license

To run LuciadFusion, you need a license file. The license file is provided to you by Luciad's Customer Services department.

If your license files have not been installed automatically, they can still be put in place manually:

• If the license file comes in a zip file, unzip the zip file to a temporary directory.
• Copy the development.jar file from the temporary directory to the licenses directory.
  You only need the deployment.jar file when you are deploying the application.
• If your license requires a license server, ask your system administrator to install the license server.
• If you have received hardware keys (iButtons), install the keys following the installation instructions.

To verify that the license file is properly installed, try running one of the decoder samples. Refer to the Troubleshooting section of the technical notes if the sample does not work.

Explore LuciadFusion Studio

The LuciadFusion Studio is a web application that allows you to manage your geospatial data centrally, and publish it on web services for distribution to the consumers of your data. The LuciadFusion Studio as well as the web services will be hosted on the LuciadFusion Platform. To try out the LuciadFusion Studio and Platform, you need to start up the LuciadFusion Server, and log in:

1. Start the LuciadFusion Platform. Click Fusion Server on the LuciadFusion launcher (start.jar), or run the FusionServer script in the LuciadFusion installation directory. It might take a while before the LuciadFusionPlatform is fully up-and-running. You can monitor startup progress by right-clicking luciad.fusion.platform on the launcher, and opening the console.
2. Access LuciadFusion Studio. When the Fusion server is up-and-running on port 8081, your default internet browser opens at http://localhost:8081/studio/index.html.
3. Log in. On the Studio login screen, admin is both your user name and your password. Enter admin in both fields, and click Login.
4. Start exploring LuciadFusion Studio. On the LuciadFusion Studio welcome screen, you can choose to take a user tour around the application's main features, or to start adding data immediately.

Integrate LuciadFusion into your IDE

All samples are available with their source code and can be modified. To edit and compile the samples, it is recommended to use an IDE such as Eclipse, IntelliJ IDEA or Netbeans.

Before you can compile and run the samples from your IDE, you need to set up the IDE development project in a specific way.

Compiling the samples with an IDE

The source code of the samples is located in the samples/src directory. To compile the samples from the IDE, create a project for your IDE in the LuciadFusion installation directory. Make sure to complete these project setup steps:

Complete the classpath. Add the following jars and directories to the classpath:

• All jar files in the lib directory
• The development.jar file that you have installed in the licenses directory
• The resources directory, if available
• The samples/resources directory, if available

Exclude JARs from the classpath. Do not include any other jar files in the classpath. More specifically, never include the following files:

• Any jar file in the samples/lib directory or any of its subdirectories
• Any jar file in the build directory or any of its subdirectories
• Any jar file in the distrib directory or any of its subdirectories

Running the samples with an IDE

To run the samples from the IDE, define a sample run configuration:

Set the main class. You can run all sample classes that have valid main methods. Most of these classes are called MainPanel. If you have Lucy and want to run the samples with Lucy, you should specify com.luciad.lucy.TLcyMain as main class.

Set the VM options. Make sure to set the following VM options:

-Xmx750m
-Djava.net.useSystemProxies=true
-XX:+UseConcMarkSweepGC
-XX:+CMSParallelRemarkEnabled
-Dsun.awt.noerasebackground=true
-Dsun.java2d.opengl=false
-Dswing.aatext=true
-Dsun.java2d.noddraw=true
-Djava.library.path=

The -Xmx option defines the maximum amount of memory. You can adapt this setting to your needs. For more information on Java's memory settings, please take a look at Oracle's detailed guide. Setting sun.java2d.noddraw to true is a work-around for a known bug in Java. Logging is optional: refer to the LuciadFusion Developer's Guide for more information.

The java.library.path option defines the location of native libraries. It must be set to an empty string to prevent that a platform-dependent default value is used. That default value may refer to incompatible versions of native libraries on your system, and cause conflicts during library loading.

Product tiers

LuciadFusion is offered in three product tiers: Essential, Advanced and Pro. Each product tier combines capabilities and optional capabilities that are designed for typical use cases. See Product tiers for more information.