{"id":9234,"date":"2018-06-22T14:57:23","date_gmt":"2018-06-22T19:57:23","guid":{"rendered":"https:\/\/www.mrc-productivity.com\/legacy\/?page_id=9234"},"modified":"2018-07-18T16:13:35","modified_gmt":"2018-07-18T21:13:35","slug":"instructions-for-upgrading-to-tomcat-9","status":"publish","type":"page","link":"https:\/\/www.mrc-productivity.com\/legacy\/m-power-admin\/instructions-for-upgrading-to-tomcat-9","title":{"rendered":"Instructions for Upgrading to Tomcat 9"},"content":{"rendered":"<h1>Instructions for Upgrading to Tomcat 9<\/h1>\n<p>Tomcat 9 offers m-Power customers the latest security, performance, and stability improvements. As such this document is designed to give system administrators step by step instructions on how to upgrade from Tomcat 7 to Tomcat 9.<\/p>\n<p>Before we begin, please note these instructions are designed for <i>standard<\/i> installations. If you are utilizing any of the following, please consider engaging m-Power in a services agreements for us to do this conversion for you as we are familiar with these types of customized solutions:<\/p>\n<ul>\n<li style=\"list-style-type: circle;margin-left:30px\">Load Balancing<\/li>\n<li style=\"list-style-type: circle;margin-left:30px\">Clustering<\/li>\n<li style=\"list-style-type: circle;margin-left:30px\">SSL<\/li>\n<li style=\"list-style-type: circle;margin-left:30px\">mod_jk to communicate between Tomcat\/Apache<\/li>\n<li style=\"list-style-type: circle;margin-left:30px\">Custom Contexts<\/li>\n<li style=\"list-style-type: circle;margin-left:30px\">Reverse Proxies<\/li>\n<\/ul>\n<h1>Windows Instructions<\/h1>\n<h2>Uninstall existing Tomcat7 services<\/h2>\n<ol>\n<li>Stop Existing Tomcats<\/li>\n<li>Open CMD mode as Administrator<\/li>\n<li>Navigate to c:\\program files\\mrc\\development\\m-power\\tomcat\\bin<\/li>\n<li>Type service remove TC7DEV<\/li>\n<li>Navigate to c:\\program files\\mrc\\production\\m-power\\tomcat\\bin<\/li>\n<li>Type service remove TC7PROD<\/li>\n<li>Repeat for any other services you may have installed<\/li>\n<\/ol>\n<h2>Install Tomcat<\/h2>\n<ol>\n<li>Download the Windows version Tomcat 9 from mrc <a href=\"\/products\/Tomcat9\/tomcat-pc.zip\">here<\/a><\/li>\n<li>Rename existing Tomcat folder to Tomcat 7<\/li>\n<li>Unzip downloaded file into c:\\program files\\mrc\\development\\m-power\\. When completed you should have a c:\\program files\\mrc\\development\\m-power\\tomcat folder<\/li>\n<li>Move tools.jar from tomcat7\\lib to tomcat\\lib<\/li>\n<li>If you connect to MSSQL or MySQL, move over the necessary jar files from tomcat7\\lib to tomcat\\lib<br \/>\n<img decoding=\"async\" src=\"\/legacy\/images\/drivers.png\"\/><\/li>\n<li>Examine server.xml in tomcat7\\conf. Specifically, note the shutdown port, connector port, and contexts. Ensure these changes are made within the server.xml in tomcat\\conf.<br \/>\n<img decoding=\"async\" src=\"\/legacy\/images\/shutdown.png\"\/><br \/>\n<img decoding=\"async\" src=\"\/legacy\/images\/main.png\"\/><br \/>\n<img decoding=\"async\" src=\"\/legacy\/images\/mapped.png\"\/><\/li>\n<p>Repeat the above process for your production instance (as well as any other instances you may have). <\/p>\n<p><strong>Note <\/strong>: The &quot;\/webapp\/mrc&quot; context is only used in your development environment, therefore you should only have the &quot;\/mrcjava&quot; context at the bottom of the server.xml file for your production instance(s).<\/li>\n<\/ol>\n<h2>Install Tomcat9 as a service<\/h2>\n<ol>\n<li>Open CMD mode as Administrator<\/li>\n<li>Navigate to c:\\program files\\mrc\\development\\m-power\\tomcat\\bin<\/li>\n<li>Type service install TC9DEV <\/li>\n<li>Type tomcat9w \/\/ES\/\/TC9DEV<\/li>\n<li>In the Java tab set the JVM to the appropriate jvm.dll (found in a path similar to C:\\Program Files\\Java\\jdk1.8.X_XX\\jre\\bin\\server\\jvm.dll<\/li>\n<li>In Java options, add the following:<br \/>\n-Xmx512m<br \/>\n-Xms512m<br \/>\n(Change the above to match your usuage needs)<\/li>\n<li>Be sure that the Initial Memory Pool, Maximum memory pool, and Thread stack size inputs are all empty <\/li>\n<li>Back in the general tab. ensure that the startup type is Automatic<\/li>\n<li>Press Start<\/li>\n<\/ol>\n<p>Repeat the above process  for your production instance (as well as any other instance you have)<\/p>\n<h1>Linux Instructions<\/h1>\n<ol>\n<li>Download the Linux version of Tomcat 9 from mrc <a href=\"\/products\/Tomcat9\/tomcat-linux.zip\">here<\/a><\/li>\n<li>Stop Existing Tomcat<\/li>\n<li>Rename existing Tomcat folder to Tomcat 7<\/li>\n<li>Unzip downloaded file into \/m-power. When completed you should have an m-power\/tomcat\/ folder<\/li>\n<li>Move tools.jar from tomcat7\/lib to tomcat\/lib<\/li>\n<li>If you connect to MSSQL or MySQL, move over the necessary jar files from tomcat7\/lib to tomcat\/lib<\/li>\n<li>Examine server.xml in tomcat7\/conf. Specifically, note the shutdown port, connector port, and contexts. Ensure these changes are made within the server.xml in tomcat\/conf<\/li>\n<li>Ensure that the permission set to \/tomcat\/bin\/catalina.sh allows this file to be executable<\/li>\n<\/ol>\n<p>Once completed, repeat these steps for any other Tomcat instances you may running on the server (ie&#8230;.development, UAT, production, etc)<\/p>\n<h2>Troubleshooting<\/h2>\n<ul>\n<li style=\"list-style-type: circle;margin-left:30px\">If Tomcat does not start, check the logs and see if it is complaining about duplicate entries in your web.xml file. If so, rename your \/mrcjava\/WEB-INF\/web.xml to web7.xml. Then download <a href=\"\/products\/Tomcat9\/web.xml\">this<\/a> blank web.xml file into \/mrcjava\/WEB-INF\/web.xml. Finally, run the conversion process located in \/m-power named update-webxml.bat (as an Administrator) to populate the file.<\/li>\n<li style=\"list-style-type: circle;margin-left:30px\">Any custom entries you made your web.xml will not be brought over in the conversion process. Instead, manually copy and paste the specific entries from web7.xml to web.xml.<\/li>\n<li style=\"list-style-type: circle;margin-left:30px\">If you have any nightly processes that automatically restart Tomcat, ensure they are pointing at the new job name (applicable on windows)<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Instructions for Upgrading to Tomcat 9 Tomcat 9 offers m-Power customers the latest security, performance, and stability improvements. As such this document is designed to give system administrators step by step instructions on how to upgrade from Tomcat 7 to Tomcat 9. Before we begin, please note these instructions are designed for standard installations. If [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":1161,"menu_order":50,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-9234","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/pages\/9234","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/comments?post=9234"}],"version-history":[{"count":17,"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/pages\/9234\/revisions"}],"predecessor-version":[{"id":9252,"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/pages\/9234\/revisions\/9252"}],"up":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/pages\/1161"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/media?parent=9234"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}