Installing Loftware DaVinci

Loftware DaVinci is a web application used to compare images. You can use DaVinci within Label Design Label Design to compare PNG format images of label templates or different versions of the same label template.

Spectrum is delivered with a DaVinci package that can be deployed on your web server alongside Spectrum. Configuration is required, and you will have to restart the Loftware Spectrum service after making changes to configuration files.

The installation package is available from the downloads folder of your Spectrum Application Server at the following URL:

http://[hostname]:[port]/downloads/DaVinciPackage.zip

Deploy and Configure the Loftware DaVinci Application

To use Loftware DaVinci within Label Design Label Design or in your own application, use this procedure to install and configure the web application on the Spectrum application.

  1. Download or copy the DaVinciPackage.zip installation package to the Spectrum Application Server.
  2. On the Spectrum Application Server, unzip the DaVinciPackage.zip installation package. Recommended location: <SPECTRUM_HOME>\DaVinci

    3. Note: <SPECTRUM_HOME> represents the folder on the Spectrum Application Server in which the Spectrum application is installed. For example, in Windows Server this might be C:\Loftware\Spectrum\Spectrum, and in Linux this might be /opt/loftware/spectrum/Spectrum. Although procedures in this documentation typically use backslashes in operating system paths, you should use forward slashes if required by your operating system.

  3. Navigate to the folder where you extracted the installation package.

    Example

    <SPECTRUM_HOME>\DaVinci

  4. Copy the davinciHtml5.war and dvserver.war files in the folder into the <SPECTRUM_HOME>\product\webapps folder on the Spectrum Application Server.

    Note: This folder also contains loftwareserver.war and spectrum-server.war. A davinciHtml5 and dvserver folder will be created under the webapps folder after copying the files into the folder.

  5. Navigate to the DaVinci folder and unzip the dvserver-configure.zip package.

    Example

    <SPECTRUM_HOME>\DaVinci\dvserver-configure

  6. Navigate to location you extracted the dvserver-configure package.
  7. Copy the following files in the folder into the <SPECTRUM_HOME>\product\conf folder on the Spectrum Application Server.
    • database.properties
    • dvConfig.properties
    • standalone.properties
  8. Navigate to the DaVinci folder and unzip the davinciHtml5-configure.zip file.
  9. Navigate to the location you extracted the davinciHtml5-configure.zip package.
  10. Copy the following files in the folder into the <SPECTRUM_HOME>\product\conf folder on the Spectrum Application Server.
    • config.properties
    • configuration.xml
  11. Create a DVStore location.

    Example

    C:\DVStore

  12. Create a slice store location in Tomcat's <SPECTRUM_HOME>\product\webapps\ROOT folder.

    Example

    C:\Loftware\Spectrum\Spectrum\product\webapps\ROOT\sliceStorage

    Note: The slice storage location must be within Tomcat's ROOT folder.

  13. Open the standalone.properties file in a text editor and do the following.
    1. Modify the following properties:
      • isStandalone: Set to true

        Important! Do not add anything else on the isStandalone line, including comments.

      • dvstore: The location you created for the DVStore location

        Example

        If your location is C:\DVStore, enter dvstore=C:\\DVStore.

      • sliceProtocol: http
      • slicePort: 8080 or the same as Tomcat
      • sliceHost: The application server's IP address or hostname

        Important! Do not use localhost or 127.0.0.1 for this setting.

      • sliceFolder: The path to the slices from <SPECTRUM_HOME>/product/webapps/ROOT. Default is “/sliceStorage”
    2. Save and close the standalone.properties file.
  14. Open the database.properties file in a text editor and do the following.
    1. Uncomment either the Oracle or PostgreSQL section, depending on where you installed LoftStore. Make sure all properties in the other section are commented out.
    2. Modify the following properties for your environment.

      LoftStore in an Oracle database

      • database.type: PLSQL
      • database.driverClassName: oracle.jdbc.driver.OracleDriver
      • database.url: jdbc:oracle:thin:@[host]:[port]:[SID] or
        jdbc:oracle:thin:@//[host]:[port]/[serviceName]
      • database.username: LOFTDVUSER
      • database.password: Set during the LoftStore installation. This must be prefixed by either "(encrypt)" or "(clear)" depending on whether the password is in clear text or is encrypted.

        Example

        database.password=(encrypt)examplepassword
        or
        database.password=(clear)examplepassword

      • database.schema: LOFTDV

      LoftStore in a PostgreSQL database

      • database.type: POSTGRES
      • database.driverClassName: org.postgresql.Driver
      • database.url: postgresql
      • database.username: LOFTDVUSER
      • database.password: Set during the LoftStore installation. This must be prefixed by either "(encrypt)" or "(clear)" depending on whether the password is in clear text or is encrypted.

        Example

        database.password=(encrypt)examplepassword
        or
        database.password=(clear)examplepassword

      • database.schema: LOFTDV

      3. Note: Your database administrator can change the database password for LOFTDVUSER if needed. After changing the password in the database, see Update the Loftware DaVinci Password for information on updating the password on the Spectrum Application Server.

    3. Comment out the lines in the section titled FOR MS SQL SERVER.
    4. Save and close the database.properties file.
  15. If the value of database.password in the database.properties file is encrypted, you must also do the following. If your password is not encrypted, skip this step.
    1. Open the jdbc.properties file in a text editor.
    2. Comment out the com.loftware.schema.davinci.user.password property.

      Example

      #com.loftware.schema.davinci.user.password

    3. Save and close the jdbc.properties file.
  16.  Open the dvConfig.properties file in a text editor do the following.
    1. Modify the following properties:
      • initAntiClickJackingUri: IP address or hostname of the DaVinci system with http protocol and port

        Example

        initAntiClickJackingUri=http://localhost:8080

      • dvClientDomainName: IP address or hostname of the DaVinci system

        Example

        dvClientDomainName=myhost.loftwareinc.com

    2. Save and close the dvConfig.properties file.
  17. Open the config.properties file in a text editor and do the following.
    1. Modify the following properties:
      • initAntiClickJackingUri: IP address or hostname of the DaVinci system with http protocol and port

        Example

        initAntiClickJackingUri=http://localhost:8080

    2. Save and close the config.properties file.
  18. Open the configuration.xml file in a text editor do the following.
    1. Change the “0.0.0.0” portion of the URLs to the IP address or hostname of the DaVinci system in each location within the file. Confirm the port matches the Tomcat port.

      Important! Do not use localhost or 127.0.0.1 for this setting, even if using the local server.

      • dvServerURL
      • dvServerIPURL
      • dvCallClientUrl
      • dvCallCompareUrl
    2. Save and close the configuration.xml file.
  19. Restart the Loftware Spectrum service.

Next Step

After deploying the Loftware DaVinci web application, you'll need to Configure Loftware DaVinci in Label Design or see the Spectrum User Guide (Help) for information on how to create a label comparison application. If you are configuring a distributed Spectrum environment, see Installing DaVinci for Distributed Services.