{"id":24384,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/install-extraview-servlet-3\/"},"modified":"2025-03-05T09:39:44","modified_gmt":"2025-03-05T17:39:44","slug":"install-extraview-servlet-3","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-environment-1\/install-extraview-servlet-3\/","title":{"rendered":"Install the ExtraView Servlet"},"content":{"rendered":"

You have been provided with a file with a name in the format of evjxxx.tar<\/span>. This contains the ExtraView application. xxx is the version and build number of ExtraView that you are installing.<\/p>\n

The ExtraView web application is generally installed under the directory named \/usr\/local\/extraview\/tomcat\/webapps.<\/span><\/p>\n

We suggest that your ExtraView application be installed in a folder named evj under this webapps folder. This will make your ExtraView application default URL:<\/p>\n

http:\/\/yourserver.yourdomain.com\/evj\/ExtraView<\/span><\/p>\n

For simplicity, you may change your web server settings to offer the following as the URL to point directly to ExtraView:<\/p>\n

http:\/\/yourserver.yourdomain.com<\/span><\/p>\n

If you are upgrading, locate your existing ExtraView application folder under the webapps directory, and rename this folder so that it is not overwritten in the next step. This will retain a backup copy of the ExtraView software installation files.<\/p>\n

mv evj evj_old<\/span><\/p>\n

Install the ExtraView Application Software<\/h3>\n

cp evjxxx.tar $BASE\/apache-tomcat-7.0-22\/webapps
\ncd $BASE\/apache-tomcat-7.0-22\/webapps
\ntar xvf evjxxx.tar
\nmv evjxxx evj
\nvi evj\/WEB-INF\/configuration\/Configuration.properties<\/span><\/p>\n

Edit the configuration file $BASE\/apache-tomcat-7.0-22\/webapps\/evj\/WEB-INF\/configuration\/Configuration.properties<\/span> for the following entries:<\/p>\n

You can find a complete listing of all of the available parameters in the Configuration.properties file here<\/a><\/p>\n\n\n\n\n\n\n\n\n
DB_HOST<\/td>\nThe IP address, localhost or fully qualified name for your database server<\/td>\n<\/tr>\n
DB_USER<\/td>\nThis is the name of the database user created previously<\/td>\n<\/tr>\n
DB_PASSWORD<\/td>\nThis is the password for the above database user<\/td>\n<\/tr>\n
DB_URL<\/td>\nMake 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
JDBCDriver<\/td>\nMake sure that the correct entry is uncommented and edited for your DBMS (Oracle, MSSQL or MySQL)<\/td>\n<\/tr>\n
DBMS_INTERFACE<\/td>\nMake sure that the correct entry is uncommented and edited for your DBMS (Oracle, MSSQL or MySQL)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

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

DB_HOST = localhost
\nDB_USER = extraview
\nDB_PASSWORD = password
\nDB_URL = jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS= (HOST=localhost)(PROTOCOL=tcp)(PORT=1521)) (CONNECT_DATA=(SID=ev )))
\nJDBCDriver = oracle.jdbc.driver.OracleDriver
\nDBMS_INTERFACE = com.extraview.dbms.oracle.OracleDbms<\/code><\/p>\n

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

DB_HOST = localhost
\nDB_USER = extraview
\nDB_PASSWORD = password
\nDB_URL = jdbc:mysql:\/\/localhost:3306\/ev
\nJDBCDriver = com.mysql.jdbc.Driver
\nDBMS_INTERFACE = com.extraview.dbms.mysql.MysqlDbms<\/code><\/p>\n

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

DB_HOST = localhost
\nDB_USER = extraview
\nDB_PASSWORD = password
\nDB_URL = jdbc:inetdae7:\/\/localhost:1433\/extraview
\nJDBCDriver = com.inet.tds.TdsDriver
\nDBMS_INTERFACE = com.extraview.dbms.mssql.MssqlDbms<\/code><\/p>\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.<\/p>\n

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
\nDB_URL = jdbc:jtds:sqlserver:\/\/SERVER:4000\/ev<\/p>\n

