intra-mart Accel Platform / 安装指南

第12版 2014-08-01

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

4.4.2. Internet Information Services(IIS)

4.4.2.1. 前提条件

  • 使用在 “系统要求” 中记述的 Windows Server 。
  • 在之后的步骤中虽然使用了 Windows Server 2012 的抓屏图片,但上述任一版本的 Windows Server 都可按照相同步骤安装。
  • 设定基准URL
    需要设定使用 Internet Information Services(IIS) 时的基准URL。

注解

  • 基准URL中会设定 <http或https>://<IIS的IP地址>:<IIS的端口号>/<context路径>
  • 请根据所构筑的服务器环境进行适当设定。
  • 关于基准URL的详细情况,请参照 基础URL
  • 为了使 Internet Information Services(IIS) 工作,需要“ Application Request Routing ”。
    请从下述“ Application Request Routing ”主页下载安装程序并按照以下步骤安装。

注解

URL(2014年8月当前)

4.4.2.1.1. 安装 Application Request Routing

  1. 执行下载的 <ARRv3_0.exe> 。

  2. 点击“安装”。

    ../../../_images/iis_arr_30beta_1.png
  3. 确认前提条件、许可证条款后,点击“同意”。

    ../../../_images/iis_arr_30beta_2.png
  4. 点击“完成”。

    ../../../_images/iis_arr_30beta_3.png
  5. 点击“结束”。

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

    通过以上操作即可完成安装 Application Request Routing 。

4.4.2.2. 设定

  • 进行设定以便连接到 Resin 。
    以下步骤记述了下述假想环境的相关步骤。

    intra-mart Accel Platform 的context路径

    imart

    IIS的根目录

    C:\inetpub\wwwroot

    静态文件的展开文件夹

    C:\imart

    Resin 的IP地址

    192.168.1.1

    Resin 的端口号

    8080

    1. 在 <C:/inetpub/wwwroot> 下生成用于连接 Internet Information Services(IIS) 与 Resin 的设定文件 <web.config> 。

      <?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>
      

      注解

      web.config是 Internet Information Services(IIS) 的配置文件。

      警告

      无法在 IM-Juggling 上编辑web.config文件。
    2. 请对web.config内的下述因素等进行适当变更使之与服务器环境相符。
      • maxRequestLength, maxAllowedContentLength 属性

        • 要变更上传文件的Size限制时,请变更 maxRequestLength,maxAllowedContentLength 属性的设定。(上述例子中是100MB)

      注解

      关于 web.config 的详细说明请参照以下参考内容。
    3. 请在 Internet Information Service(IIS)管理器 按顺序点击“IIS 服务器(此处是WIN-QDQ41RVOU80)”“ Application Request Routing Cache”“打开功能”。
      ../../../_images/iis_arr_config_1.png
    4. 点击“Server Proxy Settings...”,显示“ Application Request Routing ”设定画面。
      ../../../_images/iis_arr_config_2.png
    5. 选择“Enable Proxy”,以秒为单位在“Time-out (seconds)”中设定超时时长。
      进一步点击“应用”,使设定生效。
      ../../../_images/iis_arr_config_3.png

      注解

      “Time-out (seconds)”中设定了到 Application Request Routing 切断与 Resin 的连接为止的超时时长。
      为了完成Tenant环境安装请设定一个充分大的值。
      在此作为例子设定了1200秒的值。
    6. 请确认显示出“已正常保存变更内容。”。
      ../../../_images/iis_arr_config_4.png
    7. 接下来,生成静态文件用的虚拟目录。
      从左侧窗格的 “Default Web Site” 子菜单点击“添加虚拟目录...”。
      ../../../_images/iis_arr_virtualsite_1.png
    8. 在新窗口内将“别名(A)”、“物理路径(P)”设定成如下内容,点击“OK”。

      别名

      imart

      物理路径

      C:\imart

      ../../../_images/iis_arr_virtualsite_2.png
    9. 请确认已生成了“imart”目录。

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

4.4.2.3. 配置静态文件

将从 IM-Juggling 取得的“静态文件”展开到虚拟目录中设定的“物理路径”目录。
关于输出静态文件的详细说明,请参照 输出静态文件

4.4.2.4. 编辑访问日志

使用反向代理时,Resin 输出的 access.log 的源IP地址会全部变成IIS的IP地址。
为回避此问题,可编辑 access.log 的输出内容。
  1. 打开 <%RESIN_HOME%/conf/resin.xml> 文件。

  2. 请在 <host id=”” root-directory=”.”> 指令内添加以下设定,并重新启动 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>
    

    注解

    关于access.log的详细设定内容,请参照“Resin Documentation ”。

4.4.2.5. 动作确认

  1. 启动 Resin 。
    关于 Resin 的详细内容请参照以下说明。
  2. 重新启动 Internet Information Services(IIS) 。

  3. 通过浏览器访问`http://<IIS的IP地址>:<IIS的端口号>/imart/login`,若能显示 intra-mart Accel Platform 的登录画面,则表示设定已完成。

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