WOODWING ELVIS CONNECTOR3.5 CACHE MANAGEMENT The Elvis connector does not include a specific cache...

1

WOODWING ELVIS CONNECTOR DIGITAL EXPERIENCE MANAGER 7.1.2


© 2002 – 2016 Jahia Solutions Group SA / 16

SUMMARY

1 PREREQUISITIES ................................................................................................................................... 3

2 INSTALLATION ...................................................................................................................................... 4

3 CONNECTION SETUP .......................................................................................................................... 6

3.1 Typical setup ............................................................................................................. 6

3.2 Use preview for images and videos? ................................................................... 8

3.3 Write asset usage in Elvis? ................................................................................. 10

3.4 Mount point target ............................................................................................... 11

3.5 Cache management .............................................................................................. 12

4 FEATURES ............................................................................................................................................ 14

4.1 Search, read and use of a file ............................................................................. 14

4.2 User Rights management .................................................................................... 14

5 LIMITATIONS ...................................................................................................................................... 15

5.1 Number of browsed files .................................................................................... 15

5.2 file online display .................................................................................................. 15

5.3 File creation or modification .............................................................................. 16

5.4 File preview ............................................................................................................ 16



1 PREREQUISITIES

NOTE:

The Jahia Elvis Connector needs a specific table to be created within your database before its installation. Please refer to the Write Asset Usage section of the document.

- The Jahia Elvis connector is compatible with Woodwing Elvis version 5

- The Jahia Elvis connector is designed to work with DX 7.1.0.1 and newer versions

- DF Module - External data provider V3.0.1

- Please follow installation instructions in the READ ME file distributed with the connector



2 INSTALLATION Install and configure the Elvis Connector in DX. If the jar file is not readily available, this module

can be found on the Jahia AppStore, with a search on the Module Administration user interface

or on the customer extranet section of Jahia.com.

Deploy the module through the Module Administration user interface, or copy the jar file in the

digital-factory-data/modules folder.

Once deployed, the Elvis connector needs to be enabled for one or more websites created and

managed with DX. Click on the “Detail” button to access the configuration panel of the module.



Then enable the module for the website(s) you want it to function with.



3 CONNECTION SETUP 3.1 TYPICAL SETUP Open the DX Server Administration and go to System Components / Mount points.

Add a new point, select mount point

Four types of mount points to a remote server are available:

• Remote Digital Experience Manager Mount Point: connect to directories on other DX

machines so that they can be used as if they were all part of the user's file system.

• CMIS mount point: This is the default CMIS connector to any CMIS server. All users will

share the same connection.

• VFS mount point: connection to a Virtual File System.



• Elvis Provider Mount Point: this connector is only for Elvis DAM, allowing the connection

to the remote server as the current user.

Select “Elvis Provider Mount Point” then click on “+ Add”.

Fill in the form to set up the mount point

• Mount point name: this is the folder name of the mount point. This name will be part of

the path of the external content.



• User name: Elvis admin user used to generate ticket and browse the repository as system.

• Password: password of the admin user

• API URL: Server address.

• Number of files to return: Maximum number of Elvis DAM browsed files

3.2 USE PREVIEW FOR IMAGES AND VIDEOS? The Elvis connector includes an image and video preview to help the user to select the relevant

content.

Click on the “Use preview for images and videos” checkbox. A new area appears that allows to

configure the preview settings.

If the defaults settings are not convenient, click on “add preview setting” button. A pop-up will

appear to configure the desired preview.



First select the file type that will be targeted by the preview.



Then give a preview name, that will be added to the filename to the created file preview name.

Then select a max width and height and click on add.

The operation can be renewed to create all different necessary file previews.

DX is now able to ask the Elvis DAM to generate the desired preview when needed.

3.3 WRITE ASSET USAGE IN ELVIS? If this feature is activated, the Elvis connector will add information to an elvis-stored asset about

its publication through Jahia DX.

NOTE:

Before this feature is activated, a specific table must be created and set within DX database to store the relevant data.

You will find the script to generate the relevant table by following this link (choose the one

related to your database type).



When activated, the feature asks for a Name of the custom metadata field that will store the

usage of the asset within Jahia DX

Each time an elvis-stored asset is used for a publication through Jahia DX, this information is

stored within the relevant database table. If the publication status is later updated (moved from

one place to another or removed), the data is also updated.

3.4 MOUNT POINT TARGET As DX can manage several websites at once, this setup feature allows to only display the

