Note that Tomcat is required, even if you are intending to use Microsoft IIS as your web server. IIS does not provide the same functionality as Tomcat.<\/p>\n
Installation<\/h3>\n
cd\u00a0 $INSTALL<\/span> We can remove *.bat files since this is a Linux installation.<\/p>\n cd $BASE\/apache-tomcat-9.0.xx\/bin\u00a0<\/span> The following steps will set memory parameters for Tomcat and configure it to run with the correct Java.<\/p>\n We generally do not recommend setting 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 vi $BASE\/apache-tomcat-9.0.xx\/bin\/catalina.sh<\/span><\/p>\n Add the following lines:<\/p>\n JAVA_HOME=\/usr\/local\/extraview\/jre1.8.0_xx If you have an existing installation and the CATALINA_OPTS parameter is different, please consolidate the options above with the existing ones.<\/p>\n If you are using Java 9.0 and above, you will need to add the parameter “-Djava.local.providers=COMPAT” as well<\/p>\n CATALINA_OPTS=”-server -Xms96m -Xmx1024m -XX:MaxPermSize=190m -Djava.awt.headless=true -Dfile_encoding=UTF-8 -Dcom.sun.management.jmxremote -Djava.locale.providers=COMPAT”<\/span><\/p>\n vi $BASE\/apache-tomcat-9.0.xx\/bin\/startup.sh Add the following lines to each script:<\/p>\n JAVA_HOME=\/usr\/local\/extraview\/jre1.8.0_xx Tomcat is now installed in the directory $BASE\/apache-tomcat-9.0.xx<\/span>. You can start\/stop tomcat using the following commands:<\/p>\n $BASE\/apache-tomcat-9.0.xx\/bin\/startup.sh If you enter the URL of the server using port 8080 into a browser, for example http:\/\/server.domain.com:8080, you should get a test page similar to the following.<\/p>\n Edit the At the bottom of the file, add the the two following lines, before the last line wich reads\u00a0 Edit the After making these configuration changes, stop and restart the tomcat process to pick up the changes.<\/p>\n 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.\u00a0 This error may be remedied by inserting the modifying the Connector entry within the Tomcat configuration file.\u00a0 An example of the altered configuration is:<\/p>\n The Normally, Tomcat explodes any existing WAR files and uses the extracted contents. However, Tomcat also supports the use of unexploded WAR files.<\/p>\n To configure Tomcat for use of unexploded WAR files, update the server.xml file to prevent explosion of WAR file as follows:<\/p>\n Find the line:<\/p>\n Change this to:<\/p>\n We recommend installing Tomcat 9.0 to work with this release of ExtraView. The following steps will install Tomcat into the directory $BASE\/apache-tomcat-9.0.xx. Note that Tomcat is required, even if you are intending to use Microsoft IIS as your web server. IIS does not provide the same functionality as Tomcat. Installation cd\u00a0 $INSTALL cp apache-tomcat-9.0.xx.tar.gz $BASE…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24376,"menu_order":3,"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-24380","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\n
\ncp apache-tomcat-9.0.xx.tar.gz $BASE
\ncd $BASE
\ngunzip apache-tomcat-9.0.xx.tar.gz<\/span>
\ntar xvf apache-tomcat-9.0.xx.tar
\nrm apache-tomcat-9.0.xx.tar<\/span><\/p>\nConfiguration<\/h3>\n
\nrm *.bat
\nchmod 744 startup.sh shutdown.sh catalina.sh<\/span><\/p>\n
\nCATALINA_HOME=\/usr\/local\/extraview\/apache-tomcat-8.0.xx
\nCATALINA_OPTS=”-server -Xms96m -Xmx1024m -XX:MaxPermSize=190m -Djava.awt.headless=true -Dfile_encoding=UTF-8 -Dcom.sun.management.jmxremote -Djava.locale.providers=COMPAT –add-exports=java.base\/sun.security.action=ALL-UNNAMED –add-exports=java.desktop\/jax.imageio.spi=ALL-UNNAMED”<\/span><\/p>\n
\n$BASE\/apache-tomcat-9.0.xx\/bin\/shutdown.sh<\/span><\/p>\n
\nCATALINA_HOME=\/usr\/local\/extraview\/apache-tomcat-9.0.xx<\/span><\/p>\n
\n$BASE\/apache-tomcat-9.0.xx\/bin\/shutdown.sh<\/span><\/p>\n![\"\"](\"\/v25\/extraview-media\/images\/ig\/20.0\/solaris-unix-linux\/tomcat-2.png\")
<\/p>\nTomcat 9.x Configuration<\/span><\/h3>\n
tomcat\/conf\/context.xml<\/code> file<\/p>\n\n
<\/Context><\/code> :<\/p>\n<!-- Force use of the old Cookie processor (because this Tomcat version uses RFC6265 Cookie Specification) -->
\n<CookieProcessor className=\"org.apache.tomcat.util.http.LegacyCookieProcessor\" \/><\/code><\/p>\n<\/li>\n<tomcat_home>\/conf\/context.xml<\/code>:<!-- Uncomment this to disable session persistence across Tomcat restarts -->
\n<!--
\n<Manager pathname=\"\" \/>
\n--> <\/code>and alter to use the setting by removing the comments\u00a0<!--<\/code>\u00a0and\u00a0--><\/code>;.\u00a0 This section will now read:<!-- Disable session persistence across Tomcat restarts -->
\n<Manager pathname=\"\" \/><\/code><\/li>\n<\/ol>\n tomcat\/conf\/server.xml <\/code>file<\/p>\n\n
Connector <\/code>entry.\u00a0 I.e. remove\u00a0\u00a0<!--<\/code>\u00a0and --><\/code>\n\u00a0 \u00a0 <!-- Define an AJP 1.3 Connector on port 8009 -->
\n<!--<\/code><\/div>\n\u00a0 \u00a0 <Connector protocol=\"AJP\/1.3\"<\/code><\/div>\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0address=\"::1\"<\/code><\/div>\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0port=\"8009\"<\/code><\/div>\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0redirectPort=\"8443\"<\/code><\/div>\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \/>
\n--><\/code><\/div>\n<\/li>\naddress=\"::1\"<\/code> value in the Connector parameter to force Tomcat to use IPV4.\u00a0 Set it to\u00a0 0.0.0.0<\/code>\n\u00a0 \u00a0 <!-- Define an AJP 1.3 Connector on port 8009 -->
\n<Connector protocol=\"AJP\/1.3\"<\/code><\/div>\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0address=\"0.0.0.0\"<\/code><\/div>\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0port=\"8009\"<\/code><\/div>\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0redirectPort=\"8443\"<\/code><\/div>\n\u00a0 \u00a0 \u00a0\/><\/code><\/div>\n<\/li>\n|<\/code>, { <\/code>and }<\/code>.\u00a0 Some of these characters have long been used within the ExtraView application.\u00a0 To enable Tomcat’s handling of these characters, modify the Connector <\/code>setting in the conf\/server.xml<\/code> file by adding the following entry:relaxedQueryChars=\"{}|\"<\/code>So that you have:\u00a0 \u00a0 <Connector protocol=\"AJP\/1.3\"
\naddress=\"0.0.0.0\"
\nport=\"8009\"
\n<\/span>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0redirectPort=\"8443\"
\nrelaxedQueryChars=\"{}|\"
\n\u00a0 \u00a0 \u00a0\/><\/code><\/code><\/code><\/code><\/li>\n\n
server.xml file<\/code>, ensure the section for the AJP 13 connector has the new parameter:secret=\"changeme<\/em>\"<\/code><Connector protocol=\"AJP\/1.3\"
\naddress=\"0.0.0.0\"
\nport=\"8009\"
\nredirectPort=\"8443\"
\nrelaxedQueryChars=\"{}|\"
\nsecret=\"changeme<\/em>\"
\n\/><\/code>Note the secret word should be changed to your own secret word.<\/li>\nworkers.properties <\/code>file where you set the AJP13 connector, add the parameter:worker.tomcat1.secret = changeme<\/em><\/code>Note the secret word should match the entry you created in the server.xml<\/code> file.<\/li>\n<\/ol>\n<\/li>\nserver.xml<\/code> file, add this entry to ensure that responses from large databases do not swamp user’s browsers:server.xml set maxParameterCount=10000<\/code><\/li>\n<\/ol>\nUsing the APIs to Insert Large Amounts of Text<\/h3>\n
<Connector port=\"8082\" protocol=\"HTTP\/1.1\" URIEncoding=\"UTF-8\"<\/code><\/div>\n\u00a0 \u00a0 \u00a0 \u00a0connectionTimeout=\"20000\" maxPostSize=\"209715200\"<\/code><\/div>\n\u00a0 \u00a0 \u00a0 \u00a0redirectPort=\"8442\" maxParameterCount=\"1000000\" <\/code><\/div>\n\/><\/code><\/div>\nmaxPostSize <\/code>parameter increases the size of Tomcat’s buffer used to process the API command.<\/p>\nUse of WAR Files with Apache Tomcat<\/h3>\n
unpackWARs=\"true\" autoDeploy=\"true\"<\/code><\/p>\nunpackWARs=\"false\" autoDeploy=\"true\"<\/code><\/p>\n","protected":false},"excerpt":{"rendered":"