ImageVault Installation Manual
Contents
1. DB Connetion DB Connetion DB Connetion DB Connetion DB Connetion DB Connetion Site1 Site2 Site3 DB DB DB 6 1 1 File share configuration All the servers must have access to a common file share where the files will be stored To change the location modify this attribute in the web config ImagePathOriginal MyServer ImageStoreNET Data ImageDB ImageVault File share File access File access File access Site3 Note that the user running the Net process on the servers needs to have read and write access to the file share Meridium 16 ImageVault Installation Manual 6 2 Site and user configuration To be able to identify the servers each server must be configured whit a unique identifier called site prefix Depending on how users should be authenticated each site may also need a unique identifier for the users this is called user prefix below The site prefix and user prefix has to be specified in each sites web config The prefixes should be added as attributes to the ImageVault node in web config lt imageVault UserPrefix SitePrefix The site prefix has to be unique for each site If a site is running on more than one server i e load balancing then those servers should have the same site prefix The user prefix has to be unique for each user directory that is used This is best illustrated with an example If we have three sites S1 S2 and S3 S1 and S2 are using the2. 5 If the used disk space is exceeding the specified value no new conversions can be done by the handler and the image won t be displayed This can be useful for preventing the disk from filling up if someone tries to request a lot of images in different formats Note This is not a hard quota It only set a limit for when the handler is allowed to convert new images Though users can still upload new images the conversion job still can make new conversions and so forth hence the disk space used can exceed the specified value 4 1 Cache These parameters are used to control how ImageVault should handle the caching of images The caching will function in the same way as EPiServer handles caching If this parameter is set to true no caching of images will occur The database will get a question every time an image is to be displayed as before the caching was introduced No notification about updates will be given to other cache listeners DisableCache true Number of hours that an unused I V object remains unused in the cache before it is thrown CacheTimeout 1 Number of minutes that the image should be kept in the cache This value is sent to Web clients and proxy servers and determines how long they should cache the content ImagesExpiresInMinutes 60 4 2 Support for Search engines To facilitate indexation for Search engines e g Site Seeker there is the possibility to send down metadata
3. displayed in a drop down menu When upgrading ImageVault select the database that the existing installation us using When making a new installation enter the name of the new database you want to create As preset the Installation program will use Windows Authentication when creating the database By selecting SQL in Authentication during installation SQL Server Authentication will be used instead In that case enter username and password for the user OMeridium 8 ImageVault Installation Manual 2 6 Installation of ImageVault s ImageVault 3 4 Installation Ready to install Press finish to install ImageVault MERIDIUM Selected web server EPIG Selected virtual path Installation folder C EPiServer Sites EPi6 By now the Installation program has received all information about where and how ImageVault is to be installed upgraded Click Finish to complete the installation Meridium 9 ImageVault Installation Manual 2 1 View rights Set view rights x Ah IMPORTANT In this version of ImageVault a user must be authorized to view images Rights are set on albums If no view rights are set no one will be able to see any images at all You can choose to authorize everyone to view images to imitate how older versions of ImageVault work Otherwise only administrators will have view rights by default The rights can always be changed at any time from within ImageVault Click yes to authoriz
4. in the header information to these Search engines Meridium 14 ImageVault Installation Manual This should include a comma separated list of UserAgent for their crawlers which have extra information as HTTP headers CrawlerUserAgents SiteSeekerCrawler 1 0 4 3 Support for old URL s It is possible to continue to use the old image handler to support IIS 6 or solutions that have hard coded links in the old format To force ImageVault to create links in the old format use the following setting UseLegacyUrls true 5 Load balancing If several EPiServer sites are configured for load balancing no further configurations are necessary for ImageVault Just make sure that each ImageVault installation references the same database and the same file area 3 1 6 Multiple sites using one ImageVault ImageVault can be used to share a single file repository between multiple EPiServer sites This text describes how to set up ImageVault so that it will work with multiple sites Note that this should not be confused with load balancing i e multiple servers running the same site 6 1 Installation Install ImageVault on all servers During the first installation create a database and in the following installations select the database the first installation created Note that you should use the exactly the same version of ImageVault on all the sites Meridium 15 ImageVault Installation Manual ImageVault DB
5. process has access rights to the temp directory since this is required be some functions in the NET framework 1 3 To consider when upgrading ImageVault Both new installations and upgrading are done by running the same installation program Earlier versions of ImageVault used the third part component ImageGlue but it is no longer used and can be uninstalled after the upgrade is done 2 Making a new installation or upgrading an existing Download and run the Installation program 2 1 Introduction s ImageVault 3 4 Installation lol x Welcome to ImageVault installation wizard AD MERIDIUM This wizard will help you install Image Vault for EPiServer CMS 6 Please register a support case at www meridium se if you have any problems with the installation ImageGlue NET ImageEffects and Ghostscript will also be installed during the installation process The installation program exists in different versions for EPiServer 5 and 6 Make sure you are running the right one Meridium 4 ImageVault Installation Manual 2 2 License conditions S ImageVault 3 4 Installation MERIDIUM Read through the conditions and accept to continue Meridium 5 ImageVault Installation Manual 2 3 Select EPiServer installation 3 ImageVault 3 4 Installation EPiServer Installation Select where the EPiServer installation is located MERIDIUM Only web sites that have an EPiServer installat
6. web config ImagePathOriginal MyServer ImageStoreNET Data ImageDB 3 1 1 Configure ASPNET to run under a domain account For ImageVault to reach files on another server the account that is used to run the ASPNET process must be able to get permissions on the file server This means that the account must be a domain account For more information see http support microsoft com default aspx scid kb EN US 317012 3 1 2 Move Albums ao ImageStoreNET G Admin cas Controls a O Data aD ImageDB E O Orders Q Edt O ImageGlue m Images G IvBuiltInHelp O Plugins D Scripts styles DO ws All files that are used in ImageVault are placed in an album structure under the ImageDB album Move these albums to the file server Note that the account that runs the ASPNET process must have permission to the albums on the file server 3 2 Change of web config The values that may be configured in web config are placed as attributes in the following Configuration section Meridium 12 ImageVault Installation Manual lt se meridium epiServer extensions gt lt imageVault ImagePathOriginal C ImageDB gt This key should be connected to the folder where the original images are archived ImagePathOriginal C inetpub Demo ImageStoreNET Data ImageD Note Please note that it s recommended to change this to a location on another disk since files i
7. Installation Manual ImageVault Version 3 5 Meridum AB Svensknabbev gen 17 S 393 51 Kalmar Sweden www meridium se Copyright This manual is protected by international copyright law No changes of content or reproduction of parts of this publication is allowed without permission from the publisher M ERIDIUM Webbl sningar f r offentlig sektor Installation Manual for ImageVault version 3 5 Created October 30 2007 Last edited December 20 2011 Meridium AB ImageVault Installation Manual Contents ImageVault Installation Manual 1 Meridium_ ee 1 Contents 22 dl 1 1 Introduction 1 1 To consider before installation 1 1 2 To consider after installation 3 TO consider when upgrading ImageVault A G Cd Co A 2 Making a new installation or upgrading an existing 2 1 Introduction 4 2 2 License conditions 5 2 3 Select EPiServer installation 6 2 4 License File 7 2 5 Select Database 8 2 6 Installation of ImageVault 9 ImageVault Installation Manual 3 OMeridium 3 22 3 3 2 7 View rights 10 2 8 Troubleshooting installation 10 3 Changes in Installation 12 3 1 Move File archive to File server 12 3 2 Change of web config 12 4 Web config reference 13 4 1 Cache 14 4 2 Support for Search engines 14 4 3 Support for old URL s 15 5 Load balancin 15 6 Multiple sites using one ImageVault 15 6 1 Installation 15 6 2 Site and user configu
8. Radius 0 5 Amount 80 Threshold 0 ContrastSettings BrightnessSettings These settings could also be made accessible in the admin section of ImageVault by setting the column systemSettingsGroup_id to a value corresponding to a value in IS_SystemSettingsGroups Meridium 21 ImageVault Installation Manual 9 Logging If you have problems with ImageVault logging can be very useful ImageVault like EPiServer uses Log4Net for logging messages about its operations In the web root folder you will find a file called EPiServerLog config It looks something like this at the end lt root gt lt level value All gt lt Uncomment one or all of the appender ref s or add additional ones gt lt appender ref ref fileLogAppender gt lt appender ref ref udpLogAppender gt lt root gt lt log4net gt In the example above the tag appender with the ref attribute of fileLogAppender is uncommented The tag level has its attribute value set to Al This means that all messages disregarding importance will logged Possible logging levels are Off Fatal Error Warn Info Debug and AN The fileLogAppender itself is configured somewhere else in the file If it is missing you have to add it yourself It should look something like this lt appender name fileLogAppender type log4net Appender FileAppender gt l
9. e everyone to view images in all albums Click no to only authorize administrators This setting only applies to sites running on IIS 7 or newer In ImageVault 3 4 a new functionality is added Rights to view images must be set otherwise no one will be able to see any images at all To imitate how older versions of ImageVault work you can choose to authorize everyone to see any image If this is your choice click Yes To set rights only for administrators click No If you click Cancel no rights will be set at all Instead you will have to set them manually for each album after the installation Note This new security layer will not affect images that are referred to with static links e g images published by using the free text editor 2 8 Troubleshooting installation The installation will write log messages to a log file during the installation This log file can be useful if the installation fails for some reason The log file will be found in the temporary folder that is created when the installation application is executed and the contained files are unpacked Meridium 10 ImageVault Installation Manual of WinRAR self extracting archive Extracting files www lmageStoreNE T I BuiltInHelp E ditablePages SownContentE dit html Extracting files www lmageStoreNE T I BuiltInHelp E ditablePages SownContet4lbumAdmin html Extracting files www mageStoreNE T IVBuiltInHelp E nglish Admin aspx Extracting files www
10. e receiving site From version 3 2 ImageVault can support mirroring of images to another site with ImageVault installed In this case images albums metadata conversion formats and categories for images published on pages will be replicated to the receiving site This could also be used to export import pages including ImageVault files to another site To activate this feature set the attribute ExportImageVaultProperties to true in the lt ImageVault gt tag in web config on BOTH the sending and receiving site Also make sure that the Virtual path setting under Mirroring is set to the same value on both sites E ImageVault 3 2 0 26269 Windows Internet Explorer C MERIDIUM ob ImageVault mages i Administration i Settings i Help gt N A Settings ActiveX control Mirroring Advanced Virtual path Global IVFiles Virtual path for the mirrored files e g Upload MirroredIvFiles Category Conversions for images Mirroring Note This feature is only available in the CMS version of ImageVault Meridium 20 ImageVault Installation Manual 8 Image Editor It is possible to change the default values used in the filter section in ImageVaults Image Editor Standard Filter Autolevels Brightness Contrast Unsharp Mask Grayscale Amount 80 Radius 0 5 pixels Threshold 0 levels Apply This is done in the database in the table IS_SystemSettings UnsharpMaskSettings
11. ion of version 5 or 6 will appear in the upper drop down menu Select the desired web site and possible virtual folder where you want ImageVault to be installed or updated Meridium 6 ImageVault Installation Manual 2 4 License File s ImageVault 3 4 Installation Select your license file You can skip this step if you already have installed a valid license MERIDIUM Use the Browse button to locate your license file for ImageVault If no file is selected it can later be manually copied to the web sites root directory If you are upgrading just click Next You should already have a license file located in the right folder Note If multiple Meridium products is installed on the same web site the license files has to be merged This must be done manually if the file is not selected in this step Meridium 7 ImageVault Installation Manual 2 5 Select Database ST ImageVault 3 4 Installation SQL server A Select the SQL server where you want to store ImageVault MERIDIUM Choose an existing database or enter a name for a new database Authentication during installation Windows WIN L8ISSR29R4P Administrator SQL entered below SQL server focal VV Database dbimageVeut O Username sa m Password pee Confirm password pe Cancel lt Back Next gt Select the SQL server where you want to create the ImageVault database Existing databases on the selected SQL server will be
12. ites cache when changes are made to the database Web Service call Web Service call 6 4 Cache listener service The cache listeners can be set up using anonymous access but this is not recommended To secure the web service we use EPiServer s BasicAuthentication Module Every installation has a web service that has to be set to basic authentication This is done by opening Internet Information Services and select properties for folder ImageStoreNet WS AuthenticationService and disable Anonymous access Se the document Web Services pdf downloadable from the EPiServer website which describes how to configure Basic Authentication Meridium 18 ImageVault Installation Manual 6 5 Cache listener list Each site also needs to know how to find the other sites cache listeners This is done by creating a list in web config lt imageVault gt lt RemoteSites gt lt add Url http site1 Name site1 UserName login1 Password XXxxx gt lt add Url http site2 Name site2 UserName login2 Password yyyy gt lt RemoteSites gt lt imageVault gt To test if the cache listeners are correctly configured go to ImageStoreNET Admin TestRemoteSites aspx Meridium 19 ImageVault Installation Manual 7 Mirroring Older versions of ImageVault had limited support for mirroring Images used in the EPiServer free text editor could be exported to an image stored in the page folder on th
13. lmageStoreNE T I BuiltinHelp Enalish E ditor aspx Extracting files www lmageStoreNE T I BuiltInHelp English mages album_ 1 ipa Extracting files www lmageStoreNE TI BuiltInHelp E nglish lmages album_ 2 ipg Extracting files www lmageStoreNE T IYBuiltInHelp English lmages cat_1 jpg Extracting files www lmageStoreNE TI BuiltInHelp English lmages cat_2 ipa Extracting files www lmageStoreNE T I BuiltInHelp English lmages conv_ 1 ipa Destination folder C Users dan 4ppD ata Local T emp RarSFx1 x Browse Installation progress o Install Cancel The temporary folder is found in the users temp folder like in the example above the folder c Users dan AppData Local Temp RarSFX1 is used The log file named log4net txt contains a lot of debugging information that is useful for troubleshooting the installation This temporary folder will be removed when the installation application is closed so be sure to backup the log file if you need it for further references Meridium 11 ImageVault Installation Manual 3 Changes in Installation ImageVault is installed with a structure that fits most of our customers basic requirements This chapter describes how you can change structure and configuration to fit different applications 3 1 Move File archive to File server All the servers must have access to a common file share where the files will be stored To change the location modify this attribute in the
14. ration 17 6 3 Cache listener configuration 18 6 4 Cache listener service 18 OMeridium Contents 1 ImageVault Installation Manual 6 5 Cache listener list 19 7 Mirroring 20 8 Image Editor 21 9 Logging 22 10 Other Configuration 23 OMeridium Contents 2 ImageVault Installation Manual 1 Introduction This document describes the different stages in the installation of ImageVault The document also explains how ImageVault can easily be configured to store the images on a separate file server 1 1 To consider before installation From version 3 4 of ImageVault 64 bit websites are supported There are different installation packages for 32 and 64 bit versions of ImageVault You can run 32 and 64 bit installations on the same machine The 32 bit version is recommended for development because the 64 bit dlls can interfere with Visual Studios intellisense The user that you log in as when running the installation must have permissions to be able to create and change databases on the SQL server that is to be used for ImageVault If you indicate the SQL server with a computer name Named Pipes must be activated and if you indicate an IP address TCP IP must be activated Right click on the database server in the Enterprise Manager and select Properties Click Network Configuration to activate Named Pipes and or TCP IP If the installation is an upgrading of an earlier version of ImageVault a complete backup of both da
15. s created and removed in this location depending on user action Also see MaxImageDataSizeRestriction in section 4 below 4 Web config reference A description of the keys that ImageVault uses Information about the database link to the ImageVault database ImageVaultConnStr Server local Database ImageVaultNET UID sa Password The parameter should be set in case the service that manages the conversion of images is run on a separate web server If you do not use a dedicated server for the image handling this key should not be included at all WebServiceURL http localhost 80 ImageStoreNET WS A comma separated list with names of the groups that have Administration rights in ImageVault AdminGroups ImageVault Admins A comma separated list with names of the groups that have Edit rights in ImageVault EditorGroups ImageVault Editors A comma separated list of string to replace during extraction of IPTC and EXIF meta data This could be used to handle national characters even when this is not permitted by the standard EXT PCharTranslation Axy An 4 AV 5 Should the new mirroring support be turned on or off Meridium 13 ImageVault Installation Manual ExportImageVaultProperties true Limit the amount of disk used by the handler to dynamically create converted images The value entered is maximum number of GB that can be used MaxImageDataSizeRestriction
16. same AD for authentication while S3 is using a local database The S1 and S2 should have the same user prefix and S3 would have a unique value Site prefix S1 User prefix U1 Site prefix S2 User prefix U1 Site prefix S3 User prefix U2 Note that you should only set the user prefix to the same value if you want album rights to be the same for both sites By setting different prefixes on site S1 and S2 you can set user rights independent on each server It s important that the settings for user and site prefix are made before ImageVault is taken into use Applying prefixes to an ImageVault installation that is already in use will Meridium 17 ImageVault Installation Manual cause strange behavior regarding user rights and when tracking the usage of images It s also important that all sites that are using the database has a site prefix and a user prefix Otherwise it will not know that it is a shared database and might remove rights that are set by the other sites It is possible to set a site and user prefix for an already existing ImageVault site but that will require changes to the database and that the site is taken offline There is a sql script available to assist in making theses changers See the comments in the script file for more information The script MultipleEPiServersUpdate sql can be downloaded from www meridium se 6 3 Cache listener configuration Cache listeners are used by ImageVault to clear the s
17. t file value EPiServerErrorLog txt gt lt encoding value utf 8 gt lt lockingModel value MinimalLock gt lt appendToFile value true gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value date slevel sthread Stype smethod smessagesn gt lt layout gt lt appender gt This means that logged messages will be saved to the file EPiServerErrorLog txt in the web root folder Make sure that the user the site is running under has right to write to the file For more information about logging see http logging apache org log4net Meridium 22 ImageVault Installation Manual 10 Other Configuration All other configuration is managed from the System configuration interface in ImageVault see Administrator Manual Meridium 23
18. tabase and files is recommended Note When upgrading from an earlier version changes will be made to both the EPiServer database and the ImageVault database These changes are not reversible so make backup copies of both databases 1 2 To consider after installation When ImageVault is installed a number of keys are added in the JmageVault section in the se meridium epiServer extensions section of web config The keys that indicate a URL will be set to http localhost by the Installation program and must be changed to valid DNS names or IP addresses for ImageVault to function properly The IP address or DNS name must also be accessible from the server that ImageVault is installed on The installation has created two groups in EPiServer that are called ImageVault Admins and ImageVault Editors To have access to administration in ImageVault you have to be a member of ImageVault Admins and to be able to add change and delete images you have to be a member of JmageVault Editors You can replace these groups by changing AdminGroups and EditorGroups below the section ImageVault in the section se meridium epiServer extensions in web config Several groups can be indicated in a comma separated list ImageVault has functionality to deliver notifications by e mail For this to work the Web server must be enabled to use the Default SMPT Server to send e mails Meridium 3 ImageVault Installation Manual Note Make sure that the ASP NET
Download Pdf Manuals
Related Search