發表者討論內容

冷日
(冷日) 發表時間：2005/9/27 3:29

Webmaster

註冊日: 2008/2/19
來自:
發表數: 15773

[自創]AWStats on Windows Over IIS

再補一篇！
雖然AWStats的網站有教你怎麼幫IIS做分析，但冷日發現，重點不在於AWStats的安裝！
因為只要你安裝過AWStats，你就會發現事實上差不多啦！
Perl寫的東西就是這一點好，沒有太大的安裝瓶頸：系統相依性低、安裝過程簡易、僅需注意環境設定等等。
但是ㄋㄟ，問題來了，Windows上預設是沒有Perl可以使用的！

所以首先請先安裝perl！
一開始，你要先安裝 Perl for Win32 套件，你可以在 http://www.activeperl.com/ 下載，我所使用的版本是 ActivePerl-5.8.7.813-MSWin32-x86-148120.msi 這一個安裝檔，如果你所下載的是更新的版本當然也沒有問題。
安裝完成後， activeperl 應該會幫你把環境變數設好，而且在2003上還不用重開機喔(不過冷日還是建議重開機一下比較好，以保證環境變數有生效)！

其次就是去抓AWStats的Windows版本回來安裝啦！
各位可以到AWStats下載最新版本的AWStats，冷日使用的是6.4，若有新版本的話，應該是可行的，但請小心perl的版本要求！
安裝過程中，若沒抓到你的perl環境變數，則AWStats會出現提示訊息，請回頭檢查你的perl安裝！
在安裝的最後一步中，AWStats會出現如下訊息：

----- AWStats awstats_configure 1.0 (build 1.4) (c) Laurent Destailleur -----
This tool will help you to configure AWStats to analyze statistics for
one web server. You can try to use it to let it do all that is possible
in AWStats setup, however following the step by step manual setup
documentation (docs/index.html) is often a better idea. Above all if:
- You are not an administrator user,
- You want to analyze downloaded log files without web server,
- You want to analyze mail or ftp log files instead of web log files,
- You need to analyze load balanced servers log files,
- You want to 'understand' all possible ways to use AWStats...
Read the AWStats documentation (docs/index.html).

-----> Running OS detected: Windows

-----> Check for web server install
awstats_configure did not find your Apache web main runtime.

Please, enter full directory path of your Apache web server or
'none' to skip this step if you don't have local web server or
don't have permission to change its setup.
Example: c:Program filesapache groupapache
Apache Web server path ('none' to skip):
>

因為我們現在不是使用apache，是要做IIS的log分析，所以請輸入"none"！
輸入完成後，則會出現如下的問題：

Your web server config file(s) could not be found.
You will need to setup your web server manually to declare AWStats
script as a CGI, if you want to build reports dynamically.
See AWStats setup documentation (file docs/index.html)

-----> Update model config file 'D:/Program Files/AWStatswwwrootcgi-binawstat
s.model.conf'
  File awstats.model.conf updated.

-----> Need to create a new config file ?
Do you want me to build a new AWStats config/profile
file (required if first install) [y/N] ?

此處請輸入"Y"，除非你已經不是第一次安裝，AWStats會依照你的路徑格式幫你建立屬於你的新範例設定檔！
如果你是輸入"Y"的話，AWStats會問妳你的網站名稱，可以直接給簡名，不一定要DNS的全名(ex:coolsun)！
然後再來AWStats會要求你按"Enter"繼續下一步，再按一次"Enter"以結束設定程序(也就是輸入"Y"以後，還有兩次"ENTER"要按啦)！

再來就請依照AWStats的說明將你的AWStats設定好：

B) Setup for Microsoft's IIS server

* Step 1:

Configure IIS to log in the "Extended W3C log format" (You can still use your own custom log format but setup is easier if you use the standard extended format). To do so, start the IIS management console snap-in, select the appropriate web site and open its Properties. Choose "W3C Extended Log Format", then Properties, then the Tab "Extended Properties" and uncheck everything under Extended Properties. Once they are all cleared, check just the following fields:
date
time
c-ip
cs-username
cs-method
cs-uri-stem
cs-uri-query
sc-status
sc-bytes
cs-version
cs(User-Agent)
cs(Referer)


