Applying custom CSS and images to your application

You can customize applications with custom images, logos, and design styles to brand your applications. To apply custom cascading style sheet (CSS) files and images to your application, use the DBFileSync utility. You can use the utility to apply CSS and images to the BMC Helix ITSM: Smart IT and BMC Helix ITSM: Smart Reporting applications.

The DBFileSync utility provides the branding information required for an application in a ZIP file. The utility is embedded in the application container and checks for any updates based on the database sync interval, fetches the updated file, and unzips the file in the folder for branding in your application.

Learn about branding BMC Helix Single Sign-On, BMC Helix ITSM, BMC Digital Workplace, BMC Helix Business Workflows at:

• Rebranding the end user login page
• User interface change guidelines
• Rebranding BMC Helix Digital Workplace
• Tailoring the application skin and brand

Before you begin

Make sure that you download the following files:

• Rebranding_Utility—DBFileSync utility for BMC Helix ITSM: Smart IT
• DBFileSync Smart Reporting—DBFileSync utility for BMC Helix ITSM: Smart Reporting
  

To apply custom CSS and images to BMC Helix ITSM: Smart IT

1. Copy the Rebranding_Utility utility in your system from where the database server is accessible.
   While copying the utility, specify the utility name as DBFileSync_utility.
2. In the style-smart-it.css file, add the custom files and images that you want to apply.

3. In the config.properties file, update the following parameters:

   Parameter name	Description
   DB_TYPE	Specify any of the following values based on the type of your database: For PostgreSQL database, specify the value as postgres For Microsoft SQL Server database, specify the value as mssql For Oracle database, specify the value as oracle
   DB_URL	Specify the database URL based on the database type: For PostgreSQL database, specify the URL as jdbc:postgresql://<DB host name>:<DB port>/<DB name> For Microsoft SQL Server database, specify the URL as jdbc:sqlserver://<DB host name>:<DB port>;database=<DB name> For Oracle database, specify the URL as jdbc:oracle:thin:@//<DB host name>:<DB port>/<DB name>
   DB_User	Database username for login.
   DB_PWD	Database password for login.
   <Unique key>	Unique key for each record in the database table. For example: kettle=ARSystem, C:\Rebranding_Utility\kettle.properties, /opt/bmc/ARSystem/diserver/.kettle/

   Important

   In the config.properties file, do not add a space in the key and value.
   

4. Navigate to the location where you copied the utility and run the following command:

   run DBFileSync-cmd.sh

   The system prompts to specify the following options:

   Option	Description
   Select below option 1. Upload Rebranding 2. Download Rebranding	Specify the value as 1.
   Select Config file Path	Specify the path of the config.properties file.

The database sync interval for BMC Helix ITSM: Smart IT is 12 minutes by default. After you apply the branding updates, they are reflected after 12 minutes.

For more information, see Rebranding Smart IT on the Universal Client .

To apply custom CSS and images to BMC Helix ITSM: Smart Reporting

1. Copy the DBFileSync Smart Reporting utility in your system from where the database server is accessible.
   While copying the utility, specify the utility name as DBFileSync_utility.
2. In the DBFileSync_SmartReporting utility folder, add the custom files and images that you want to apply.

3. In the DBFileSync_SmartReporting utility folder, in the config.properties, update the following parameters:

   Parameter name	Description
   DB_URL	In the database URL, update the host name and database name.
   DB_User	System administrator username for login.
   DB_PWD	System administrator password for login.
   File1	SmartReporting,<Path of the header_logo1.gif file>,/opt/bmc/SmartReporting/SmartReporting/appserver/webapps/ROOT/customimages
   File 2	SmartReporting,<Path of the SmartReportingHeader.jsp file>,/opt/bmc/SmartReporting/SmartReporting/appserver/webapps/ROOT/includes

4. Navigate to the location where you copied the utility and run the following command:

   run DBFileSync-cmd.bat

   The system prompts to specify the following options:

   Option	Description
   Select below option 1. Upload Rebranding 2. Download Rebranding	Specify the value as 1.
   Select Config file Path	Specify the path of the config.properties file.

   The database sync interval for BMC Helix ITSM: Smart Reporting is 60 minutes by default. After you apply the branding updates, they are reflected after 60 minutes.