ImageVault 5 Configurations

ImageVault 5 configurations are modified by editing the web.config file.

Generic Application Settings

All applicationsettings for ImageVault utilizes the iv: prefix.

Example:

<appSettings>
    <add key="iv:cachePrefix" value="pf1_"/>
</appSettings>

iv:cachePrefix

If you would like to utilize the same cache instance (like Redis) for multiple installations, then you can set this key to add a prefix that should be applied to all out of process cache keys.

<add key="iv:cachePrefix" value="pf1_"/>

iv:readOnly

If this setting is set to "true" then the ImageVault application is set in a Read-only mode. This indicates that no data will be written to the database. Since ImageVault needs to modify the data in the database, the application cannot perform all functions correctly while in this mode. It will still serve converted media but, for example, it cannot create new conversions on existing data.

iv:setupEnabledForNonAdmins

Normally the /setup page is restricted to Adminsitrators only. You can override this behavior by setting this configuration to true. If, for example, you managed to erase the admin user and would like to create a new one, this is one way to do it.

iv:identityPrefix

If you have multiple ImageVaults that uses different user catalogs you can set the identity prefix to a value that will be prefixed all user and group identities to guarantee uniqueness between users and groups. You configure the identity prefix in the ImageVault UI application and NOT on the client.

Application Insights

Application Insights (AI) is a service that can receive logging/performance details from an ImageVault instance. To activate application insights, add an applicationinsights.config in the web root folder with a suitable configuration. The instrumentation key must be present to send logging to AI. Then two modules must be present in web.config in the /configuration/system.webServer/modules section.

  <add name="TelemetryCorrelationHttpModule" 
    type="Microsoft.AspNet.TelemetryCorrelation.TelemetryCorrelationHttpModule, Microsoft.AspNet.TelemetryCorrelation"
    preCondition="integratedMode,managedHandler"/>
  <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web"
    preCondition="managedHandler"/>

You can also customize the logging further using a set of application settings.

iv:applicationInsightsDeveloperMode

When using AI, entries are buffered and not sent immediately to the AI instance (once per minute). If developer mode is activated, entries are sent immediately. This can reduce performance in production.

iv:applicationInsightsDisabled

Application insights is enabled if you enter an instrumentation key. If you would like to disable it without clearing the instrumentation key, set the disabled value to true.

iv:applicationInsightsEnableProfiling

Enables profiling for ImageVault and sends detailed profiling data to AI.

iv:legacyUsernameIsValidIdentifier

In ImageVault 4, the name of the user was a valid identifier and was registered in the database. In ImageVault 5 every user is identified by its user id (which is a guid). If you have an upgraded installation, you might want to activate this until you have fixed all user rights that was created using the username. Set this to true to include the username as an identifier as per ImageVault 4.

iv:mediaExpireMinutes

As default, media assets delivered by ImageVault will be cached where apropriate and media will be marked as to expire after one year. Using this directive, you can set the number of minutes a media asset will be valid before expiring. This will be reflected in the HTTP response headers Cache-Control (max-age) and Expires.

<add key="iv:mediaExpireMinutes" value="10"/>

iv:securityPrococolType

When ImageVault communicates with an external service using SSL, this configuration can set the security protocol type that we allow. As default we allow SSL3.0, TLS 1.0 and TLS 1.2. To change this, set this configuration to a value that combines all numerical values of the protocols that you would like to allow. The following table shows the different values

ProtocolValue
SSL 2.012
SSL 3.048
TLS 1.0192
TLS 1.1768
TLS 1.23072

As default, we use the value 3312 that enables SSL 3.0, TLS 1.0 and TLS 1.2

See more information about security protocol type at the MSDN page https://msdn.microsoft.com/en-us/library/system.net.securityprotocoltype

iv:searchPageSize

Sets the number of items that each requests retrieves for the ImageVault UI PhotoStream. Default is 50.

