Introduction to MapViewer 1-27
restrictive logging: FATAL, ERROR, WARN, INFO, DEBUG, and FINEST. The FATAL level outputs the least log information only unrecoverable events are logged, and
the other levels are progressively more inclusive, with the FINEST level causing the most information to be logged. For production work, a level of WARN or more
restrictive ERROR or FATAL is recommended; however, for debugging you may want to set a less restrictive level.
■
The log_thread_name attribute controls whether or not to include the name of the thread that encountered and logged the event.
■
The log_time attribute controls whether or not the current time is included when a logging event occurs.
■
The log_output subelement identifies output for the logging information. By default, log records are written to the system error console. You can change this to
the system output console or to one or more files, or some combination. If you specify more than one device through multiple log_output subelements, the
logging records are sent to all devices, using the same logging level and attributes.
1.5.2.2 Specifying Map File Storage and Life Cycle Information
Map image file information is specified in the save_images_at element. By default, images are stored in the ORACLE_HOME lbsmapviewerwebimages
directory. You do not need to modify the save_images_at element unless you want to specify a different directory for storing images.
A mapping client can request that MapViewer send back the URL for an image file instead of the actual map image data, by setting the format attribute of the map_
request element described in Section 3.2.1.1
to GIF_URL or PNG_URL. In this case, MapViewer saves the requested map image as a file on the host system where
MapViewer is running and sends a response containing the URL of the image file back to the map client.
You can specify the following map image file information as attributes of the save_ images_at element:
■
The file_prefix attribute identifies the map image file prefix. A map image file name will be a fixed file prefix followed by a serial number and the image type
suffix. For example, if the map image file prefix is omsmap, a possible GIF map image file could be omsmap1.gif.
Default value: file_prefix=omsmap
■
The url attribute identifies the map image base URL, which points to the directory under which all map image files are saved on the MapViewer host. The
map image URL sent to the mapping client is the map image base URL plus the map image file name. For example, if the map image base URL is
http:dev04.example.com:1521mapviewerimages, the map image URL for omsmap1.gif will be
http:dev04.example.com:1521mapviewerimagesomsmap1.gif.
Default value: url=HOST_URLmapviewerimages
■
The path attribute identifies the path of the directory where all map image files are saved on the MapViewer host system. This directory must be accessible by
HTTP and must match the map image URL. Map image files saved in the directory specified by the path attribute should be accessible from the URL
specified by the url attribute.
However, if you are deploying MapViewer to WebLogic Server, the default value for the path attribute ..webimages is not correct. The path attribute value in
1-28 Oracle Fusion Middleware Users Guide for Oracle MapViewer
this case should be ....images, because the physical images directory is mapviewer.earweb.warimages; so using relative path, the value should be
....images for the path attribute to resolve to the physical directory.
■
The life attribute specifies the number of minutes that a generated map image is guaranteed to stay on the file system before the image is deleted. If the life
attribute is specified, the recycle_interval attribute controls how frequently MapViewer checks for possible files to delete.
Default: MapViewer never deletes the generated map images.
■
The recycle_interval attribute specifies the number of minutes between times when MapViewer checks to see if it can delete any image files that have been on
the file system longer than the number of minutes for the life attribute value.
Default value: 480 8 hours
1.5.2.3 Restricting Administrative Non-Map Requests
