User`s Manual for EPiTrace
Contents
1. 4 Installation Instructions ImageVault 3 2 em QU gt zi Control Panel Programs and Features Tasks Uninstall or change a program View installed updat Ai To uninstall a program select it From the lis Get new programs online at Windows Marketplace Organize Views v e Turn Windows Features on or off Mame Install a program from the e EPiServer CMS 5 2 375 7 network i MARS eriserver Shared c PAU Abo eben 7 nm If on a Windows 2008 server the Server Manager is shown E Server Manager File Action View Help es 54 amp Server Manager NOOMI Web Server IIS E FS Roles amp Web Server IIS _ Ny Internet Information Se 7 Provides a reliable manageable and scalable Web application infrastructure di Features Ld gm Diagnostics cs Pertormance Installed gj Configuration amp Static Content Compression Installed amp Storage Dynamic Content Compression Not installed amp Management Tools Installed amp 115 Management Console Installed TIS Mahagemertsertpessand mad Management Service Not installed gt 1156 Management Compatibility Installed amp I5 Metabase Compatibility Installed 5 115 WMI Compatibility Installed O SPA ee ERI ao 115 6 Management Console Installed FTP Publishing Service Not installed FTP Server Not installed FTP Management Console Not installed Description Web Se2. 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 EXIFCharTranslation A a4 An 4 AI 6 If unexpected errors occur when accessing ImageVault images additional information about errors can be logged to a file DebugErrorLog c temp log txt Note Make sure that the file exists and that the ASPNET process has rights to write to the file Should the new mirroring support be turned on or off EPiServer AB Web config reference 17 ExportImageVaultProperties true Limit the amount of disk used by the handler to dynamically create converted images The value entered is maxi mum number of GB that can be use
3. These components are neces sary for ImageVault to function properly Installation program started Installation of ImageYault xj 2 This will unpack and start installation of ImageYault Introduction ImageVault 3 0 Installation Welcome to mageY ault installation wizard M This wizard will help you install Image ault for EPiServer 4 61 and Net 2 0 Please send an email to mailto imagevault meridium se if you have any problems with the installation ImageGlue NET ImageEffects and Ghostscript will also be installed during the installation process Cancel O EPiServer AB 8 Installation Instructions ImageVault 3 2 License conditions EE ImageVault 3 0 Installation Read License agreement M LICENSVILLKOR F R IMAGEVAULT EPISERVER 4 61 VERSIONEN VIKTIGT LAS IGENOM DE ALLMANNA VILLKOREN F R LICENSAVTALET NEDAN INNAN DU INSTALLERAR OCH ANVANDER PROGRAMMET GENOM ATT DU INSTALLERAR FRAMSTALLER EXEMPLAR AV LADDAR NED HAR TILLGANG TILL ELLER PA ANNAT SATT ANVANDER PROGRAMVARAN ACCEPTERAR DU NEDANSTAENDE LICENSVILLKOR OCH DETTA LICENSAVTAL BLIA D RIGENOM BINDANDE OM DU INTE ACCEPTERAR N GOT VILLKOR RETURNERAR DU PROGRAMMET TILL DET F RETAG DAR DU FICK DET MOT FULL ERS TTNING FOR LICENSAVGIFTEN OCH TERG NG AV K PET Detta slutanvandaravtal Avtalet r ett bindande avtal mellan slutanv ndaren fl inanctsasran ach hdaridiira AR VA asaran Avtslot ranlarar installahian ach hrib sus C
4. are made before ImageVault is taken into use Applying pre fixes to an ImageVault installation that is already in use will 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 nghts 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 Cache listener configuration Cache listeners are used by ImageVault to clear the sites cache when changes are made to the database O EPiServer AB Multiple sites using one ImageVault 23 Web Service call Web Service call Web Service cal 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 acce
5. path setting under Mirroring is set to the same value on both sites ImageVault 3 2 0 26269 Windows Internet Explorer MERIDIUM ImageVault Y Images Administration Settings Help A d ges i gl P alc EA NE RR Settings License Complex media 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 O EPiServer AB Image Editor 25 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 settingName settingValue UnsharpMaskSettings Radius 0 5 Amount 80 Threshold 0 ContrastSettings Amount 0 BrightnessSettings Amount 0 These settings could also be made accessible in the admin section of ImageVault by setting the column systemSet tingsGroup_id to a value corresponding to a value in IS_SystemSettingsGroups EPiServer AB 26 Installation Instructions ImageVault 3 2 Other Configuration All other configuration is managed from the System configuration interface in ImageVault see Administrator Ma nual EPiServ
6. 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 Change of Web server EN ImageStoreNET 3 Admin 3 cae 33 Controls 3 Data E ImageDB E Orders 3 Edit When moving files to another file server the ImageDB should be linked under the album Data as virtual albums The virtual albums only need to be given view permissions Change of web config The values that may be configured in web config are placed as attributes in the following Configuration section O EPiServer AB Changes in Installation 15 lt se meridium epiServer extensions gt 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 ImageDB gt Note Please note that it s recommended to change this to a location on another disk since files is created and removed in this location depending on user action Also see MaxImageDataSizeRestriction in section 0 below EPiServer AB 16 Installation Instructions ImageVault 3 2 Web config reference A description of the keys that ImageVault uses Information about the database link to the ImageVault database ImageVaultConnStr
7. EPISERVER VERSION 3 2 ImageVault ImageVault simplifies and improves the handling of files in EPiServer CMS The basic function of ImageVault is to store files on a central server so everyone in the organi zation can access and use the files stallation Instructions Copyright This user guide is protected by the Copyright Act Changes to the contents or partial copying of the contents may not be made without permission from the copyright holder The user s guide may be freely distributed in its entirety either digitally or in printed format to all Create users Y MERIDIUM Qs Installation Instructions for ImageVault 3 2 Created February 19 2009 Updated February 23 2009 EPiServer AB Table of Contents Table of Contents INTRODUCTION 3 NEWSIN IMAGEVAUET P E as 3 KNOWN PROBLEMS a a ne eos enr te nas 3 TO CONSIDER BEFORE INSTALLATION TO CONSIDER AFTER INSTALLATION TO CONSIDERMWEBIEN UPGRADINIG IMAGEV AULT s ctr pr da 6 INSTALLATION 7 NISTALLA TION PROGRAM STARTED stitit iate tritt tette tutu d hdi te tulit hatten rut n ritu digas 7 NTRODUETION dee c e v t e a o ttm 7 LICENSE CONDITIONS tete e s 8 SELECT EPISERVERINSTALEATION En aaa 9 A A O Sal cette edad n 9 SEV EGTA PABA SE D NSTALLATION OF MAGEVAULT ttl re et nta ge d dedica 2 CHANGES IN INSTALLATION 14 OVE FILE ARCHIVE FILE SERVER cite eat tn t et bett tc dtt tu t eint te te al 4 CON
8. FIGURE ASPNET TO RUN UNDER A DOMAIN ACCOUNT 4 OVE ALBUMS 4 CHANGE OE MVEB 2 lata 4 CHANGE VEB aaa 4 WEB CONFIG REFERENCE 16 CACPIE E S 7 SUPPORT FOR SEARCH ENGINES Re nr des eode n dep tcd eredi dependere E Le I ue PD te 7 MULTIPLE SITES USING ONE IMAGEVAULT 20 INSTALLATION FILE SHARE CONFIGURATION 20 SITE AND USER CONFIGURATION adan 21 CACHE LISTENER CONFIGURATION ici inde 22 CACHE STEN ER SERVICE ice 23 CACHE LISTENER LIST MIRRORING 24 IMAGE EDITOR 25 OTHER CONFIGURATION 26 O EPiServer AB 2 Installation Instructions ImageVault 3 2 EPiServer AB Introduction 3 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 News in ImageVault 3 2 Any news and changes concerning the installation are described here Support for mirroring between ImageVault sites Support for EPiServer CMS 5 R2 Possibility to limit the amount disk available for dynamically created images ImageVault 3 2 will run on both EPiServer 4 61 and Net 2 0 and on EPiServer CMS however different installation packages is required Note Please not that that if upgrading from ImageVault 2 there is some major changes that has been done to ImageVault that you
9. ancel lt Back v Read through the conditions and accept to continue EPiServer AB Installation 9 Select EPiServer installation F ImageVault 3 0 Installation EPiServer Installation Select where the EPiServer installation is located M Web Site Virtual Folder Only web sites that have an EPiServer installation of version 4 61 or CMS will appear in the drop down menu of the upper box Select the desired web site and possible virtual album where you want ImageVault to be installed License file A ImageVault 3 0 Installation Select your license file A You can skip this step if you already have installed a valid license MERIDIUM License file Browse If you upgrade from a previous version of ImageYault then you probably haven t got a license file Go to till http www meridium se and log on to your ImageVault account Go to My account and in the list of licenses download the appropriate file Save it to disk and select it above Cancel lt Back Next gt EPiServer AB 10 Installation Instructions ImageVault 3 2 Use the Browse button to locate your license file for ImageVault If no file is selected it can later be manually cop ied to the web sites root directory 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 EPiServer AB Install
10. ation 11 Select Database ImageVault 3 0 Installation SQL server 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 INTERNAL A johan C SQL entered below SQL server local Database dbDemd Username sa E Password az Confirm password pe Cancel lt Back Next gt As preset value the local SQL server is selected To choose another SQL server indicate its name in the text field Existing databases on the selected SQL server will be displayed in a drop down menu If you want to create a new database indicate the name of the database that you want to use User name and password should be the ones that you want ImageVault to use after installation As preset the Installation program will use the database of the user running the Installation program By selecting SQL in Authentication during installation the installation may instead be run with the user indicated in the free text fields O EPiServer AB 12 Installation Instructions ImageVault 3 2 Installation of ImageVault zi ImageVault 3 0 Installation Ready to install Press finish to install Image ault M Selected web server ProcessMapReleaseT est Installation folder C Inetpub MyE PiServer SOL Server local Database dbProcessMapReleaseT est Username sa Password XXXXXXXXXX Cance
11. d MaxImageDataSizeRestriction 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 con vert 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 Cache These parameters are used to control how ImageVault should handle the caching of images The caching will func tion 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 im age 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 IV object remains unused in the cache before it is thrown CacheTimeout 1 Support for Search engines To facilitate indexation for Search engines e g Site Seeker there is the possibility to send down metadata in the header information to these Search engines EPiServer AB 18 Installation Instructions ImageVault 3 2 This should include a comma se
12. d and write access to the file share Site and user configuration To be able to identify the servers each server must be configured whit a unique identifier called site prefix De pending 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 tree sites SI S2 and S3 SI and S2 are using the same AD for authentication while S3 is using a local database The SI and S2 should have the same user prefix and 53 would have a unique value O EPiServer AB 22 Installation Instructions ImageVault 3 2 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 S and S2 you can set user rights independent on each server It s important that the settings for user and site prefix
13. er AB 27 O EPiServer AB
14. l lt Back IL Finis By now the Installation program has received all information about where and how ImageVault is to be installed Click Finish to complete the installation During the installation ImageGlue ImageEffects and GhostScript will be installed ImageGlue is the component used for image handling in ImageVault GhostScript is necessary for PostScript to function in ImageVault Installation of these must be completed for ImageVault to function properly O EPiServer AB Installation 13 O EPiServer AB 14 Installation Instructions ImageVault 3 2 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 Move File archive to File server 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 3 7012 Move Albums 5 ImageStoreNET C2 Admin 5 CAB D Controls E 5 Data 4 5 ImageDB E C3 Orders Edit O ImageGlue C3 Images QC IvBuiltInHelp 5 Plugins a Scripts O Styles e ws All files that are used in ImageVault are placed in an album
15. lt 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 ImageVault 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 Note Make sure that the ASPNET process has access rights to the temp directory since this is required be some functions in the Net framework EPiServer AB 6 Installation Instructions ImageVault 3 2 To consider when upgrading ImageVault O EPiServer AB Installation 7 Installation Download and run the Installation program During the installation ImageGlue ImageEffects and GhostScript will also be installed
16. need to consider before upgrading an exist ing installation These are listed below e Support for Net l l is dropped e Support for EPI 4 51 and before is dropped e Changes in the ImageVault API This means that changes is required to web sites that use the ImageVault API or these sites will stop working after installation For detailed information about these changes consult the API documentation e Changes in web config Changes have been made to conform to Net standards though the installation program should take care of converting existing settings e Orders are removed in this release but will return in a future release Known problems ImageVault will run on a 64 bit OS but requires that the site is run in 32 bit mode Make sure that the 32 bit version of Net is installed Move to c windows microsoft net Framework v2 0 50727 run aspnet regiis i to activate the correct version of Net run cscript cNnetpubXadminscriptsvadsutil vbs SET W3SVC AppPools Enable32bitAppOnWin 4 true to activate support for 32bit mode Open up the IIS Manager and set ASP NET v2 0 50727 32bit to Allowed under Web Service Exten sions Make a I SReset When using IIS 7 ImageVault installation requires that the IIS 6 Management Compatibility features to be installed on your IIS server Click the Programs and Features icon in Control Panel Click on Turn Windows features on or off EPiServer AB
17. parated list of UserAgent for their crawlers which have extra information as HTTP headers CrawlerUserAgents SiteSeekerCrawler 1 0 O EPiServer AB Web config reference 19 O EPiServer AB 20 Installation Instructions ImageVault 3 2 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 bal ancing i e multiple servers running the same site Installation Install ImageVault on all servers During the first installation create a database and in the following installations se lect the database the first installation created Note that you should use the exactly the same version of ImageVault on all the sites ImageVault DB DB Connetion DB Connetion DB Connetion DB Connetion DB Connetion DB Connetion Site1 Site2 Site3 DB DB DB 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 NMMyServerNImageStoreNETNDataNImageDB O EPiServer AB Multiple sites using one ImageVault 21 ImageVault File share File access File access File access Site2 Note that the user running the Net process on the servers needs to have rea
18. rver provides support for HTML Web sites and optional support for ASP NET ASP and Web server extensions You can use the Web Server to host an internal or external Web site or to provide an Make sure that all the features under IIS 6 Management Compatibility is installed To consider before installation 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 SOL 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 Proper ties 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 database and files is recommended O EPiServer AB Introduction 5 Note When upgrading from an earlier version changes will be made to both the EPiS erver database and the Image Vault database These changes are not reversible so make backup copies of both databases To consider after installation ImageGlue will require QuickTime for optimal performance Note QuickTime is not included in the installation package but can be downloaded for free from http www apple com quicktime download When ImageVault is installed a number of keys are added in the ImageVau
19. ss Se the document Web Services pdf downloadable from the EPiServer website which describes how to confi gure Basic Authentication 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 xxxx 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 EPiServer AB 24 Installation Instructions ImageVault 3 2 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 the re ceiving 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 ExportlmageVaultProperties to true in the lt ImageVault gt tag in web config on BOTH the sending and receiving site Also make sure that the Virtual
Download Pdf Manuals
Related Search