Oracle iPlanet Web Proxy Server 4.0.14 Administration Guide

Managing the Cache URL List

The proxy utility urldb manages the URL list in the cache. You can use this utility to list the URLs that are cached. You can also selectively expire and remove cached objects from the cache database.

The urldb commands can be categorised into three groups based on the -o option:

domains
sites
URLs

To list domains, type the following command at the command line:
```
urldb -o matching_domains -e reg-exp -d conf-dir
```
For example:
```
urldb -o matching_domains -e “.*phoenix.*” -d server-root/proxy-serverid/config
```
where
- matching_domains lists domains that match regular expression
- reg-exp is the regular expression used
- conf-dir is the configuration directory of the proxy instance located in the server-root/proxy-serverid/config directory.
To list all the matching sites in a domain, type the following command at the command line:
```
urldb -o matching_sites_in_domain -e reg-exp -m domain_name -d conf-dir
```
For example:
```
urldb -o matching_sites_in_domain -e “.*atlas” -m phoenix.com 
	-d server-root/proxy-serverid/config
```
where
- matching_sites_in_domain lists all the sites in a domain that match the regular expression
- reg-exp is the regular expression used
- domain_name is the name of the domain
- conf-dir is the configuration directory of the proxy instance located in the server-root/proxy-serverid/config directory.
To list all the matching sites, type the following command at the command line:
```
urldb -o all_matching_sites -e reg-exp -d conf-dir
```
For example:
```
urldb -o all_matching_sites -e “.*atlas.*” -d server-root/proxy-serverid/config
```
where
- all_matching_sites lists all the sites that match the regular expression
- reg-exp is the regular expression used
- conf-dir is the configuration directory of the proxy instance located in the server-root/proxy-serverid/config directory.
To list matching URLs in a site, type the following command at the command line:
```
urldb -o matching_urls_from_site -e reg-exp -s site_name -d conf-dir
```
For example:
```
urldb -o matching_urls_from_site -e “http://.*atlas.*” -s atlas.phoenix.com 
	-d server-root/proxy-serverid/config
```
where
- matching_urls_from_site lists all URLs from site that match the regular expression
- reg-exp is the regular expression used
- site_name is the name of the site
- conf-dir is the configuration directory of the proxy instance located in the server-root/proxy-serverid/config directory.
To expire or remove matching URLs in a site, type the following command at the command line:
```
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
```
For example:
```
urldb -o matching_urls_from_site -e “http://.*atlas.*” -s atlas.phoenix.com 
	-x e -d server-root/proxy-serverid/config
```
where
- matching_urls_from_site lists all URLs from site that match the regular expression
- reg-exp is the regular expression used
- site_name is the name of the site
- -x e is the option to expire the matching URLs from the c ache database. This option can not be used with the domain and site modes
- -x r is the option to remove the matching URLs from the cache database
- conf-dir is the configuration directory of the proxy instance. It is located in the server-root/proxy-serverid/config directory.
To list all matching URLs , type the following at the command line:
```
urldb -o all_matching_urls -e reg-exp -d conf-dir
```
For example:
```
urldb -o all_matching_urls -e “.*cgi-bin.*” -d 
	server-root/proxy-serverid/config
```
where
- all_matching_urls lists all the URLs that match the regular expression
- reg-exp is the regular expression used
- conf-dir is the configuration directory of the proxy instance located in the server-root/proxy-serverid/config directory.
To cause the expiry of all matching URLs, or to remove all matching URLs, type the following command at the command line:
```
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
```
For example:
```
urldb -o all_matching_urls -e “.*cgi-bin.*” -x e -d server-root/proxy-serverid/config
```
where
- all_matching_urls lists all the URLs that match the regular expression
- reg-exp is the regular expression used
- -x e is the option to cause the expiry of the matching URLs from the cache database
- -x r is the option to remove the matching URLs from the cache database
- conf-dir is the configuration directory of the proxy instance located in the server-root/proxy-serverid/config directory.
To cause the expiry of a list of URLs, or to remove a list of URLs , type the following command at the command line:
```
urldb -l url-list -x e -e reg-exp -d conf-dir
urldb -l url-list -x r -e reg-exp -d conf-dir
```
For example:
```
urldb -l url.lst -x e -e “.*cgi-bin.*” -d server-root/proxy-serverid/config
```
where
- url-list is the list of URLs that need to be expired. This option can be used for providing the URL list.
- -x e is the option to cause the expiry of the matching URLs from the cache database.
- -x r is the option to remove the matching URLs from the cache database.
- reg-exp is the regular expression used
- conf-dir is the configuration directory of the proxy instance located in the server-root/proxy-serverid/config directory.