Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

This section helps you to deploy Adeptia Connect UI on Tomcat. Before start deploying, stop Tomcat.

To deploy:

  1. Extract the war Adeptia Connect zip file. 
  2. Open the extracted folder and copy Root.war to

    <TomcatInstallFolder>

    .../TomcatInstallFolder>/Tomcat 9.0/webapps.

    Info
    titleImportant

    Make sure that you are installing the Adeptia Suite and war file together while you install Adeptia Connect. The versions of Suite and war file has to be same, else the installation won't work.

  3. Delete the existing ROOT folder.
  4. Start Tomcat. A new ROOT folder is created.
  5. Go to ROOT > WEB-INF.
  6. Open web.xml in the Text Editor and do the following:
  7. Set the path where Tomcat is installed in the app.working.dir.path in the <param-value> parameter.
  8. Save the file.
    Image Removed
  9. Now, from the extracted war folder, copy the resources folder and paste in the directory where Tomcat is installed. For example, C:\Program Files\Apache Software Foundation\Tomcat 9.0.
  10. Open the resources folderCreate a folder named Working_Directory in the .../TomcatInstallFolder>/Tomcat 9.0/webapps.
  11. Copy resources_config folder from the extracted folder and paste it to the Working_Directory folder created in step 5.
  12. Go to .../TomcatInstallFolder>/Tomcat 9.0/bin.
  13. Double-click tomcat9w.exe.
  14. Anchor
    Java_Options
    Java_Options
    On the Java tab, in the Java Options group, add the below line:

    -Dapp.working.dir.path= Tomcat Working Directory Path

    For example,

    -Dapp.working.dir.path=D:/Program Files/Apache Software Foundation/Tomcat 9.0/webapps/Working_Directory

     

    Image Added

  15. Click Apply.
  16. Click OK.
  17. Anchor
    Application_Properties
    Application_Properties
    Go to .../TomcatInstallFolder>/Tomcat 9.0/webapps/Working_Directory/resources_config.
  18. Open application.properties file in the Text Editor and do the following:
    1. Set the IP address or domain name where Adeptia Suite is running in

    the
    1. the app.

    base.
    1. adeptia.

    url and app.adeptia.
    1. host.url.

      The URL format for app.

    base
    1. adeptia.

    adeptia
    1. host.url is

    1. <protocol_name>://<IP_Address or domain_name>:<port_no>/
    adeptia/rest

    The URL format for app.adeptia.host.url is

    <protocol_name>://<IP_Address:<port_no> 
    1. where, 

    <protocol
    1.            <protocol_name> is the name of the protocol you are using

    . For
    1. , for example,

    http
    1. HTTP or

    https
    1. HTTPS.

    <IP
    1.            <IP_Address> is the IP address of the computer on which Adeptia Suite is running.

    <port
    1.  For a clustered environment, provide the IP address or domain name of the load balancer.

                 <port_no> is the port number of the computer on which Adeptia Suite is running.

      Info
      For
    example,https
    1. Adeptia Connect v 2.1, you only need to set the IP address in the app.adeptia.host.url.

      For example, http://10.0.0.125:

    8443/adeptia/rest
    http://10.0.0.125:8080

    Make sure that IP address is same in both URLs.

    Image Removed
    Restart Tomcat
    1. 8080/

       

    2. Set the IP address or domain name where Tomcat is running in the app.connect.domain.

      The URL format is:

      <IP_Address or domain_name>:<port_no>.

      where,

                 <IP_Address or domain_name> is the IP address or domain name of the computer on which Tomcat is running. For a clustered environment, provide the IP address or domain name of the load balancer.

                 <port_no> is the port number of the computer on which Tomcat is running.

      Image Added

     

  19. Restart Tomcat.

    Info
    For a clustered environment, deploy Adeptia Connect UI on Tomcat on other nodes following the same steps.

Next Step

Verifying Deployment