To be sure the log format change is effective, you must stop IIS, backup (if desired) and remove all old log files, restart IIS and go to your homepage. This is an example of the type of records you should find in the new log file:
2000-07-19 14:14:14 62.161.78.73 - GET / 200 1234 HTTP/1.1 Mozilla/4.0+(compatible;+MSIE+5.01;+Windows+NT+5.0) http://www.from.com/from.htm

冷日：IIS的LOG可以改為"NCSA通用記錄格式"，所以 step 1 參考看看就好！

* Step 2:
Copy the contents of the AWStats provided cgi-bin folder from where your AWStats package put it on your local hard drive to your server's cgi-bin directory (this includes awstats.pl, awstats.model.conf, and the lang, lib and plugins sub-directories).

冷日：不需要把執行檔COPY出來，直接在你的網站"新增虛擬目錄"就好了，虛擬目錄的路徑可以指到cgi-bin，也可以只到上一層的wwwroot！

* Step 3:
Move AWStats icon sub-directories and its content into a directory readable by your web server, for example C:yourwwwrooticon.

冷日：因為採虛擬路徑，所以這裡可以不用管他，不過這樣的話，設定檔(conf)裡面就要設定對喔，不然會看不到圖片！

* Step 4:
Create a configuration file by copying awstats.model.conf to a new file named awstats.mysite.conf where "mysite" is a value of your choice but usually is the domain or virtual host name. This new file must be saved in the same directory as awstats.pl (i.e. cgi-bin).

冷日：因為你在安裝時有選擇建立新範例設定檔，所以不需要去找awstats.model.conf，請直接找(預設路徑在C:Program FilesAWStatswwwrootcgi-bin，也就是你的AWStats安裝路徑裡的wwwrootcgi-bin)你的新範例設定檔(ex:awstats.coolsun.conf)然後編輯它。

* Step 5:
Edit your new awstats.mysite.conf file to match your specific environment:
- Change the LogFile value to the full path of your web server log file (You can also use a relative path from your awstats.pl (cgi-bin) directory).
- Change the LogType value to "W" for analyzing web log files.
- Change the LogFormat to 2 if you are using the "Extended W3C log format" described in step 1; in the case of a custom format, list the IIS fields being logged, for example:
LogFormat="date time c-ip cs-username cs-method cs-uri-stem cs-uri-query sc-status sc-bytes cs-version cs(User-Agent) cs(Referer)"
- Change the DirIcons parameter to reflect relative path of icon directory.
- Set the SiteDomain parameter to the main domain name or the intranet web server name used to reach the web site being analyzed (Example: www.mydomain.com).
- Set the AllowToUpdateStatsFromBrowser parameter to 1 if you don't have command line access and have only cgi access.
- Review and change other parameters if appropriate.

Installation and configuration is finished. You can jump to the Process logs: Building/Updating statistics database section.

