{"id":1135992,"date":"2021-02-10T06:53:32","date_gmt":"2021-02-10T14:53:32","guid":{"rendered":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=1135992"},"modified":"2021-02-10T06:53:32","modified_gmt":"2021-02-10T14:53:32","slug":"monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami","title":{"rendered":"Monthly Linux Tip: Setting up Tomcat in an Esri AWS AMI"},"author":10252,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[37501],"tags":[],"industry":[],"product":[36571],"class_list":["post-1135992","blog","type-blog","status-publish","format-standard","hentry","category-administration","product-arcgis-enterprise"],"acf":{"short_description":"To provide tips and tricks on configuring the built-in Tomcat web server in an Esri-provided AWS AMI","flexible_content":[{"acf_fc_layout":"content","content":"

In my previous blog, titled Monthly Linux Tip: Getting Started with an ESRI AWS AMI<\/em>, we discussed tips and tricks on working with Esri AMIs. Today, we will expand upon that and investigate one of the AMIs built-in features; Tomcat! If you have not already done so, please review that blog before continuing with this blog.<\/p>\n

One of the benefits to using an Esri AMI is that Tomcat comes bundled in the image. However, it can be a bit challenging to configure. This blog aims to break down the process of setting up Tomcat in a simple manner. Please find the table of contents below:<\/p>\n

    \n
  1. Where is Tomcat Located?<\/li>\n
  2. Enabling Tomcat User<\/li>\n
  3. Securing Tomcat (Optional)<\/li>\n
  4. Registering Web Adaptor to Tomcat<\/li>\n
  5. Conclusion<\/li>\n<\/ol>\n

    Please be aware that in this blog, I will be using the following Esri AMI:<\/p>\n

    <\/p>\n

    1. Where is Tomcat Located?<\/strong><\/p>\n

    After we have created our Esri AMI and we have properly SSH\u2019ed into it, we ask ourselves, \u201cwhere is Tomcat\u201d? Great question! That is found over in the \/opt<\/em> directory as shown below:<\/p>\n

    <\/p>\n

    Notice how we have directory tomcat_arcgis<\/em> and directory tomcat_arcgis_8.5.45<\/em>. The tomcat_arcgis<\/em> is simply a symbolic link to the tomcat_arcgis_8.5.45<\/em> (i.e. a shortcut to that directory). Navigating into that folder, you may notice that tomcat_arcgis<\/em> is the UID and GID for each folder:<\/p>\n

    <\/p>\n

    Furthermore, trying to navigate into any of these folders gives us bash error Permission denied<\/em>. So what do we do? We have a few ways around this, but simplest way is to enable this tomcat_arcgis<\/em> user.<\/p>\n

    2. Enabling Tomcat User<\/strong><\/p>\n

    \u201cWhat do you mean enable the tomcat_arcgis<\/em> user? Shouldn\u2019t it be enabled by default\u201d? The short answer is no; the tomcat_arcgis<\/em> is not enabled by default. Attempting to switch to that account proves this to be true as shown below:<\/p>\n

    <\/p>\n

    Notice how the shell prompt shows our user still as the ubuntu<\/em> default user. To enable the tomcat_arcgis<\/em> user, all that is needed is to run the following command: usermod -s \/bin\/bash\/ tomcat_arcgis<\/strong>. The reason why the tomcat_arcgis<\/em> user is disabled is because upon AMI creation, it doesn’t not have an existing shell associated with the account. This will modify the tomcat_arcgis<\/em> user\u2019s shell to use Bash, same as our ubuntu<\/em> and arcgis<\/em> users.<\/p>\n

    <\/p>\n

    Now we are successfully logged in as the tomcat_arcgis<\/em> user and we can begin configuring Tomcat to our desired specifications.<\/p>\n

    3. Securing Tomcat (Optional)<\/strong><\/p>\n

    Now that you have access to the tomcat_arcgis<\/em> user, you can proceed forward with registering the ArcGIS Web Adaptor. However, doing so would mean that we have not secured our Tomcat web server to use secure communication. Additionally, you may wish to configure Tomcat in specific ways to meet your specific needs.<\/p>\n

    We won\u2019t look at different ways to handle configuration of the web server as it can vastly differ. Rather, it is important to note that should you go into production with this AMI, it is highly recommended<\/strong> that you secure your web server.<\/p>\n

    4. Registering Web Adaptor to Tomcat<\/strong><\/p>\n

    Now as our final test, we are ready to attempt registering our Web Adaptor! In this blog, I have a standalone ArcGIS Server that is licensed and configured already. First, I need to switch over to the arcgis<\/em> user and navigate to \/arcgis\/webadaptor10.8\/java\/tools<\/em>. Please see below:<\/p>\n

    <\/p>\n

    Once here, we will run the configurewebadaptor.sh<\/em> script. If you\u2019re not too familiar with how to run the tool, the usage help will assist you. Simply run command .\/configurewebadaptor.sh -h<\/strong> to bring up the usage help. Let\u2019s run the tool and see if we can successfully register the Web Adaptor:<\/p>\n

    <\/p>\n

    Success! To validate we are good to go, attempt accessing your ArcGIS Server in a browser via the Web Adaptor:<\/p>\n

    <\/p>\n

    As shown in the above screen capture, yes, we are successful! Again, it is important to note that this is simply a demonstration environment. Environments in production will utilize certificates to ensure proper encryption and secure communication is met.<\/p>\n

    5. Conclusion<\/strong><\/p>\n

    In this blog, we went over tips and tricks on how to setup the bundled Tomcat web server in an Esri AWS AMI. Please let me know in the comments if this was helpful to you and what content you would like to see for next month. Thank you for reading this Monthly Linux Tip!<\/p>\n"}],"authors":[{"ID":10252,"user_firstname":"Markus","user_lastname":"Walker","nickname":"MWalker","user_nicename":"mwalker","display_name":"Markus Walker","user_email":"MWalker@esri.com","user_url":"","user_registered":"2019-12-03 14:04:26","user_description":"Markus is a Product Engineer on the ArcGIS Enterprise team, where he specializes with Linux architectures.","user_avatar":""}],"related_articles":"","card_image":false,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/01\/ArcGIS-Enterprise-wide.jpg"},"yoast_head":"\nMonthly Linux Tip: Setting up Tomcat in an Esri AWS AMI<\/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:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Monthly Linux Tip: Setting up Tomcat in an Esri AWS AMI\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami\" \/>\n<meta property=\"og:site_name\" content=\"ArcGIS Blog\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/esrigis\/\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@ESRI\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":[\"Article\",\"BlogPosting\"],\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami\"},\"author\":{\"name\":\"Markus Walker\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/457f3d786c7c12c3d37d57b3d6f2702f\"},\"headline\":\"Monthly Linux Tip: Setting up Tomcat in an Esri AWS AMI\",\"datePublished\":\"2021-02-10T14:53:32+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami\"},\"wordCount\":11,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#organization\"},\"articleSection\":[\"Administration\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami\",\"name\":\"Monthly Linux Tip: Setting up Tomcat in an Esri AWS AMI\",\"isPartOf\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#website\"},\"datePublished\":\"2021-02-10T14:53:32+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.esri.com\/arcgis-blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Monthly Linux Tip: Setting up Tomcat in an Esri AWS AMI\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#website\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/\",\"name\":\"ArcGIS Blog\",\"description\":\"Get insider info from Esri product teams\",\"publisher\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.esri.com\/arcgis-blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#organization\",\"name\":\"Esri\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png\",\"contentUrl\":\"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png\",\"width\":400,\"height\":400,\"caption\":\"Esri\"},\"image\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/esrigis\/\",\"https:\/\/x.com\/ESRI\",\"https:\/\/www.linkedin.com\/company\/5311\/\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/457f3d786c7c12c3d37d57b3d6f2702f\",\"name\":\"Markus Walker\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/04\/31161cb9-c3aa-493e-8ff2-5b3a3ff46361-213x200.jpg\",\"contentUrl\":\"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/04\/31161cb9-c3aa-493e-8ff2-5b3a3ff46361-213x200.jpg\",\"caption\":\"Markus Walker\"},\"description\":\"Markus is a Product Engineer on the ArcGIS Enterprise team, where he specializes with Linux architectures.\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/author\/mwalker\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Monthly Linux Tip: Setting up Tomcat in an Esri AWS AMI","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:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami","og_locale":"en_US","og_type":"article","og_title":"Monthly Linux Tip: Setting up Tomcat in an Esri AWS AMI","og_url":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami","og_site_name":"ArcGIS Blog","article_publisher":"https:\/\/www.facebook.com\/esrigis\/","twitter_card":"summary_large_image","twitter_site":"@ESRI","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":["Article","BlogPosting"],"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami#article","isPartOf":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami"},"author":{"name":"Markus Walker","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/457f3d786c7c12c3d37d57b3d6f2702f"},"headline":"Monthly Linux Tip: Setting up Tomcat in an Esri AWS AMI","datePublished":"2021-02-10T14:53:32+00:00","mainEntityOfPage":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami"},"wordCount":11,"commentCount":0,"publisher":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#organization"},"articleSection":["Administration"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami","url":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami","name":"Monthly Linux Tip: Setting up Tomcat in an Esri AWS AMI","isPartOf":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#website"},"datePublished":"2021-02-10T14:53:32+00:00","breadcrumb":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/administration\/monthly-linux-tip-setting-up-tomcat-in-an-esri-aws-ami#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.esri.com\/arcgis-blog\/"},{"@type":"ListItem","position":2,"name":"Monthly Linux Tip: Setting up Tomcat in an Esri AWS AMI"}]},{"@type":"WebSite","@id":"https:\/\/www.esri.com\/arcgis-blog\/#website","url":"https:\/\/www.esri.com\/arcgis-blog\/","name":"ArcGIS Blog","description":"Get insider info from Esri product teams","publisher":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.esri.com\/arcgis-blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.esri.com\/arcgis-blog\/#organization","name":"Esri","url":"https:\/\/www.esri.com\/arcgis-blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png","contentUrl":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png","width":400,"height":400,"caption":"Esri"},"image":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/esrigis\/","https:\/\/x.com\/ESRI","https:\/\/www.linkedin.com\/company\/5311\/"]},{"@type":"Person","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/457f3d786c7c12c3d37d57b3d6f2702f","name":"Markus Walker","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/image\/","url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/04\/31161cb9-c3aa-493e-8ff2-5b3a3ff46361-213x200.jpg","contentUrl":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/04\/31161cb9-c3aa-493e-8ff2-5b3a3ff46361-213x200.jpg","caption":"Markus Walker"},"description":"Markus is a Product Engineer on the ArcGIS Enterprise team, where he specializes with Linux architectures.","url":"https:\/\/www.esri.com\/arcgis-blog\/author\/mwalker"}]}},"text_date":"February 10, 2021","author_name":"Markus Walker","author_page":"https:\/\/www.esri.com\/arcgis-blog\/author\/mwalker","custom_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/01\/ArcGIS-Enterprise-wide.jpg","primary_product":"ArcGIS Enterprise","tag_data":[],"category_data":[{"term_id":37501,"name":"Administration","slug":"administration","term_group":0,"term_taxonomy_id":37501,"taxonomy":"category","description":"","parent":0,"count":422,"filter":"raw"}],"product_data":[{"term_id":36571,"name":"ArcGIS Enterprise","slug":"arcgis-enterprise","term_group":0,"term_taxonomy_id":36571,"taxonomy":"product","description":"","parent":0,"count":972,"filter":"raw"}],"primary_product_link":"https:\/\/www.esri.com\/arcgis-blog\/?s=#&products=arcgis-enterprise","_links":{"self":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/blog\/1135992","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/blog"}],"about":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/types\/blog"}],"author":[{"embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/users\/10252"}],"replies":[{"embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/comments?post=1135992"}],"version-history":[{"count":0,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/blog\/1135992\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/media?parent=1135992"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/categories?post=1135992"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/tags?post=1135992"},{"taxonomy":"industry","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/industry?post=1135992"},{"taxonomy":"product","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/product?post=1135992"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}