Apache Tomcat, CGI and Tcl

最近使用 Apache Tomcat 在測試一些東西，所以同時也測試一下如何設定 CGI 以執行 Tcl CGI scrpits 的設定。

預設中 CGI 是 disable 的。在 Apache Tomcat 下使用 Tcl 來撰寫 CGI 程式，需要設定 conf/web.xml 與 conf/context.xml。 可以參考 Apache Tomcat 的文件。

首先要設定 web.xml，開啟 CGIServlet 的支援，並且設定執行的程式。 如果是修改 conf/web.xml，那效果是全域性的。如果修改 WEB-INF/web.xml，就只侷限在你的 web application。

    <servlet>
        <servlet-name>cgi</servlet-name>
        <servlet-class>org.apache.catalina.servlets.CGIServlet</servlet-class>
        <init-param>
          <param-name>cgiPathPrefix</param-name>
          <param-value>WEB-INF/cgi</param-value>
        </init-param>
        <init-param>
          <param-name>executable</param-name>
          <param-value>/usr/bin/tclsh</param-value>
        </init-param>        
        <load-on-startup>5</load-on-startup>
    </servlet>

與 URL mapping：

    <servlet-mapping>
        <servlet-name>cgi</servlet-name>
        <url-pattern>/cgi-bin/*</url-pattern>
    </servlet-mapping>

再來是 context.xml，設定 Context 的 privileged 屬性為 true（但是要注意，這樣的更改是全域設定）：

<Context privileged="true">

在 webapps/ROOT/WEB-INF 目錄中建立一個新的目錄 cgi。 接下來將我們的 Tcl CGI script 放在 cgi 目錄就可以了。舉例來說，如果是 hello.tcl，網址就是：

http://localhost:8080/cgi-bin/hello.tcl

如果不要在根目錄，舉例來說，可以在 webapps 下建立一個目錄 myapp，myapp 目錄下再建立一個目錄 WEB-INF， 然後 WEB-INF 目錄下再建立目錄 cgi。

接下來將我們的 Tcl CGI script 放在 cgi 目錄，如果正確設定就可以執行。舉例來說，如果是 hello.tcl，網址就是：

http://localhost:8080/myapp/cgi-bin/hello.tcl