iv:databaseCommandTimeout

The number of seconds before a SQL command is aborted if not completed. Only valid for Database upgrade commands. Default value is 3600.

iv:disableJobEngine

If true, the Scheduled job engine is disabled. Default is false.

Client application settings

We also have some settings that can be set on a client (like ImageVault for Episerver) to modify the client settings accordingly.

iv:externalUrl

This url refers to the public ImageVault url that the user should be redirected to when accessing any ImageVault assets. This can be the url to the ImageVault site, or if a CDN is in front of the ImageVault site, the url to the endpoint in the CDN that the ImageVault site uses.

Note: If you only would like to place the published media behind a CDN, use the defaultPublishedMediaUrlBase configuration instead.

iv:internalUrl

This url is the url to the ImageVault site that the Client (from the websites point of view) should use to communicate with ImageVault.

CDN Example

You have an Episerver site that is running the ImageVault plugin/client and an ImageVault site that it should connect to. Both sites are behind a CDN and have one url to the CDN and one to the actual site. The ImageVault client on the Episerver site needs to communicate with the ImageVault site and in this case that communication should not go though the cdn in front of ImageVault. You then enter the address that refers to the actual ImageVault site as the iv:internalUrl.

Connection strings

The following connection strings are used by ImageVault

Database

This is the connection string to the ImageVault database.

AzureStorage

This is the connection string to the Azure Storace Account used by the Azure Platform Provider and the Azure Blob Media Storage.

RedisCache

This is the connection string to the Redis instance used by the RedisObjectCache

ThreadPool settings

As long as the threadpool has spawned less threads than stated as minimum number of threads, the
execution is fast. When the number of busy threads exceeds this number every additional
thread to spawn is delayed for ~500 ms, which may results in timeouts of ongoing Redis operations.

iv:threadPoolMinWorkers

An integer, greater than 0, that sets the minimum amount of worker threads of the applications
threadpool.

iv:threadPoolMinIocp

An integer, greater than 0, that sets the minimum amount of IOCP threads (asyncronous IO threads)
of the applications threadpool.

iv:trashcanDeleteThresholdSeconds

Version 5.8

Deleted items are kept in a trashcan before being removed completely from the system. This configuration sets the number of seconds that the items are kept in the trashcan before being deleted permanently.

Default value is set to 30 days (2592000 seconds).

iv:enableXmpAnalysis

Version 5.8

Xmp analysis is included as a feature toggled component that can be activated by setting this configuration value to true. As default the analyser will import metadata from the following namespaces. For more information about namespaces you can consult the XMP specification.

NamespaceUri
Basichttp://ns.adobe.com/xap/1.0/
Media Managementhttp://ns.adobe.com/xap/1.0/mm/
Rights Managementhttp://ns.adobe.com/xap/1.0/rights/
Dublin Corehttp://purl.org/dc/elements/1.1/
Resource eventhttp://ns.adobe.com/xap/1.0/sType/ResourceEvent#
Resource referencehttp://ns.adobe.com/xap/1.0/sType/ResourceRef#

You can modify this list by modifying the imagevault.xmp section in the web.config file.

<configuration>
  <configSections>
    <section name="imagevault.xmp" type="ImageVault.Core.Conversion.Configuration.XmpNamespaceSection, ImageVault.Core.Conversion"/>
  </configSections>
  <imagevault.xmp>
    <xmlNamespaces>
      <add name="http://ns.xinet.com/ns/xinetschema#"/>
      <remove name="http://ns.adobe.com/xap/1.0/rights/"/>
    </xmlNamespaces>
  </imagevault.xmp>
</configuration>

The xmlNamespaces element allows the following child elements

ElementDescription
addAdds the namespace in the name attribute
removeRemoves the namespace in the name attribute
clearClears the list of attributes
comments powered by Disqus
+46 (0)480 - 31 47 95
info@imagevault.se
Swedish website