How to set customized theme as default upon installation

Hypothetical situation:

You want to install the TIBCO JasperReports^® Server on your client's servers and want to provide your own branding. For that you have developed a theme. How to correctly ship that theme and make it default after installlation without additional administration.

Solution:

There are two approaches here. They both essentially modify the default catalog. First one:

1. Deploy the TIBCO JasperReports Server with minimum catalog (without samples and such).
2. Upload your theme.
3. Set the theme as active theme as superuser.
4. Export the repository using the import-export tool (please refer to the TIBCO JasperReports Server Administrator guide (attached) on using the import-export tool). The key you are interested when exporting would be --everything).
5. Once exported you'll have a zip. That zip should have a flag as to what themes are currently active. You can import it to some other new server with --update flag and that should force that theme to be used. You can import that archive before you finally deploy the TIBCO JasperReports Server.

The theme gets assigned on organizational level including the root theme. TIBCO JasperReports Server doesn't have capability to export single organizations as of 6.1.1. The theme used is defined in the XML-descriptor of the exported organization. For the root this is defined in {exported archive}/organizations/organizations.xml. The theme used is defined here (I am using a custom theme):

<theme>New Theme Name</theme>

This is also true for other organizations like organization_1.

Another approach would be to modify the import-minimal catalog itself. For that go to buildomatic/install_resources/export and find the catalog that your are going to be using. Change the contents of the zip file to replace the default theme with your own.