Sun Java System Web Proxy Server 4.0.8 管理指南

使用快取指令行介面

代理伺服器提供數個指令行公用程式，您可以使用這些公用程式來配置、變更、產生與修復您的快取目錄結構。這些公用程式的功能大部分都與 Server Manager 頁面上的功能重複。若需要對維護 (例如 cron 工作) 進行排程，您可能需要使用這些公用程式。所有公用程式都位於 extras 目錄。

執行指令行公用程式

從指令行提示符號移至 server_root /proxy-serverid 目錄。

鍵入 ./start -shell

以下各節說明各種公用程式。

建立快取目錄結構

名為 cbuild 的代理伺服器公用程式是一個離線快取資料庫管理程式。此公用程式可讓您使用指令行介面來建立新的快取結構或修改現有的快取結構。您可以使用 Server Manager 頁面來啟用代理伺服器以使用新建立的快取。

備註 –

此公用程式不會更新 server.xml 檔案。cbuild 無法對具有多個分割區的快取調整大小。透過 cbuild 建立或修改快取時，應該手動更新 server.xml 檔案中的 cachecapacity 參數。

<PARTITION partitionname="part1" partitiondir="/home/build/install9
/proxy-server1/cache" maxsize="1600" minspace="5" enabled="true"/>
<CACHE enabled="true" cachecapacity="2000" cachedir="/tmp/cache">

您可以使用兩種模式來呼叫 cbuild 公用程式。第一種模式是：

cbuild -d conf-dir -c cache-dir -s cache size 
cbuild -d conf-dir -c cache-dir -s cache size -r

例如︰

cbuild -d server_root/proxy-serverid/config 
	-c server_root/proxy-serverid/cache -s 512
cbuild -d server_root/proxy-serverid/config 
	-c server_root/proxy-serverid/cache -s 512 -r

其中

conf-dir 是代理伺服器實例的配置目錄，它位於 server_root /proxy-serverid/config 目錄中。
cache-dir 是快取結構的目錄。
cache size 是快取可擴充到的最大值。此選項不能與 cache-dim 參數一起使用。上限大小是 65135 MB。
-r 可調整現有快取結構的大小 (假設該快取結構只有單一分割區)。建立新快取時不需要此選項。

第二種模式是：

cbuild -d conf-dir -c cache-dir -n cache-dim
cbuild -d conf-dir -c cache-dir -n cache-dim -r

例如︰

cbuild -d server_root/proxy-serverid/config 
	-c server_root/proxy-serverid/cache -n 3
cbuild -d server_root/proxy-serverid/config 
	-c server_root/proxy-serverid/cache -n 3 -r

其中

conf-dir 是代理伺服器實例的配置目錄，它位於 server_root /proxy-serverid/config 目錄中。
cache-dir 是快取結構的目錄。
cache-dim 決定區段數目。例如，在圖 12–2 中，區段顯示為 s3.4，其中 3 表示大小。cache-dim 的預設值是 0，最大值是 8。
-r 可調整現有快取結構的大小 (假設該快取結構只有單一分割區)。建立新快取時不需要此選項。

管理快取 URL 清單

代理伺服器公用程式 urldb 用於管理快取中的 URL 清單。您可以使用此公用程式來列出已快取的 URL。您也可以從快取資料庫選取性地移除已快取的物件，或將它設定為過期。

urldb 指令可根據 -o 選項分為三個群組：

網域
網站
URL