selected part of the Elvis DAM for a specific website.



3.5 CACHE MANAGEMENT

The Elvis connector does not include a specific cache management that can be set within the

dedicated graphic interface.

Yet, the cache can be configured by accessing the following file on the DX server:

tomcat/webapps/YOUR_APP_NAME/WEB-INF/web.xml

Two parameters need to be added to the file servlet, (which is not the static file servlet)

<servlet> <servlet-name>Files</servlet-name> <servlet-class>org.jahia.services.content.files.FileServlet</servlet-class> <load-on-startup>99</load-on-startup> </servlet> <servlet> <servlet-name>StaticFiles</servlet-name> <servlet-class>org.jahia.services.content.files.StaticFileServlet</servlet-

class> <load-on-startup>99</load-on-startup> </servlet>



in order to get this:

<servlet> <servlet-name>Files</servlet-name> <servlet-class>org.jahia.services.content.files.FileServlet</servlet-class> <load-on-startup>99</load-on-startup> <init-param> <param-name>cache-from-external-provider</param-name> <param-value>true</param-value> </init-param> <init-param> <param-name>cache-threshold</param-name> <param-value>69867098798</param-value> </init-param> </servlet> <servlet> <servlet-name>StaticFiles</servlet-name> <servlet-class>org.jahia.services.content.files.StaticFileServlet</servlet-

class> <load-on-startup>99</load-on-startup> </servlet>

<init-param> <param-name>cache-from-external-provider</param-name> <param-value>true</param-value> </init-param>

By setting this parameter to true, all of the external data provider will get a cache.

NOTE:

The cache will be active in live mode only. The DX preview mode does not use this cache feature.

<init-param> <param-name>cache-threshold</param-name> <param-value>69867098798</param-value> </init-param>

This parameter enables the cache feature for all files whose size exceeds 64kb. (Value is set on

bytes). This value is an example and must be changed to the desired value.



4 FEATURES 4.1 SEARCH, READ AND USE OF A FILE The Elvis connector allows a user to browse an Elvis DAM instance. Searches can be performed

on:

- The file’s name

- The file’s description

- The file’s content

- The file’s creation or last modification’s date

- It’s Elvis tags

- It’s creator’s and last modifier’s name

NOTE:

Concerning files that have a textcontent, the search’s feature can be performed on the textcontent sent by the Elvis DAM. But the relevance of the result will depend on the fact that the textcontent includes the totality of the file’s text content or not.

4.2 USER RIGHTS MANAGEMENT The Elvis connector uses the specified user on the connector settings in DX to log into Elvis

DAM. Therefore, all DX users have the rights attached to this account on Elvis DAM. As Elvis

defines the rights on its resources it is not possible to change them from DX.



5 LIMITATIONS 5.1 NUMBER OF BROWSED FILES By default, the connector poses no limit to the depth of an Elvis DAM browsing request. The

user can get access to all the files. But the more the connector will browse, the slower it will

display the result of the request.

The internal organization of files and folders within the Elvis DAM will affect the responses of

the connector and this action is solely the responsibility of the DAM user.

5.2 FILE ONLINE DISPLAY The connector allows a user to directly insert into a DX managed website a digital asset stored in

Elvis DAM. But if the Elvis server goes down, the file will no longer be available for an online

display through the DX managed website.

DX’s systems go with an internal cache feature that allows an already served file to remain

available through the cache. But the cache system has a consequent impact on the server’s

RAM. A temporary down Elvis server may slow DX server operations if a large amount of heavy

files needs to be stored within DX’s cache.

NOTE:

Elvis files will be stored within DX cache as long as the connector is operational. If, for whatever reason the connector is used to un-mount an Elvis DAM, or is simply removed from DX configuration, the files that were displayed online using the connector will disappear.



5.3 FILE CREATION OR MODIFICATION Jahia’s Elvis connector does not allow DX to add files into Elvis’ system nor can it modify one or

more.

5.4 FILE PREVIEW The “preview files” are created by the Elvis DAM and recreated at a set frequency according to

the Elvis cache. This feature may therefore induce a longer response time from Elvis.

WOODWING ELVIS CONNECTOR3.5 CACHE MANAGEMENT The Elvis connector does not include a specific cache...

Documents

Transcript of WOODWING ELVIS CONNECTOR3.5 CACHE MANAGEMENT The Elvis connector does not include a specific cache...