冷日：
IIS預設的LOG檔放在"C:/WINDOWS/system32/LogFiles/W3SVC711240930/"資料夾(這是2003，若是2000或是NT的話則在"C:/WINNT/system32/LogFiles/)，詳細位置請參閱IIS的設定！
如果你是選擇NCSA的LOG記錄格式，檔名應該是長這樣"nc%YY-24%MM-24%DD-24.log"。
LogType預設就是"W"不用理他！
如果你是用NCSA的LOG記錄格式，LogFormat請設為4，若不是的話，請參考上述原文的範例！
DirData、DirCgi、DirIcons等目錄要注意，先用預設的，若不會動，請再考慮要如何更改！
ex: DirData="." 資料(conf)存放路徑
ex: DirCgi="./cgi-bin" CGI的執行路徑
ex: DirIcons="../icon" ICON存放的路徑
SiteDomain的設定要看你安裝的時候是否有要系統幫你build設定檔，請給和那時候給的簡名一樣的名字(ex:coolsun)！
最後則是建議AllowToUpdateStatsFromBrowser把它設成1，這樣就會再網頁上多出一鍋"立即更新"的按鈕，你就不一定要設"排定的工作"了！

接著，還是要來回頭設定perl的部份：
請到你的網際網路服務設定(IIS)管理員，點開你所設定的網站，在該名稱上點選滑鼠右鍵->內容，其中會看到一個"主目錄"頁籤，按下啟動點的"設定"按鈕，在"對應"標籤裡的"快取ISAPI擴充程式"內"應用程式副檔名"新增一個 CGI 程式，按下"新增"，在"執行檔"下填入 Perl 的徑及參數。 (C:Perlinperl.exe "%s" %s) <== 不包含 ( ) Extension 處填上 ".cgi"，這個意思是說，所有副檔名為 .cgi 的都當作是 CGI 程式，由 C:Perlinperl.exe 來執行，後面的 "%s" %s 用來傳遞 IIS 給 Perl.exe 的參數使用，所以不要漏掉了。
別急，它現在還不能跑 Perl 程式，在 IIS 中，你還必需到"網頁服務延伸"(也在網際網路資訊服務(IIS)管理員 ) 裡作設定，開啟 "網頁服務延伸" 項，按右鍵 "新增網頁服務延伸"，"延伸名稱" 填入 PERL，按下新增鈕，接著我們在 "新增檔案" 的 "檔案路徑" 一樣填入 C:Perlinperl.exe "%s" %s，然後出來，選 PERL 那一項，按下 "允許" 鈕，如此你用 Perl 作為 CGI 程式的解釋器才會被 IIS 認可，而這也是在 Windows 2003 Server 上安裝的關鍵處 (安裝 PHP 時也相同)。
但就冷日的經驗， activeperl 應該會幫你新增好該路徑，你只需要把它"允許"就好了！

然後這後面還有一篇老共寫的文章，大家也可以參考看看：

Perl開發環境在WINNT下安裝和配置

Sep 8,2003 Farhill

Perl是一種深受世界各地開發者喜愛的實用摘要和報表語言，雖然它是在Unix上誕生和發展起來的，但在Windows編程領域也已經佔有一席之地。

一、概述

在ActiveState等公司的領導之下，從1995年中期開始Perl開始了穩定地發展，不僅增加了標準的Perl功能，而且增加了許多面向Windows的功能，比如OLE和COM集成等。

事實上，到目前為止所有Perl程序員都已經能夠確信，自己為UNIX服務器寫的Perl應用移植到Windows服務器後同樣能夠流暢、穩定地運行，即使是fork實現這類長期以來最令人頭疼的移植問題也已經得到解決。

而且我們有理由相信，Perl/Windows集成還將進一步發展。自Windows版Perl開發初期開始Microsoft已經成為它的主要資助者，這
一事實足以證實Microsoft所承諾的對Perl的支持。按照最近Microsoft和ActiveState所簽署的為期三年的投資協議，Perl 無疑將成為未來Windows發展的一部分。

如果你正在尋找有關Windows版Perl的更多信息，你可以從網絡上找到許多優秀的網站，其中包括：

ActiveState
　　Perl.com
　　Aldo Calpini&single;s Perl Lab
　　Roth Consulting Perl Page
　　Evangelo Prodromou&single;s Win32 Perl FAQ
　　Robin&single;s Perl for Win32 Page

無論你是想在Windows操作系統上學習Perl語言的核心功能，還是想了解下面這類面向Windows的Perl集成工具，你都必須從同一個地方開始，這就是在Windows上安裝Perl：

用Perl操作OLE（object linking and Embedding，對象鏈接和嵌入），
　　通過Perl管理Windows註冊表，
　　用Perl編寫COM對象（Component Object Model，組件對象模型），
　　在Perl程序裡和其他COM對象通信，
　　利用Perl腳本實現IIS環境下的動態網頁
　　本文是一個如何在Windows上安裝和配置Perl開發環境的指南。

不
過在正式開始之前，我們必須先聲明一點，這就是安裝Perl並不是「點擊一下就完成」這樣的簡單過程，相反，為Windows增加Perl支持是一個反覆循環的過程。由於Perl語言本身有著難以置信的發展活力，不僅其核心語言處於變化過程中，新的發行版本定期地出現，而且有眾多Perl開發者不斷地通過 CPAN之類的資源收集網站發布免費新工具，因此，「安裝」還意味著定期地升級和密切地關注Perl的最新發展。

前面已經提到，Perl Windows版的核心組織是ActiveState，它的主頁是http://www.activestate.com。

Perl Windows版可以從ActiveState網站下載，產品的名字是ActivePerl可以從http: //www.activestate.com/ActivePerl/download.htm直接下載。如果你的網速較慢，你最好在書店裡買一本 Perl5.0以上的教材，裡面的CD有安裝文件，還有較為豐富的樣例。

另外，正如下載頁面所指出的，在Windows 95上安裝這個軟件包還需要DCOM支持，DCOM可以在Microsoft 網站找到。用HTTP或FTP下載都是一樣的，無論用哪種方法都可以。

下載完成後，你會得到一個自己解壓縮的執行文件，只需雙擊這個執行文件即可開始安裝。

必須指出的是，如果系統中已經安裝了Perl而且進行新的安裝時某個進程正在使用它，新的安裝過程可能不能正常進行，你將會看到一個警告信息窗口。

如果發生了這種情況，你應該立即結束安裝過程，關閉所有可能使用Perl的服務/應用，然後再次安裝。

如果你使用的是Windows NT，無法確定哪些服務正在使用Perl，可以打開「開始＝》設置＝》控制面板＝》服務」，檢查系統所顯示的服務列表，找出那些可能正在使用Perl的服務。關閉這些服務，然後重新開始安裝。

當然大多數用戶不需擔心這問題。實際上，很有可能當你雙擊自動解壓縮執行文件後就會看到ActiveState的許可協議聲明。

閱讀並接受許可協議之後，你將看到「Installation Notes」窗口，這個窗口向用戶提示ActivePerl所有可用的安裝選項。說明文檔包含多個標題，每個標題各有詳細的解釋。這些標題包括：

把Perl的bin目錄加入搜索路徑
　　在Windows資源管理器中關聯「.pl」擴展名和Perl.exe
　　為Web服務器關聯「.pl」和Perl.exe
　　為IIS的ISAPI關聯「.plx」和Perl
　　

二、安裝過程

在安裝cgi腳本之前，請做好下述準備工作，否則腳本無法正常運行。

1、安裝IIS ，即Internet信息服務組件

如果你是在 Win2000 sever 或 WINNT sever上安裝CGI腳本，那麼請跳過這一步，因為它們已經自帶IIS。
如果是在Windows 2000 Professional，那麼請從這一步開始，因為Windows 2000 Professional沒有默認安裝Internet 信息服務（即IIS），我們必須先安裝好IIS。

另外請注意，如果系統是升級到 Windows 2000，那麼只有在 Windows 的先前版本中安裝了 PWS，IIS 5.0 才會默認安裝。

如果你搞不清你的系統是否已帶IIS，怎麼區分它們呢？方法有二：

方法1）到「控制面板」＝》「管理」＝》尋找是否有「IIS 管理工具」。
　　方法2) 到「控制面板」＝》「添加/刪除程序」＝》「Windows 組件」，看看 IIS 是否已安裝。

