{"id":24396,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/install-extraview-servlet-4\/"},"modified":"2025-02-17T17:30:24","modified_gmt":"2025-02-18T01:30:24","slug":"install-extraview-servlet-4","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/","title":{"rendered":"Install the ExtraView Servlet"},"content":{"rendered":"

Use WinZip or a similar utility to expand the file named evjXXX.tar<\/span>, where XXX<\/span> is the version number of ExtraView that you are installing.<\/p>\n

<\/p>\n

When asked to select a folder to extract to, enter C:\\ExtraView\\Tomcat7\\webapps<\/span>, or the corresponding value for your system.
\n\tA directory named evjXXX<\/span> will be automatically appended to the path that you select.
\n\t 
\n\tStop the Apache Tomcat service so that you can rename the directory named evjXXX<\/span> to evj<\/span>, and complete the following steps.<\/p>\n

Edit the configuration file C:\\ExtraView\\Tomcat7\\webapps\\evj\\WEB-INF\\configuration\\Configuration.properties<\/span> for the following entries:<\/p>\n\n\n\n\n\n\n\n\n
\n\t\t\t\tDB_HOST<\/td>\n\n\t\t\t\tThe IP address, localhost or fully qualified name for your database server<\/td>\n<\/tr>\n
\n\t\t\t\tDB_USER<\/td>\n\n\t\t\t\tThis is the name of the database user created previously<\/td>\n<\/tr>\n
\n\t\t\t\tDB_PASSWORD<\/td>\n\n\t\t\t\tThis is the password for the above database user<\/td>\n<\/tr>\n
\n\t\t\t\tDB_URL<\/td>\n\n\t\t\t\tMake sure that the correct entry is uncommented and edited for your DBMS (Oracle, MSSQL or mySQL). The entry for HOST should be set to the same as DB_HOST above. The entry for SID should be the SID of the Oracle database, or the database name for MSSQL or mySQL<\/td>\n<\/tr>\n
\n\t\t\t\tJDBCDriver<\/td>\n\n\t\t\t\tMake sure that the correct entry is uncommented and edited for your DBMS (Oracle, MSSQL or mySQL)<\/td>\n<\/tr>\n
\n\t\t\t\tDBMS_INTERFACE<\/td>\n\n\t\t\t\tMake sure that the correct entry is uncommented and edited for your DBMS (Oracle, MSSQL or mySQL)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Note: Even though this is a Windows installation, you must use forward slashes \u201c\/\u201d in paths in Configuration.properties<\/span>.<\/p>\n

The following is an example of the Configuration.properties<\/span> using Oracle: <\/p>\n

The following is an example of the Configuration.properties<\/span> using MSSQL:<\/p>\n

<\/p>\n

The following is an example of the Configuration.properties<\/span> using mySQL:<\/p>\n

<\/p>\n

\n\tNamed Instances in MSSQL<\/h3>\n

You must configure SQL Server with mixed mode authentication, not just Windows authentication. For named instances, provide the port number in the JDBC URL – not the named instance name. For example, if your named instance is SERVERINSTANCE1<\/span> running on port 4000 then the parameters in the Configuration.properties<\/span> file will be:<\/p>\n

DB_HOST = SERVER DB_URL = jdbc:jtds:sqlserver:\/\/SERVER:4000\/ev<\/p>\n

where ev<\/span> is the name of the database you created in the named instance. The SERVER name can be a server name, fully qualified domain name or IP address. It cannot be of the format SERVERINSTANCE1,4000<\/span>.<\/p>\n

Note:If you are running MSSQL:
\n\tStarting with ExtraView 5.x, ExtraView now provides a JDBC driver for MSSQL. We no longer require or support the Sprinta JDBC driver that was used in the 4.x versions of ExtraView.
\n\tIf you are upgrading from 4.x and had previously been using the 20-connection Sprinta driver for MSSQL, you can now use the default values provided in the Configuration.properties for 9.x for ConnectionPoolSize and ConnectionPoolMax, instead of the previously-limited 20, as the new jTDS driver does not have a 20 connection limit.<\/p>\n

\n\tAdditional Steps for Upgrades<\/h3>\n

Continue editing the Configuration.properties file within the new installation to populate the needed parameters. At this point, you can compare your evj_old\/WEB-INF\/configuration\/Configuration.properties<\/span> with the current file to determine if you have made any other changes that you wish to maintain. In particular:<\/p>\n

    \n
  • \n\t\tLook for any LDAP \/ Active Directory or SSO fields that you may have configured<\/li>\n
  • \n\t\tThere are also several lines relating to the ConnectionPool settings \u2013 if your existing settings are higher than the defaults, or if you have changed your settings to appropriate numbers for your system, you should copy the old settings into the new Configuration.properties file.<\/li>\n<\/ul>\n

    Next, copy over the files from your existing installation that are specific to your installation:<\/p>\n

    Copy file evj_old\/images\/CompanyLogo.gif<\/span> to evj\/images<\/span>
    \n\tCopy folder evj_old\/WEB-INF\/user_templates<\/span> to evj\/WEB-INF<\/span><\/p>\n

    If you have user custom JavaScript code that was written either by ExtraView Corporation or by your developers, you should add any of your custom methods in the evj_old\/javascript\/user_javascript\/UserJavascript.js<\/span> file to the new file in evj\/javascript\/user_javascript<\/span>. If you have questions about this step, please contact the ExtraView support team.<\/p>\n

    You may or may not have files in the user_javascript<\/span> and user_templates<\/span> folders, depending on your initial installation.<\/p>\n

    If you have customized images other than the company logo (CompanyLogo.gif), those have to be copied as well. Depending on your installation, you may have installed images for additional locales. You then have to perform the same action for each locale, by replacing en_US with the appropriate directory name. If you are upgrading from ExtraView 4.x or 5.x to 9.x, and you have a custom image set, please contact ExtraView support to get further information on updating your image set for the this version of ExtraView.<\/p>\n

    Copy folder evj_old\/locales\/en_US\/images\/images_custom<\/span> to evj\/locales\/en_US\/images<\/span><\/p>\n

    \n\tUserCustom Java Class Upgrade<\/h3>\n

    Only if there is User Custom code implemented on your site is this step necessary.<\/p>\n

    If you have User Custom code implemented, please review the name of your User Custom class(es) in the directory(ies) named<\/p>\n

    C:\\ExtraView\\Tomcat7\\webapps\\evj\\WEB-INF\\classes\\com\\extraview\\usercustom\\<\/span><\/p>\n

    and<\/p>\n

    C:\\ExtraView\\Tomcat7\\webapps\\evj\\WEB-INF\\classes\\com\\extraview\\presentation\\usercustom\\<\/span><\/p>\n

    If you have files in these locations, and you are upgrading from a version of ExtraView older than 9.0, then you must contact ExtraView Corporation in order to make certain that you are upgrading your User Custom code to the correct new version. At the very minimum, these files should be recompiled using Java 7.<\/p>\n

    If you have files in the \/usr\/local\/extraview\/tomcat\/webapps\/evj\/WEB-INF\/classes<\/span> folder that are not in the “usercustom” locations, you should *not* copy these files to the new evj folder – please contact ExtraView Corporation for assistance. These files are likely bugfix patch classes, and are not needed in the new version.<\/p>\n

     <\/p>\n

     <\/p>\n","protected":false},"excerpt":{"rendered":"

    Use WinZip or a similar utility to expand the file named evjXXX.tar, where XXX is the version number of ExtraView that you are installing. When asked to select a folder to extract to, enter C:\\ExtraView\\Tomcat7\\webapps, or the corresponding value for your system. A directory named evjXXX will be automatically appended to the path that you…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24391,"menu_order":6,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"no","_lmt_disable":"","_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"class_list":["post-24396","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\nInstall the ExtraView Servlet - Product Documentation<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Install the ExtraView Servlet - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"Use WinZip or a similar utility to expand the file named evjXXX.tar, where XXX is the version number of ExtraView that you are installing. When asked to select a folder to extract to, enter C:ExtraViewTomcat7webapps, or the corresponding value for your system. A directory named evjXXX will be automatically appended to the path that you...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-18T01:30:24+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/\",\"name\":\"Install the ExtraView Servlet - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-02-18T01:30:24+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ExtraView 25\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Installation & Upgrade Guide\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Software Installation & Upgrades\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Windows Environment\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/\"},{\"@type\":\"ListItem\",\"position\":6,\"name\":\"Install the ExtraView Servlet\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"name\":\"ExtraView Product Documentation\",\"description\":\"ExtraView Documentation\",\"publisher\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\",\"name\":\"ExtraView Corporation\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"contentUrl\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"width\":512,\"height\":512,\"caption\":\"ExtraView Corporation\"},\"image\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Install the ExtraView Servlet - Product Documentation","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/","og_locale":"en_US","og_type":"article","og_title":"Install the ExtraView Servlet - Product Documentation","og_description":"Use WinZip or a similar utility to expand the file named evjXXX.tar, where XXX is the version number of ExtraView that you are installing. When asked to select a folder to extract to, enter C:ExtraViewTomcat7webapps, or the corresponding value for your system. A directory named evjXXX will be automatically appended to the path that you...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-18T01:30:24+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/","name":"Install the ExtraView Servlet - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-02-18T01:30:24+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/install-extraview-servlet-4\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":2,"name":"ExtraView 25","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":3,"name":"Installation & Upgrade Guide","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/"},{"@type":"ListItem","position":4,"name":"Software Installation & Upgrades","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/"},{"@type":"ListItem","position":5,"name":"Windows Environment","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/windows-environment-1\/"},{"@type":"ListItem","position":6,"name":"Install the ExtraView Servlet"}]},{"@type":"WebSite","@id":"https:\/\/docs.extraview.com\/v25\/#website","url":"https:\/\/docs.extraview.com\/v25\/","name":"ExtraView Product Documentation","description":"ExtraView Documentation","publisher":{"@id":"https:\/\/docs.extraview.com\/v25\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.extraview.com\/v25\/#organization","name":"ExtraView Corporation","url":"https:\/\/docs.extraview.com\/v25\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/","url":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","contentUrl":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","width":512,"height":512,"caption":"ExtraView Corporation"},"image":{"@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/"}}]}},"taxonomy_info":[],"featured_image_src_large":false,"author_info":{"display_name":"carl.koppel","author_link":"https:\/\/docs.extraview.com\/v25\/author\/carl-koppel\/"},"comment_info":0,"_links":{"self":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24396","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/comments?post=24396"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24396\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24391"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24396"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}