{"id":22578,"date":"2024-02-15T14:48:40","date_gmt":"2024-02-15T22:48:40","guid":{"rendered":"https:\/\/docs.extraview.com\/v22\/book\/install-tomcat-windows\/"},"modified":"2024-02-15T14:48:40","modified_gmt":"2024-02-15T22:48:40","slug":"install-tomcat-windows","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/","title":{"rendered":"Install Tomcat for Windows"},"content":{"rendered":"<p class=\"textGreyBg\">ExtraView 11 requires Java JRE 8. If your system is on an earlier version of Java, you must upgrade to the required version. If your current version of Tomcat does not support Java 8, you must upgrade to a newer version. We recommend upgrading to Tomcat 8.5. When upgrading, ensure that the Tomcat service is stopped before installing the new version.<\/p>\n<p class=\"textGreyBg\">Note that if you are intending to use Microsoft IIS as your web server, you must still install Tomcat. IIS does not provide the same functionality as Tomcat.<\/p>\n<p>Double click on the Tomcat Application server installation file that you downloaded. In our example it is called <span class=\"fixedWidthFont\">apache-tomcat-8.5.23.exe<\/span>. You may get a Windows Security Warning &#8211; click <b>Run<\/b> to proceed.<\/p>\n<p>Extract the <span style=\"color:#b22222;\"><span style=\"font-family:courier new,courier,monospace;\">apache-tomcat-8.5.23<\/span><\/span> folder to your destination folder&nbsp; &#8211; <span style=\"color:#b22222;\"><span style=\"font-family:courier new,courier,monospace;\">C:\\ExtraView<\/span><\/span> &#8211; so that you end up with <span style=\"color:#b22222;\"><span style=\"font-family:courier new,courier,monospace;\">C:\\ExtraView\\apache-tomcat-8.5.23<\/span><\/span><\/p>\n<p>&nbsp;<\/p>\n<p><img decoding=\"async\" src=\"\/extraview-media\/images\/ig\/windows\/tomcat1-4.png\" style=\"width: 414px; height: 278px;\" \/><\/p>\n<p>Include the selected defaults<\/p>\n<p><img decoding=\"async\" src=\"\/extraview-media\/images\/ig\/windows\/tomcat2-4.png\" style=\"width: 414px; height: 278px;\" \/><\/p>\n<p>Open a command window, as Administrator, and navigate to the destination folder<\/p>\n<p>You can modify the ports Tomcat will run on, if you already have something else running on these ports. In this example, we will leave the defaults<\/p>\n<p><img decoding=\"async\" src=\"\/extraview-media\/images\/ig\/windows\/tomcat3-4.png\" style=\"width: 414px; height: 278px;\" \/><\/p>\n<p>&nbsp;<\/p>\n<p>Browse to the Java 8 that you installed for ExtraView<\/p>\n<p><img decoding=\"async\" src=\"\/extraview-media\/images\/ig\/windows\/tomcat4-4.png\" style=\"width: 414px; height: 278px;\" \/><\/p>\n<p>&nbsp;<\/p>\n<p>Ensure that the destination path for the Tomcat installation does not contain any empty spaces in the folder names<\/p>\n<p>&nbsp;<\/p>\n<p><img decoding=\"async\" src=\"\/extraview-media\/images\/ig\/windows\/tomcat5-4.png\" style=\"width: 414px; height: 278px;\" \/><\/p>\n<p>&nbsp;<\/p>\n<p>Once Tomcat has successfully completed the installation, let it start up and close the installer window<\/p>\n<p><img decoding=\"async\" src=\"\/extraview-media\/images\/ig\/windows\/tomcat6-4.png\" style=\"width: 414px; height: 278px;\" \/><\/p>\n<p>&nbsp;<\/p>\n<p>You can modify the service parameters once you have created it &#8211;&nbsp;<\/p>\n<p>Navigate to the destination folder, and into the&nbsp;<span style=\"color: rgb(178, 34, 34);\"><span style=\"font-family: &quot;courier new&quot;, courier, monospace;\">\/bin<\/span><\/span>&nbsp;folder where you will see the&nbsp;<span style=\"color: rgb(178, 34, 34);\"><span style=\"font-family: &quot;courier new&quot;, courier, monospace;\">tomcat8w.exe<\/span><\/span>&nbsp;application<\/p>\n<p>&nbsp;<\/p>\n<p>Double click the <span style=\"color:#b22222;\"><span style=\"font-family:courier new,courier,monospace;\">tomcat8w.exe<\/span><\/span> file to start it<\/p>\n<p>On the General tab &#8211; set the service to start automatically&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p><img decoding=\"async\" src=\"\/extraview-media\/images\/ig\/windows\/tomcat5-3.png\" style=\"width: 412px; height: 398px;\" \/><\/p>\n<p>\n\tOn the Java tab, you can select a different installation of Java if the JAVA_HOME did not pick the correct installation.<\/p>\n<p>Set the memory parameters to a minimum of:<\/p>\n<p><span class=\"fixedWidthFont\">128 MB<\/span>&nbsp;for&nbsp;<b>Initial memory pool<\/b>&nbsp;<br \/>\n\t<span class=\"fixedWidthFont\">512 MB<\/span>&nbsp;for&nbsp;<b>Maximum memory pool<\/b><\/p>\n<p>We generally do not recommend setting the Maximum memory pool (the Xmx parameter) above 1024 megs at maximum. If your system usage is predicted to be high enough that you will require more memory, we strongly suggest installing a clustered set of multiple Tomcat nodes under a load-balanced Apache web server.<\/p>\n<p>&nbsp;<\/p>\n<p><img decoding=\"async\" src=\"\/extraview-media\/images\/ig\/windows\/tomcat6-3.png\" style=\"width: 412px; height: 398px;\" \/><\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>Now, on the General tab &#8211; start the service<\/p>\n<p><img decoding=\"async\" src=\"\/extraview-media\/images\/ig\/windows\/tomcat7-3.png\" style=\"width: 485px; height: 177px;\" \/><\/p>\n<p>If you enter<span style=\"color:#b22222;\"><span style=\"font-family:courier new,courier,monospace;\"> http:\/\/localhost:8080 <\/span><\/span>into the local browser, you should get the Tomcat test page.<img decoding=\"async\" src=\"\/extraview-media\/images\/ig\/windows\/tomcat8-3.png\" style=\"width: 90%;\" \/><\/p>\n<h3>\n\tUsing the APIs to Insert Large Amounts of Text<\/h3>\n<p>When using an API to insert very large amounts of text within a single issue you may encounter an error within the API function, exhibiting as a null pointer exception that originates within the Tomcat application server.&nbsp; This error may be remedied by inserting the modifying the Connector entry within the Tomcat configuration file.&nbsp; An example of the altered configuration is:<\/p>\n<div>\n\t<code>&lt;Connector port=\"8082\" protocol=\"HTTP\/1.1\" URIEncoding=\"UTF-8\"<\/code><\/div>\n<div>\n\t<code>&nbsp; &nbsp;connectionTimeout=\"20000\" maxPostSize=\"209715200\"<\/code><\/div>\n<div>\n\t<code>&nbsp; &nbsp;redirectPort=\"8442\" maxParameterCount=\"1000000\" \/&gt;<\/code><\/div>\n<p>The <code>maxPostSize <\/code>parameter increases the size of Tomcat&#8217;s buffer used to process the API command.<\/p>\n<h3>\n\tTomcat 8.5 Notes<\/h3>\n<ol>\n<li>\n<p style=\"background-color: rgb(255, 255, 255);\">Modify the&nbsp;<span class=\"fixedWidthFont\">&lt;Context&gt;<\/span>&nbsp;entry in the&nbsp;<span class=\"fixedWidthFont\">context.xml<\/span>&nbsp;file to be<\/p>\n<p style=\"background-color: rgb(255, 255, 255);\"><span class=\"fixedWidthFont\">&lt;Context useHttpOnly=&#8221;false&#8221;&gt;<\/span><\/p>\n<p style=\"background-color: rgb(255, 255, 255);\">You should add the following to the&nbsp;<code>tomcat\/conf\/context.xml<\/code>&nbsp;file:<\/p>\n<p style=\"background-color: rgb(255, 255, 255);\"><code>&lt;!-- Force use of the old Cookie processor (because this Tomcat version uses RFC6265 Cookie Specification) --&gt;<br \/>\n\t\t\t&lt;CookieProcessor className=\"org.apache.tomcat.util.http.LegacyCookieProcessor\" \/&gt;<\/code><\/p>\n<\/li>\n<li>\n\t\tLocate the following section in the Tomcat configuration file:<\/p>\n<p>\t\t<code>&lt;!-- Uncomment this to disable session persistence across Tomcat restarts --&gt;<br \/>\n\t\t&lt;!--<br \/>\n\t\t&lt;Manager pathname=\"\" \/&gt;<br \/>\n\t\t--&gt; <\/code><\/p>\n<p>\t\tand alter to use this setting:<\/p>\n<p>\t\t<code>&lt;!-- Disable session persistence across Tomcat restarts --&gt;<br \/>\n\t\t&lt;Manager pathname=\"\" \/&gt; <\/code><br \/>\n\t\t&nbsp;<\/li>\n<li>\n\t\tTomcat 8&#8217;s standard installation altered the way in which several characters were accepted as valid URL characters.&nbsp; These are characters such as <code>|<\/code>, <code>{ <\/code>and <code>}<\/code>.&nbsp; Some of these characters have long been used within the ExtraView application.&nbsp; To enable Tomcat&#8217;s handling of these characters, insert this line into the <code>Catalina.properties<\/code> file:<\/p>\n<p>\t\t<code>tomcat.util.http.parser.HttpParser.requestTargetAllow=|{}<\/code><br \/>\n\t\t&nbsp;<\/li>\n<li>\n\t\t<span style=\"background-color: rgb(255, 255, 255);\">Tomcat 8.x has a security measure which mandates that you must configure a security measure.&nbsp; This measure rejects all calls to the Tomcat server unless a secret word is part of the request, with requests typically being sent by the Apache web server.&nbsp; Without this configuration, the Tomcat server will apear to spin without responding to the request or will respond with a 404 Not Found error.&nbsp; To configure this feature:<\/span><\/p>\n<ol style=\"background-color: rgb(255, 255, 255);\">\n<li>\n\t\t\t\tIn the&nbsp;<code>server.xml file<\/code>, ensure the section for the AJP 13 connector, has these parameters:<\/p>\n<p><code>&lt;Connector protocol=\"AJP\/1.3\"<br \/>\n\t\t\t\t\t&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;address=\"0.0.0.0\"<br \/>\n\t\t\t\t\t&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;port=\"8009\"<br \/>\n\t\t\t\t\t&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;redirectPort=\"8443\"<br \/>\n\t\t\t\t\t&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;secret=\"<em>changeme<\/em>\" \/&gt;<\/code><\/p>\n<p>Note the port number&nbsp;is typically&nbsp;<code>8009<\/code><br \/>\n\t\t\t\t\tNote the secret word should be changed to your secret word<\/p>\n<\/li>\n<li>\n\t\t\t\tIn the workers.properties file where you set the AJP 1.3 connector, add a parameter:<\/p>\n<p><code>worker.tomcat1.secret =&nbsp;<em>changeme<\/em><\/code><\/p>\n<p>Note the secret word should match the entry in the&nbsp;<code>server.xml<\/code>&nbsp;file.<\/p>\n<\/li>\n<\/ol>\n<\/li>\n<li>\n\t\tMake sure you restart Tomcat after altering its configuration.<\/li>\n<\/ol>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>ExtraView 11 requires Java JRE 8. If your system is on an earlier version of Java, you must upgrade to the required version. If your current version of Tomcat does not support Java 8, you must upgrade to a newer version. We recommend upgrading to Tomcat 8.5. When upgrading, ensure that the Tomcat service is&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"","_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-22578","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Install Tomcat for Windows - 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\/v22\/install-tomcat-windows\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Install Tomcat for Windows - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"ExtraView 11 requires Java JRE 8. If your system is on an earlier version of Java, you must upgrade to the required version. If your current version of Tomcat does not support Java 8, you must upgrade to a newer version. We recommend upgrading to Tomcat 8.5. When upgrading, ensure that the Tomcat service is...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\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=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/\",\"url\":\"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/\",\"name\":\"Install Tomcat for Windows - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v22\/#website\"},\"datePublished\":\"2024-02-15T22:48:40+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.extraview.com\/v22\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Install Tomcat for Windows\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/#website\",\"url\":\"https:\/\/docs.extraview.com\/v22\/\",\"name\":\"ExtraView Product Documentation\",\"description\":\"ExtraView Documentation\",\"publisher\":{\"@id\":\"https:\/\/docs.extraview.com\/v22\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.extraview.com\/v22\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/#organization\",\"name\":\"ExtraView Corporation\",\"url\":\"https:\/\/docs.extraview.com\/v22\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/#\/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\/v22\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Install Tomcat for Windows - 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\/v22\/install-tomcat-windows\/","og_locale":"en_US","og_type":"article","og_title":"Install Tomcat for Windows - Product Documentation","og_description":"ExtraView 11 requires Java JRE 8. If your system is on an earlier version of Java, you must upgrade to the required version. If your current version of Tomcat does not support Java 8, you must upgrade to a newer version. We recommend upgrading to Tomcat 8.5. When upgrading, ensure that the Tomcat service is...","og_url":"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/","og_site_name":"Product Documentation","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/","url":"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/","name":"Install Tomcat for Windows - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v22\/#website"},"datePublished":"2024-02-15T22:48:40+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v22\/install-tomcat-windows\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.extraview.com\/v22\/"},{"@type":"ListItem","position":2,"name":"Install Tomcat for Windows"}]},{"@type":"WebSite","@id":"https:\/\/docs.extraview.com\/v22\/#website","url":"https:\/\/docs.extraview.com\/v22\/","name":"ExtraView Product Documentation","description":"ExtraView Documentation","publisher":{"@id":"https:\/\/docs.extraview.com\/v22\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.extraview.com\/v22\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.extraview.com\/v22\/#organization","name":"ExtraView Corporation","url":"https:\/\/docs.extraview.com\/v22\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.extraview.com\/v22\/#\/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\/v22\/#\/schema\/logo\/image\/"}}]}},"taxonomy_info":[],"featured_image_src_large":false,"author_info":{"display_name":"carl.koppel","author_link":"https:\/\/docs.extraview.com\/v22\/author\/carl-koppel\/"},"comment_info":0,"_links":{"self":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/pages\/22578","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/comments?post=22578"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/pages\/22578\/revisions"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/media?parent=22578"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}