安裝步驟：

1.1、"我的電腦"＝》控制面板＝》添加／刪除程序＝》添加／刪除windows組件＝》選中"Internet信息服務(IIS)"前面的小框＝》點擊"下一步"，然後按照提示操作，將IIS安裝完成。

1.2、安裝IIS後，打開IE，在地址欄輸入http：//your-domain/,回車確認。會出現Microsoft IIS的頁面，證明IIS安裝成功。

2、安裝InstMsi.exe程序

如果是在win2000下，請跳過這一步。

如果是在winnt下，請一定要做這一步。在NT下，必須先安裝 Windows 的程序安裝器（Installer for the Windows Installer） InstMsi.exe ，否則無法進行下一步的ActivePerl安裝。

2.1、獲得for WINNT 的 Windows程序安裝器：InstMsi.exe

有2種方法可以獲得 InstMsi.exe ：

在Winnt的安裝光盤裡搜索到 InstMsi.exe 文件
下載 for WINNT 的 InstMsi.exe 程序到硬盤
下載地址：http：//activestate.com/Products/ActivePerl/index.html
http：//download.microsoft.com/download/WindowsInstaller/Install/2.0/NT45/EN-US/InstMsi.exe

2.2、雙擊InstMsi.exe，按照提示將它安裝完成。

2.3、重啟計算機。

3、安裝ActivePerl

3.1、下載ActivePerl到硬盤

