在Sas IntrNet Module很多功能都是需要用到CGI(Common Gateway Interface)進行工作。在使用CGI進行工作時候,我們首先要進行CGI服務器的配置。一般情況下可以直接使用Apache來架設CGI服務器。由于我們后期的一些應用可能是在JEE平臺上進行開發,所以在一個可以運行Web Container的Server 上架設CGI服務是有必要的。本文將介紹如何在Tomcat下配置CGI服務。
要為Tomcat配置CGI服務主要有下面幾個步驟:
1. 把servlets-cgi.renametojar (在%CATALINA_HOME%/server/lib/目錄下)改名為servlets-cgi.jar。
2. 在Tomcat的%CATALINA_BASE%/conf/web.xml 文件中,把關于<servlet-name> CGI的那段的注釋去掉。內容樣式如下:
<servlet>
<servlet-name>cgi</servlet-name>
<servlet-class>org.apache.catalina.servlets.CGIServlet</servlet-class>
<init-param>
<param-name>debug</param-name>
<param-value>0</param-value>
</init-param>
<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>C:/Perl/bin/Perl.exe</param-value>
</init-param>
<load-on-startup>5</load-on-startup>
</servlet>
其中參數executable需要自已添加進去,它的值就是我們用來解釋CGI腳本的程序。一般情況下這里會配置為Perl。"C:/Perl/bin/"為Perl的安裝目錄。
3. 在Tomcat的%CATALINA_BASE%/conf/web.xml文件中,把關于對CGI進行映射的那段的注釋去掉。內容樣式如下:
<servlet-mapping>
<servlet-name>cgi</servlet-name>
<url-pattern>/cgi-bin/*</url-pattern>
</servlet-mapping>
其中url-pattern就是將來我們訪問CGI腳本的url地址模式。
完成上面三個步驟后,我們的Tomcat服務器就具有了運行CGI腳本的能力了。
為了測試CGI服務,需要新建一個Web Project。并在WEB-INF目錄下新建一個名為"cgi"的目錄,CGI腳本將放置在這個目錄下。這里提供了一個用于測試CGI腳本printenv.pl|^printenv.pl 。Deloy the web project。啟動Tomcat后,我們就可以通過http://localhost:8080/projectName/cgi-bin/printenv.pl 訪問了。
如果訪問成功,頁面將顯示如下的類似信息。
AUTH_TYPE=""
CONTENT_LENGTH=""
CONTENT_TYPE=""
GATEWAY_INTERFACE="CGI/1.1"
HTTP_ACCEPT="image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/x-shockwave-flash, application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword, application/x-silverlight, */*"
HTTP_ACCEPT_ENCODING="gzip, deflate"
HTTP_ACCEPT_LANGUAGE="zh-cn"
HTTP_CONNECTION="Keep-Alive"
HTTP_HOST="localhost:8080"
HTTP_USER_AGENT="Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)"
PATH_INFO=""
QUERY_STRING=""
REMOTE_ADDR="127.0.0.1"
REMOTE_HOST="127.0.0.1"
REMOTE_IDENT=""
REMOTE_USER=""
REQUEST_METHOD="GET"
REQUEST_URI="/sasIntrNet/cgi-bin/printenv.pl"
SCRIPT_NAME="/sasIntrNet/cgi-bin"printenv.pl"
SERVER_NAME="localhost"
SERVER_PORT="8080"
SERVER_PROTOCOL="HTTP/1.1"
SERVER_SOFTWARE="TOMCAT"
X_TOMCAT_SCRIPT_PATH="D:"Program Files"apache-tomcat-5.5.17"webapps"sasIntrNet"WEB-INF"cgi"printenv.pl"
這個腳本主要打印當前CGI的一些環境變量出來。
1、《Apache Tomcat 5.5 Servlet/JSP 容器 怎樣使用CGI》http://tomcat.jaxmao.org/cgi-howto.html
2、《Tomcat配置技巧Top 10》 http://www.pconline.com.cn/pcedu/empolder/wz/webserver/0502/549840_3.html
對于上文的補充說明:
當我們要在Tomcat的CGI 服務上跑SAS IntrNet 服務的時候,需要對上文的配置作一定的修改。首先Sas IntrNet的Dispatcher 模塊用來接收Browers請求的broke.exe文件只是一個普通的Windows Win32可執行文件,并不是Perl腳本。(可以在Console環境下直接運行broker.exe文件。)基于上面的認識所以Servlet的executable參數不能配置使用Perl來運行,應該改成為如下命令。
<init-param>
<param-name>executable</param-name>
<param-value>cmd /c</param-value>
</init-param>
其中,"cmd /c"正是windows的系統命令,調用console。具體參數/c,使用/?開關進行查看。
此外,Sas IntrNet 應用還需要系統的環境變量等信息,所以需要再多加配置一個參數。
<init-param>
<param-name>passShellEnvironment</param-name>
<param-value>true</param-value>
</init-param>
完整的servlet配置如下
<servlet>
<servlet-name>cgi</servlet-name>
<servlet-class>org.apache.catalina.servlets.CGIServlet</servlet-class>
<init-param>
<param-name>debug</param-name>
<param-value>0</param-value>
</init-param>
<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>cmd /c</param-value>
</init-param>
<init-param>
<param-name>passShellEnvironment</param-name>
<param-value>true</param-value>
</init-param>
<load-on-startup>5</load-on-startup>
</servlet>