intra-mart Accel Platform / Setup Guide

Version 10 2014-04-01

«  4.4.1. Apache HTTP Server   ::   Contents   ::   4.5. Apache Cassandra  »

4.4.2. Internet Information Services(IIS)

4.4.2.1. Prerequisites

  • Setting of Base URL
    In case Internet Information Services(IIS) is used, it is necessary to set the Base URL.

Note

  • For the Base URL, <http or https>://<IIS IP address>:<IIS Port Number>/<Context Path> should be set.
  • Please make the proper settings depending on the server environment to be built.
  • For the details of Base URL, please refer to Base URL.
  • [Application Request Routing] is required to operate Internet Information Services(IIS).
    Please download the installer from the home page of [Application Request Routing] below, and do the setup by the steps below.
    In the following steps, an example of installing Application Request Routing 3.0 to Windows Server 2012 and setting IIS is described.

Note

URL (as of April, 2014)

4.4.2.1.1. Application Request Routing Setup

  1. Execute the downloaded <ARRv3_0.exe>.

  2. Click [Install].

    ../../../_images/iis_arr_30beta_1.png
  3. After checking the prerequisites and licensing terms, please click [Agree].

    ../../../_images/iis_arr_30beta_2.png
  4. Click [Complete].

    ../../../_images/iis_arr_30beta_3.png
  5. Click [Finish].

    ../../../_images/iis_arr_30beta_4.png

    This completes the setup of Application Request Routing.

4.4.2.2. Setting

  • Settings for the connection to Resin should be made.
    In the following steps, descriptions of the steps assume the environment below.

    intra-mart Accel Platform Context Path

    imart

    IIS Root Directory

    C:\inetpub\wwwroot

    Expanded Folder of Static File

    C:\imart

    Resin IP Address

    192.168.1.1

    Resin Port Number

    8080

    1. Create the configuration file <web.config> to connect Internet Information Services(IIS) and Resin immediately under <C:/inetpub/wwwroot>.

      <?xml version="1.0" encoding="UTF-8"?>
      <configuration>
        <system.web>
          <httpRuntime maxRequestLength="102400" requestPathInvalidCharacters="" />
          <customErrors mode="Off" />
        </system.web>
        <system.webServer>
          <security>
            <requestFiltering>
              <requestLimits maxAllowedContentLength="104857600" />
            </requestFiltering>
          </security>
          <httpErrors errorMode="Detailed" />
          <rewrite>
            <rules>
              <clear />
              <rule name="ReverseProxyInboundStatic" stopProcessing="true">
                <match url="^imart/(.*\.gif|.*\.png|.*\.jpg|.*\.css|.*\.js|.*\.swf|.*\.ico|.*\.json|.*\.jar|.*\.xml|.*\.yaml|.*\.txt|.*\.html|.*\.htm)$" />
                <action type="None" />
              </rule>
              <rule name="ReverseProxyInboundDynamic" stopProcessing="true">
                <match url="^imart/(.*)" />
                <action type="Rewrite" url="http://192.168.1.1:8080/imart/{R:1}" />
              </rule>
            </rules>
          </rewrite>
        </system.webServer>
      </configuration>
      

      Note

      web.config is a configuration file of Internet Information Services(IIS).

      Warning

      web.config file cannot be edited on im-Juggling.
    2. Following elements inside the web.config are changed as appropriate according to the server environment.
      • maxRequestLength and maxAllowedContentLength Attributes

        • In order to change the limit of uploaded file size, please change the setting for maxRequestLength and maxAllowedContentLength attributes (100MB in the example above).

      Note

      Please refer to the reference below for the details of web.config.
    3. From Internet Information Service (IIS) Manager, please click [IIS Server(it is WIN-QDQ41RVOU80 here)], [Application Request Routing Cache], [Open Function] sequentially.
      ../../../_images/iis_arr_config_1.png
    4. Click [Server Proxy Settings...], and display the [Application Request Routing] Setting Screen.
      ../../../_images/iis_arr_config_2.png
    5. Check [Enable Proxy], and set the timeout value in seconds to [Time-out (seconds)].
      Then, click [Apply] to reflect the setting.
      ../../../_images/iis_arr_config_3.png

      Note

      In [Time-out (seconds)], timeout period before Application Request Routing disconnects the connection to Resin is set.
      Please set the big enough value for the tenant environment setup to complete.
      Here, 1200 seconds are set as an example.
    6. Please confirm that [Changed contents were successfully saved.] is displayed.
      ../../../_images/iis_arr_config_4.png
    7. Then, the virtual directory for the static file should be created.
      From the [Default Web Site] sub-menu in the Left Pane, click [Add virtual directory ...].
      ../../../_images/iis_arr_virtualsite_1.png
    8. In the new window, please set [Alias(A)] and [Physical Path(P)] as below, and click [OK].

      Alias

      imart

      Physical Path

      C:\imart

      ../../../_images/iis_arr_virtualsite_2.png
    9. Please confirm that the [imart] directory has been created.

      ../../../_images/iis_arr_virtualsite_3.png

4.4.2.3. Placement of Static File

Please expand the [Static File] obtained from im-Juggling to the directory of [Physical Path] which was set in the virtual directory.
For the details about output of static file, please refer to Static File Output.

4.4.2.4. Editing the Access Log

In case of Reverse Proxy, every Source IP of access.log generated by Resin becomes the IP of IIS. In order to avoid this problem, output contents of access.log are edited.

  1. Open the <%RESIN_HOME%/conf/resin.xml> file.

  2. Please add the setting below inside <host id=”” root-directory=”.”> directive, and restart Resin.

    <access-log path='log/access.log'>
      <rollover-period>1D</rollover-period>
      <format>%{X-Forwarded-For}i %h %l %u %t "%r" %>s %b "%{Referer}i" "%{User-Agent}i"</format>
    </access-log>
    

    Note

    For the detail setting contents of access.log, please refer to [Resin Documentation ].

4.4.2.5. Operations Confirmation

  1. Launch Resin.
    Please see below for the details about Resin.
  2. Restart Internet Information Services(IIS).

  3. From the browser, please access http://<IIS IP Address>:<IIS Port Number>/imart/login. Setting is completed, if the log-in screen of intra-mart Accel Platform is displayed.

«  4.4.1. Apache HTTP Server   ::   Contents   ::   4.5. Apache Cassandra  »