若要列出網域，請在指令行中鍵入以下指令：
```
urldb -o matching_domains -e reg-exp -d conf-dir
```
例如︰
```
urldb -o matching_domains -e “.*phoenix.*” -d server-root/proxy-serverid/config
```
其中
- matching_domains 可列出符合常規表示式的網域
- reg-exp 是所使用的常規表示式
- conf-dir 是代理伺服器實例的配置目錄，它位於 server-root /proxy-serverid/config 目錄中。
若要列出網域中所有符合的網站，請在指令行中鍵入以下指令：
```
urldb -o matching_sites_in_domain -e reg-exp -m domain_name -d conf-dir
```
例如︰
```
urldb -o matching_sites_in_domain -e “.*atlas” -m phoenix.com 
	-d server-root/proxy-serverid/config
```
其中
- matching_sites_in_domain 可列出網域中所有符合常規表示式的網站
- reg-exp 是所使用的常規表示式
- domain_name 是網域的名稱
- conf-dir 是代理伺服器實例的配置目錄，它位於 server-root /proxy-serverid/config 目錄中。
若要列出所有符合的網站，請在指令行中間鍵入以下指令：
```
urldb -o all_matching_sites -e reg-exp -d conf-dir
```
例如︰
```
urldb -o all_matching_sites -e “.*atlas.*” -d server-root/proxy-serverid/config
```
其中
- all_matching_sites 可列出所有符合常規表示式的網站
- reg-exp 是所使用的常規表示式
- conf-dir 是代理伺服器實例的配置目錄，它位於 server-root /proxy-serverid/config 目錄中。
若要列出網站中符合的 URL，請在指令行中鍵入以下指令：
```
urldb -o matching_urls_from_site -e reg-exp -s site_name -d conf-dir
```
例如︰
```
urldb -o matching_urls_from_site -e “http://.*atlas.*” -s atlas.phoenix.com 
	-d server-root/proxy-serverid/config
```
其中
- matching_urls_from_site 可列出網站中所有符合常規表示式的 URL
- reg-exp 是所使用的常規表示式
- site_name 是網站的名稱
- conf-dir 是代理伺服器實例的配置目錄，它位於 server-root /proxy-serverid/config 目錄中。
若要將網站中符合的 URL 設定為過期或將它移除，請在指令行中鍵入以下指令：
```
urldb -o matching_urls_from_site -e reg-exp -s site_name -x e -d conf-dir
urldb -o matching_urls_from_site -e reg-exp -s site_name -x r -d conf-dir
```
例如︰
```
urldb -o matching_urls_from_site -e “http://.*atlas.*” -s atlas.phoenix.com 
	-x e -d server-root/proxy-serverid/config
```
其中
- matching_urls_from_site 可列出網站中所有符合常規表示式的 URL
- reg-exp 是所使用的常規表示式
- site_name 是網站的名稱
- -x e 選項可將快取資料庫中符合的 URL 設定為過期。此選項無法與網域和網站模式一起使用
- -x r 選項可從快取資料庫移除符合的 URL
- conf-dir 是代理伺服器實例的配置目錄，它位於 server-root /proxy-serverid/config 目錄中。
若要列出所有符合的 URL，請在指令行中鍵入以下指令：
```
urldb -o all_matching_urls -e reg-exp -d conf-dir
```
例如︰
```
urldb -o all_matching_urls -e “.*cgi-bin.*” -d 
	server-root/proxy-serverid/config
```
其中
- all_matching_urls 可列出所有符合常規表示式的 URL
- reg-exp 是所使用的常規表示式
- conf-dir 是代理伺服器實例的配置目錄，它位於 server-root /proxy-serverid/config 目錄中。
若要將所有符合的 URL 設定為過期，或要移除所有符合的 URL，請在指令行中鍵入以下指令：
```
urldb -o all_matching_urls -e reg-exp -x e -d conf-dir
urldb -o all_matching_urls -e reg-exp -x r -d conf-dir
```
例如︰
```
urldb -o all_matching_urls -e “.*cgi-bin.*” -x e -d server-root/proxy-serverid/config
```
其中
- all_matching_urls 可列出所有符合常規表示式的 URL
- reg-exp 是所使用的常規表示式
- -x e 選項可將快取資料庫中所有符合的 URL 設定為過期
- -x r 選項可從快取資料庫移除符合的 URL
- conf-dir 是代理伺服器實例的配置目錄，它位於 server-root /proxy-serverid/config 目錄中。
若要將 URL 清單設定為過期或移除 URL 清單，請在指令行中鍵入以下指令：
```
urldb -l url-list -x e -e reg-exp -d conf-dir
urldb -l url-list -x r -e reg-exp -d conf-dir
```
例如︰
```
urldb -l url.lst -x e -e “.*cgi-bin.*” -d server-root/proxy-serverid/config
```
其中
- url-list 是需要設定為過期的 URL 清單。此選項可用於提供 URL 清單。
- -x e 選項可將快取資料庫中符合的 URL 設定為過期。
- -x r 選項可從快取資料庫移除符合的 URL。
- reg-exp 是所使用的常規表示式
- conf-dir 是代理伺服器實例的配置目錄，它位於 server-root /proxy-serverid/config 目錄中。

管理快取資源回收

cachegc 公用程式可讓您從快取資料庫中移除受快取大小限制，可能已過期或過舊以致於無法快取的物件。

備註 –

使用 cachegc 公用程式時，請確定 CacheGC 並未在代理伺服器實例中執行。

cachegc 公用程式的使用方式如下：

cachegc -f leave-fs-full-percent -u gc-high-margin-percent -l gc-low-margin-percent -e 
	extra-margin-percent -d conf-dir

例如︰

cachegc -f 50 -u 80 -l 60 -e 5 -d server-root/proxy-serverid/config

其中

leave-fs-full-percent 可判斷快取分割區大小的百分比，當快取分割區大小低於此值時，將不會執行資源回收
gc-high-margin-percent 可控制最大快取大小的百分比，當達到此值時，會觸發資源回收
gc-low-margin-percent 可控制回收收集器目標的最大快取大小百分比
extra-margin-percent 是由回收收集器用來確定要移除的快取部分。
conf-dir 是代理伺服器實例的配置目錄，它位於 server-root /proxy-serverid/config 目錄中。

管理批次更新

bu 公用程式用於更新快取，它有兩種運作模式。在第一種模式中，它會反覆檢查快取資料庫，並透過為每個 URL 傳送 HTTP 請求來更新快取中現存的所有 URL。在第二種模式中，它會從指定的 URL 開始對從此 URL 至所指定層級的所有連結執行廣度優先遍歷，並將頁面擷取到快取中。bu 是與 RFC 相容的網頁抓取程式。

bu -n hostname -p port -t time-lmt -f contact-address -s sleep-time -o object -r n -d conf-dir

例如︰

bu -n phoenix -p 80 -t 3600 -f admin@phoenix.com -s 60 -o nova -r n 
	-d server-root/proxy-serverid/config

其中

hostname 是執行代理伺服器的機器的主機名稱。預設值是 localhost。
port 是代理伺服器執行時所用的連接埠。預設連接埠是 8080。
time-lmt 是執行公用程式的時間限制
contact-address 決定將透過 bu 傳送的 HTTP 請求傳送的連絡位址。預設值是 worm@proxy-name。
sleep-time 是兩個連續請求之間的暫停時間。預設值是 5 秒。
object 是目前正在執行的 bu.conf 中指定的物件。
-r n 選項決定是否遵循 robot.txt 策略。預設值是 y。
conf-dir 是代理伺服器實例的配置目錄，它位於 server-root /proxy-serverid/config 目錄中。