where ev<\/span> is the name of the database you created in the named instance.<\/p>\n

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:<\/b>If you are running MSSQL: Starting 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. If 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<\/span> for 7.x for ConnectionPoolSize<\/span> and ConnectionPoolMax<\/span>, instead of the previously-limited 20, as the new jTDS driver does not have a 20 connection limit.<\/p>\n

Additional Steps for Upgrades<\/h3>\n

Continue editing the Configuration.properties file within the new installation to populate the needed parameters. You should bring over any settings from your existing file in evj.old\/WEB-INF\/configuration<\/span>.<\/p>\n

vi evj\/WEB-INF\/configuration\/Configuration.properties<\/p>\n

Now you need to copy over the files from your existing application that are specific to your installation:<\/p>\n

cp evj_old\/images\/CompanyLogo.gif evj\/images cp -rf evj_old\/WEB-INF\/user_templates evj\/WEB-INF<\/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>.<\/p>\n

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

If you have customized images other than the Company Logo, those have to be copied to the new installation from the old installation. Depending on your installation, you may also have installed images for additional locales. You will then have to perform the same action for each locale, by replacing en_US<\/span> with the appropriate directory name. If you are upgrading from ExtraView 4.x or 5.x to 7.x, and you have a custom image set, please contact ExtraView Corporation to get further information on updating your image set for the new version of ExtraView.<\/p>\n

cp -r evj_old\/locales\/en_US\/images\/images_custom evj<\/p>\n

UserCustom Class Software Upgrade<\/h3>\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

\/usr\/local\/extraview\/tomcat\/webapps\/evj\/WEB-INF\/classes\/com\/extraview\/usercustom\/<\/span><\/p>\n

and<\/p>\n

\/usr\/local\/extraview\/tomcat\/webapps\/evj\/WEB-INF\/classes\/com\/extraview\/presentation\/usercustom <\/code><\/p>\n

If you have files in these locations, 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 6. 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

cd evj\/WEB-INF
\ncp -r ..\/..\/evj_old\/WEB-INF\/classes .<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

You have been provided with a file with a name in the format of evjxxx.tar. This contains the ExtraView application. xxx is the version and build number of ExtraView that you are installing. The ExtraView web application is generally installed under the directory named \/usr\/local\/extraview\/tomcat\/webapps. We suggest that your ExtraView application be installed in a…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24376,"menu_order":12,"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-24384","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\/linux-environment-1\/install-extraview-servlet-3\/\" \/>\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=\"You have been provided with a file with a name in the format of evjxxx.tar. This contains the ExtraView application. xxx is the version and build number of ExtraView that you are installing. The ExtraView web application is generally installed under the directory named \/usr\/local\/extraview\/tomcat\/webapps. We suggest that your ExtraView application be installed in a...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-environment-1\/install-extraview-servlet-3\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-03-05T17:39:44+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\/linux-environment-1\/install-extraview-servlet-3\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-environment-1\/install-extraview-servlet-3\/\",\"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-03-05T17:39:44+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-environment-1\/install-extraview-servlet-3\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-environment-1\/install-extraview-servlet-3\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-environment-1\/install-extraview-servlet-3\/#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\":\"Linux Environment\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-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\/linux-environment-1\/install-extraview-servlet-3\/","og_locale":"en_US","og_type":"article","og_title":"Install the ExtraView Servlet - Product Documentation","og_description":"You have been provided with a file with a name in the format of evjxxx.tar. This contains the ExtraView application. xxx is the version and build number of ExtraView that you are installing. The ExtraView web application is generally installed under the directory named \/usr\/local\/extraview\/tomcat\/webapps. We suggest that your ExtraView application be installed in a...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-environment-1\/install-extraview-servlet-3\/","og_site_name":"Product Documentation","article_modified_time":"2025-03-05T17:39:44+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\/linux-environment-1\/install-extraview-servlet-3\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-environment-1\/install-extraview-servlet-3\/","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-03-05T17:39:44+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-environment-1\/install-extraview-servlet-3\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-environment-1\/install-extraview-servlet-3\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-environment-1\/install-extraview-servlet-3\/#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":"Linux Environment","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/installation-upgrade-guide-1\/software-installation-upgrades-1\/linux-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\/24384","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=24384"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24384\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24376"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24384"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}