ImageExtractor.jar or ImageExtractor.bat
In this topic:
The ImageExtractor is a Java utility that enables you to convert individually stored images contained in existing field display properties to AR System shared images. Shared images are server objects that you can manage in BMC Remedy Developer Studio.
Before BMC Remedy AR System 7.5.00, a separate copy of each image was stored in the database for every field with which it is associated. By converting multiple copies of each image to a single image retrieved by reference, this utility reduces database storage space and cache requirements.
The utility can convert all images associated with a specified set of forms, or all images in the database, to shared images and image references. The utility uses an image checksum to identify images already present in the server. If an image is found, that reference is used. Otherwise, a shared image object is created.
ImageExtractor.jar utility is installed with the AR System server. On Windows, a batch file (ImageExtractor.bat) is provided to ensure the correct environment settings are configured when you run the utility. Both files are in the
ARServerInstallDir\api\lib directory. On UNIX, ImageExtractor.java is in the
java -jar ImageExtractor.jar
The utility prompts you for the following input:
- Server host — Enter the host name of the AR System server.
- Server port — If not using the AR System portmapper, enter the TCP port for the AR System server. If using a portmapper, press ENTER to leave this option blank.
- User name — Enter the AR System user name of a user who is a member of the Administrator group.
- Password — Enter the password for the user.
- Image file containing the form names — Enter the name of the text file, if any, that lists the form names for which to convert images (see the Environment information). To convert all images on the AR System server, leave this option blank.
You must have a supported Oracle Java runtime environment (JRE) installed and available in the server environment.
To convert images for a specified list of forms, create a text file that contains one form name per line. For example, the ImageExtractor utility would use the following text file to convert all images in the Sample application forms listed:
Sample:Cities Sample:ClassCentral Sample:Classes Sample:DialogYesNo Sample:Enrollments Sample:GetWeather