國外下載：http：//www.activestate.com

　　國內下載：http：//www.onlinedown.net/ActivePerl.htm

3.2、安裝ActivePerl。雙擊它，按提示操作即可（可自選一個安裝路徑）。

系統會提示選擇四項安裝配置：

Add Perl to the PATH environment variable #更改Perl的路徑加到系統路徑中　
Create Perl file extension associate #建立Perl文件的文件關聯（缺省的擴展名是pl）
Create IIS script mapping for Perl #建立IIS腳本映射到Perl
Create IIS script mapping for Perl #ISAPI #建立IIS腳本映射到Perl ISAPI

請將上述4項全部選中。

3.3、安裝完ActivePerl後，重啟計算機。

4、設置虛擬目錄

在IIS的默認設置下，在系統根目錄下的inetpub目錄下面，有一個用來放置可執行腳本的目錄scripts。但是ISP也有可能將IIS的這個設置修改了。那麼我們就需要自己建立和設置一個可執行的虛擬目錄，用來放入要運行的cgi腳本。

4.1、在硬盤的任何一個路徑下，新建一個文件夾（名稱任意，但最好不要在系統盤新建目錄）。

如：F:cgi-bin，在F盤下，新建一個叫做cgi-bin的文件夾。如圖：

4.2、打開IIS服務器

從「開始」＝》「設置」＝》「控制面板」＝》「管理工具」＝》「Internet服務管理器」

出現IIS的界面如圖：

4.3、建立虛擬目錄

雙擊你的計算機名「pc1」，展開其站點目錄＝》在你的web站點名上（這裡是「默認web站點」）單擊右鍵＝》「新建」＝》「虛擬目錄」

出現「虛擬目錄創建嚮導」（如圖）＝》點擊「下一步」

在「別名」框裡輸入一個名稱，用來代表你將要映射的cgi腳本目錄（這裡是「cgi-bin」。當然，你也可以使用任何別的名稱，如abc、123之類）＝》點擊「下一步」

在「目錄」框中輸入你在第1步生成的新文件夾的物理路徑「F:cgi-bin」（或者通過「瀏覽」按鈕找到它也行）＝》點擊「下一步」

選取「執行（例如ISAPI應用程序或CGI）（E）」＝》點擊「下一步」

點擊「完成」。

至此，你已成功的為你的站點新設了一個可執行的cgi腳本目錄：F:cgi-bin，這樣，今後你的cgi腳本就可以放在這個目錄裡運行了。

5、在WINNT/2000的 IIS web服務器裡映射.cgi 或 .pl

IIS4 服務器可以運行Perl和cgi程序，但它並未缺省設置為運行Perl。因此，你還得做2個修改：映射.cgi 或 .pl到 Perl，即建立.cgi或 .pl文件到perl程序的文件關聯；為IUSR_網絡客戶帳戶加入新的 NTFS 許可。

5.1、打開IIS

5.2、選擇並打開你的Web 站點

單擊你的虛擬Web 站點（例如，默認Web 站點，或xxx.com），打開它。

選中你的cgi腳本目錄（如你剛才創建的cgi-bin）。如果你想把修改應用到整個虛擬web站點去，那麼只要把選擇單個目錄改為選擇整個站點就行了。

5.3、打開並修改目錄的屬性

在該文件夾上單擊右鍵＝》屬性

出現屬性對話框＝》點擊'目錄'或'虛擬目錄'選項卡＝》選中下方的'腳本和可執行程序'選項＝》點擊'配置'按鈕

5.4、添加或編輯一個到perl的映射

出現一個可用 '應用程序映射'的列表，在'應用程序映射'列表的擴展名裡尋找 .cgi 或 .pl。

1)如果找不到這2個擴展名。點擊"添加"，為.pl建立一個新的映射。

出現"添加/編輯應用程序擴展名" 窗口。

在窗口頂端的「可執行文件（X）」框，使用「瀏覽」按鈕，在你的計算機上查找 perl.exe 或 perlis.dll，它將找到去perl程序的完整路徑，如 D:PerlinPerl.exe 或 D:Perlinperlis.dll，如果你找到的是D:Perlinperl.exe，請你一定要在這個路徑後面加上【空格】%s【空格】%s 。如圖：