Siebel Installation Guide for Microsoft Windows > Creating the Siebel Installation Image on the Network >

Troubleshooting Siebel Image Creation

When you run Siebel Image Creator, the utility validates the integrity of each JAR file that it processes as it creates the Siebel image. Consequently, it is unnecessary to validate the JAR files beforehand.

If a JAR file is invalid for some reason, then Siebel Image Creator displays a message to this effect. Obtain a new copy of the JAR file and rerun Siebel Image Creator in order to include the content in the Siebel image. Rerunning Siebel Image Creator might also be necessary in some other cases identified in this topic.

When you run Siebel Image Creator and create a Siebel image successfully, the files in the Siebel image have the same timestamp as the corresponding files that were included in the JAR files.

When you rerun Siebel Image Creator, it will not replace any files that have the same or a newer timestamp.

Rerunning Siebel Image Creator might be necessary in the following cases:

• If you have deleted a Siebel image or any part of the Siebel image by mistake. In this case, remove all of the files generated by Siebel Image Creator for any affected Siebel modules, then run Siebel Image Creator again to re-create the Siebel image for those modules.
• If a JAR file is invalid and you have since obtained a new version of the JAR file.
• If you skipped a missing JAR file during a Siebel Image Creator session and have since obtained the missing JAR file.
• If any Siebel module was incompletely processed by Siebel Image Creator. In this case, remove all of the files generated by Siebel Image Creator for the affected module, then run Siebel Image Creator again to re-create the Siebel image for this module.

TIP:   Keep track of the operating systems, Siebel modules, and languages in your Siebel image for the applicable version. If you have to rerun Siebel Image Creator, then reselect the options that you require to complete the Siebel image.

You might also have to run Siebel Image Creator multiple times if you intentionally processed only some of the Siebel modules that you require and have to process the JAR files in multiple batches. For example, if you obtained Siebel CRM version 8.1.1.11 and version 8.1.1 files, then you might create the Siebel CRM version 8.1.1.11 image for all of the Siebel modules. After this, you might have to create a Siebel CRM version 8.1.1 image for all of the modules other than Siebel Enterprise Server and SWSE. Multiple operations might require moving or copying JAR files and the Siebel Image Creator files into different directories for your purposes.

Siebel Image Creator Logging

Siebel Image Creator logs details about its processing in the file log.txt, which is created in the top-level directory that you specified for the Siebel image (for example, C:\Siebel_Install_Image).

Review the log file to identify where problems occurred when you created the Siebel image, such as in the following cases:

• Siebel Image Creator logs a message like the following after each JAR file has been successfully extracted. (If a JAR file is only partially extracted, then this message is not written.)

  Extracted SBA_8.1.1.11_Base_Windows_Siebel_Enterprise_Server.jar

• Siebel Image Creator logs a message like the following when a JAR file has been skipped.

  Skipped JAR_file_name - Please run Siebel Image Creator again and add module_name to the network image, once all image files are available.

Installer Errors and the Siebel Image

You must validate that the Siebel image was created correctly for all of the applicable modules. However, installation errors sometimes indicate problems in the Siebel image.

If, when you run a Siebel installer, errors are returned about missing or corrupt files, then remove all of the files generated by Siebel Image Creator for any module that was incompletely processed, make sure that you have all of the JAR files that you require (including those representing third-party files), and then run Siebel Image Creator again to re-create the Siebel image for that module.

For installation instructions, see Installing Siebel Enterprise Server Components and the Siebel Web Server Extension and other chapters for installing particular Siebel modules.

For installation requirements, see Requirements for Installing and Configuring Siebel Business Applications.

For installation troubleshooting information, see Verifying and Troubleshooting Your Installation.