Assigning URLs to intranet sites 

Use the URLService commands to assign URLs to intranet sites for your Bookmarks deployment. These commands do not require a file check out or a server restart to take effect. However, after making IP range configuration updates you need to restart Bookmarks for changes to take effect. Then run these commands to process URL changes.


About this task

Use the UrlService commands when the internal IP ranges of your company change. These commands operate on the Bookmarks database and can recalculate whether an existing link is internal or not, based on the IP ranges that are updated using the DogearCellConfig.addIpRange or DogearCellConfig.removeIpRange commands. After making changes, it is a good idea to delete the contents of the Favicons subdirectory. The "favicons" that appear next to each Bookmarks link are cached in the favicon directory, and if you delete the contents of this directory, the icons that appear next to each link will be updated.


Procedure

  1. See the topic Running Bookmarks administrative commands for information on using administrative commands.

  2. Use the following form for the URLService command:

      URLService.<command_name>(<arguments>)

  3. UrlService commands include:

      UrlService.reprocessIntranetAddress('[href]')

        [href] is exact URL whose intranet range is to be reprocessed .

        Example Usage: UrlService.reprocessIntranetAddress ('http://www.ibm.com')

        There should be no output in wsadmin console if successful.

      UrlService.reprocessIntranetAddressBatch('[fileName]')

        [fileName] is the name of the file containing URLs to be recalculated.

        You must create this text file and save it in a local directory (local to the server where you are running the wsadmin processor).

        This command expects a file with URLs to be recalculated on each line. Enter a single URL on each line of the file.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example:

        UrlService.reprocessIntranet AddressBatch(/opt/test.txt")

      UrlService.reprocessIntranetAddresses()

        This command should be used if there have been no major changes to the network topology and the only goal is to process an update to the configured intranet IP ranges.

        This command reprocesses the intranet status of all Bookmarks URLs by comparing a locally cached version of its IP address to the intranet IP ranges provided in the Bookmarks cell-level configuration document.

        This command is much quicker than UrlService.recalculateIPAddresses , which not only checks the current intranet settings but also regathers the IP address for every URL in the database.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example:

        UrlService.reprocessIntranet Addresses()

      UrlService.recalculateIPAddress('[href]')

        [href] is exact URL whose intranet range is to be recalculated.

        Example Usage:

        UrlService.recalculateIPAddress('http://www.example.com')

        Note: If you are only re-validating the intranet status of URLs because of a change to intranet IP tables, then UrlService.reprocessIntranetAddress('[href]') should be invoked.

        There should be no output in wsadmin console if successful.

        Example:

        UrlService.recalculateIPAddress("http://www.example.com")

      UrlService.recalculateIPAddressesBatch('[fileName]')

        [fileName] is the name of the file containing URLs to be recalculated.

        This command expects a file with the URLs to be recalculated on each line. Enter a single URL on each line of the file.

        Note: If you are only re-validating the intranet status of URLs because of a change to intranet IP tables, then UrlService.reprocessIntranetAddressesBatch('[fileName]') should be invoked.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example:

        UrlService.recalculateIPAddressesBatch("c:/Bookmarks/recalc.txt")

      UrlService.recalculateIPAddresses()

        This command recalculates the IP addresses of all the URLs in the database. It works by updating the locally cached copy of the IP address for each URL.

        Running this command can be time consuming for large sized databases. For each URL in the database, this command will connect to and validate the IP address from the DNS. It takes an average of 8 minutes per 500 URLs, depending on the speed of the network connection.

        If you are simply re-validating the intranet status of URLs because of a change to intranet IP tables, use the UrlService.reprocessIntranetAddress() command to speed the process.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example:

        UrlService.recalculateIPAddresses()


Parent topic

Determining whether a site is an internet or intranet site


   

 

});