This documentation supports the 21.05 version of BMC Helix ITSM. To view an earlier version, select the version from the Product version menu.

Rebranding BMC Helix ITSM on Apple iOS

This topic describes how to rebrand Smart IT on Apple Watch and Apple iOS devices. Irrespective of whether you rebrand manually, or by using the utility, you must ensure that you meet all the pre-requisites provided at Preparing-to-re-sign-and-rebrand-Smart-IT-on-Apple-iOS. 

Related topic

Deploying-Smart-IT-to-your-users

Before you begin

  • Your company must be a member of the Apple Enterprise Program to obtain the required development tools from the developer portal. See the following resources for more information:

    Visit

    Details

    • Only a company or an organization with a D-U-N-S number can apply for the enterprise program.
    • An enterprise account allows you to distribute the rebranded application internally among your users.
    • An organization account enables you to distribute applications only through the Apple store.

    Provides development tools, and documentation needed to develop Apple iOS apps.

    Describes how to assign the team agent role to the user who is going to rebrand Smart IT.

    Provides information about the necessary certificates and provisioning profiles.

    Provides information about bundle identifiers.

  • Download BMC iOS Rebranding Utility Version 21.3.00 from BMC Electronic Product Distribution (EPD) portal.

Supported graphics for rebranding

This section lists all supported application icons, splash screen graphics, and Apple watch icons. For more information about required and recommended icons, see Apple iOS Human Interface Guidelines: Icon and Images Sizes in the Apple iOS developer documentation.

Important

The images given below are sample images. The exact resolution specifications are given in the table.


Application icon graphics

For rebranding Smart IT on Apple iOS the following Application Icon graphic is used:

2x.png

The following table lists all supported application icon sizes.

Graphic Name

Resolution

Usage

AppIcon29x29@2x.png

58x58

iPhone - Settings

AppIcon40x40@2x.png

80x80

iPhone - Spotlight

AppIcon60x60@2x.png

120x120

iPhone App Icon

AppIcon60x60@3x.png

180x180

iPhone App Icon

AppIcon40x40.png

40x40

iPad Settings

AppIcon40x40~ipad.png

40x40

iPad Spotlight

AppIcon40x40@2x~ipad.png

80x80

iPad Spotlight

AppIcon76x76~ipad.png

76x76

iPad App Icon

AppIcon76x76@2x~ipad.png

152x152

iPad App Icon

AppIcon83.5x83.5@2x.png

167x167

iPad Pro Icon

Apple watch graphics

For rebranding Smart IT on Apple iOS the following Apple watch graphic is used:

Icon-24@2x.png

The following table lists the details of all supported Apple watch graphics.

Graphic Name

Supported Devices

Resolution

Usage

Icon-24@2x.png

38 mm Apple Watch

48x48

Notification Center

Icon-27_5@2x.png

42 mm Apple Watch

57x57

Notification Center

Icon-29@2x.png

38 mm and 42 Apple Watch

58x58

Companion Settings

Icon-29@3x.png

38 mm and 42 Apple Watch

87x87

Companion Settings

Icon-40@2x.png

38 mm and 42 Apple Watch

80x80

Home Screen

Icon-44@2x.png

42 mm Apple Watch

88x88

Long Look

Icon-86@2x.png

38 mm Apple Watch

172x172

Short Look

Icon-98@2x.png

42 mm Apple Watch

196x196

Short Look

Splash screen graphics

The splash screen displays when the application launches. For rebranding Smart IT on Apple iOS the following splash screen graphics are used:

Landscape mode

Portrait mode

Example: iPadLandscape.png

iPadLandscape.png

Example: iPadPortrait@png

iPadPortrait.png

The following table lists the details of all supported splash screen graphics.

Graphic name

Supported devices

Resolution

LaunchImage-800-Portrait-736h@3x.png

iPhone 7 Plus, iPhone 6s Plus – 5.5 inch devices

1242×2208

LaunchImage-800-667h@2x.png

iPhone 7, iPhone 6s, iPhone 6 – 4.7 inch devices

750×1334

LaunchImage-700-568h@2x.png

iPhone SE, iPhone5, 5S, 5c - 4 inch devices

640×1136

LaunchImage-700@2x.png

iPhone 4, iPhone 4S – 3.5 inch devices

640×960

LaunchImage-700-Portrait~ipad.png

iPad2 (old model)

768x1024

LaunchImage-700-Portrait@2x~ipad.png

9.7-inch iPad Pro, iPad Air 2, iPad mini 4, iPad mini 2

1536x2048

Important

LaunchImage-700@2x.png and Portrait~ipadgraphics are required to support 4-inch size devices (iPhone 4, iPhone 4S) and iPad (2nd generation), respectively. These devices have 9.3.5 as last supported iOS version.


To rebrand Smart IT by using the utility

  1. Open the Resign.dmg file and run the ResigningUtility.app application.
  2. In the Application name field, select Smart IT, and click Next.
  3. Select an appropriate Smart IT version, and click Next.

  4. Create a new re-signing project, and provide the following details:

    • Project Name—Give the re-signing project a name, for example, SmartITResignDemo.

    • Project Location—Select a directory on your Mac machine for storing the project. 

      The utility creates a project fileforexample, SmartITResignDemo.resign and different sub-directories within the project directory.

    Important

    Re-signing and rebranding is done within the same project.

  5. Go to the Rebranding tab, and rebrand various items:
    • Use the color picker tool to change the color of the brand button, brand text, navigation bar, and navigation text. 
      You can also enter the RGB code or hexadecimal value of a color.
    • Choose whether you want to remove the BMC logo, white login background, and full app name.
    • Change the default images by dragging and dropping the new images that you created.
      The images are copied to the Rebranding subfolder within your project folder. 
  6. Re-sign Smart IT on Apple iOS.

To replace the Smart IT APNS certificate with your APNS certificate

After you rebrand, you must replace the Smart IT APNS certificate with your APNS certificate.

If you are a BMC Helix user, you must first send the APNS certificate to BMC Support. Attach your APNS certificate to your request, and then submit it to BMC support. For more information, see Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.
.

If you are an on-premises user, use these steps to replace the Smart IT APNS certificate:

  1. Use DBFileSync_utility to copy the APNS certificate to the relevant folder.
  2. Stop the Tomcat instance that executes the Smart IT server.
  3. In the Tomcat home folder, locate and open the external-conf folder.
  4. In the external-conf folder, create a certification subfolder.
  5. Place the .p12 file that contains the new APNS certificate that you created in the certification subfolder.
  6. Log in to the Oracle or Microsoft SQL database used for Smart IT.
  7. Go to the PUSH_NOTIFICATION_CERT table, and query for records.
  8. To change the iOS APNS certificate record:
    1. In the iOS_Cert field, replace the current value (the default value is GalileoAPNsProduction.p12) with the name of the .p12 file that contains your new APNS certificate.
    2. In the iOS_Password row, in plain text, replace the current password with the password of your .p12 file.
  9. Click Save.
  10. Start the Tomcat instance.
    Any notifications to iOS devices from your server (or tenant in multitenant environments) are sent using the new certificate.

Where to go from here

Re-signing-Smart-IT-on-Apple-iOS

To rebrand Smart IT manually

You can manually rebrand Smart IT on iOS.

  1. Edit the supported splash screen, login screen, and connection background files.
  2. Place the provisioning profiles that you created in the /path/SmartIT-ResignDir folder, and rename the files to SmartIT.mobileprovision, SmartITWatch.mobileprovision, and SmartITWatchExtension.mobileprovision.

  3. Set the bundle IDs to match the application ID set on the Apple Development portal (for example, com.companyName.SmartIT.watch, com.companyName.SmartIT.watch.extension, and com.companyName.SmartIT).

    cd /path/SmartIT-ResignDir
     
    /usr/libexec/PlistBuddy -c "Set CFBundleIdentifier com.companyName.SmartIT"
    ./Payload/Galileo.app/Info.plist

    /usr/libexec/PlistBuddy -c "Set CFBundleIdentifier com.companyName.SmartIT.watch" 
    ./Payload/Galileo.app/Watch/Watch.app/Info.plist

    /usr/libexec/PlistBuddy -c "Set CFBundleIdentifier com.companyName.SmartIT.watch.extension"
    ./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch\
    Extension.appex/Info.plist
     
    /usr/libexec/PlistBuddy -c "Set WKCompanionAppBundleIdentifier com.companyName.SmartIT" 
    ./Payload/Galileo.app/Watch/Watch.app/Info.plist

    /usr/libexec/PlistBuddy -c "Set NSExtension:NSExtensionAttributes:WKAppBundleIdentifier com.companyName.SmartIT.watch" ./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch\ Extension.appex/Info.plist

    Use the code shown in this table.

    To

    Use the code

    Set the application name that is displayed on the iOS devices. APPLICATIONNAME—The name of your application. For example, Smart IT or Acme Smart IT.

    /usr/libexec/PlistBuddy -c "Set CFBundleDisplayName APPLICATIONNAME" 
    ./Payload/Galileo.app/Info.plist

    Set the long application name that appears on the splash screen. LONGAPPNAME—The long name of your application. For example, Remedy with Smart IT.

    /usr/libexec/PlistBuddy -c "Set galileo-full-app-name LONGAPPNAME" 
    ./Payload/Galileo.app/Info.plist

    Set the Apple Watch name.
    WATCHNAME—The title that is displayed on the Apple Watch application. For example, Smart IT.

    /usr/libexec/PlistBuddy -c "Set CFBundleDisplayName WATCHNAME" 
    ./Payload/Galileo.app/Watch/Watch.app/Info.plist
     
    /usr/libexec/PlistBuddy -c "Set CFBundleDisplayName WATCHNAME" 
    ./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch\ Extension.appex/Info.plist

    Set the default Smart IT server to your Smart IT server.
    SERVER—Your Smart IT server name. For example, SmartIT.acme.com.

    /usr/libexec/PlistBuddy -c "Set galileo-server SERVER" ./Payload/Galileo.app/Info.plist

    Set the default port for your Smart IT server.
    PORT—The TCP port for clients to access the server. For example, 9000 or 8888.

    /usr/libexec/PlistBuddy -c "Set galileo-port PORT" ./Payload/Galileo.app/Info.plist

    Set the default Internet protocol.
    PROTOCOL—Set either HTTP or HTTPS.

    Note

    If you do not set a value for galileo-http-schema, the client first tries to connect by using HTTPS until a timeout limit is reached. It then tries HTTP. If you are using HTTP, to avoid the timeout delay, it is recommended that you set this value to HTTPS.

    /usr/libexec/PlistBuddy -c "Set galileo-http-schema PROTOCOL" ./Payload/Galileo.app/Info.plist

    Set the color of the button on the login and connection page.

    /usr/libexec/PlistBuddy -c "Set galileo-custom-brand-button-color-hex 0xff0000" ./Payload/Galileo.app/Info.plist

    Set the color of the text of the application name on the login and connection page.

    /usr/libexec/PlistBuddy -c "Set galileo-custom-brand-text-color-hex 0xff0000" ./Payload/Galileo.app/Info.plist

    Remove the BMC logo on the login and connection page, set the value to YES.

    /usr/libexec/PlistBuddy -c "Set galileo-custom-remove-bmc-logo YES" ./Payload/Galileo.app/Info.plist

    Set the color of the top level navigation bar background, set the hex color value.

    /usr/libexec/PlistBuddy -c "Set galileo-custom-navigation-bar-color-hex 0xff0000" ./Payload/Galileo.app/Info.plist

    Set the color of the top level navigation bar text, set the hex color value.

    /usr/libexec/PlistBuddy -c "Set galileo-custom-navigation-text-color-hex 0xff0000" ./Payload/Galileo.app/Info.plist

    Remove the white background on the login and connection page, set the value to YES.

    /usr/libexec/PlistBuddy -c "Set galileo-custom-remove-login-white-background YES" ./Payload/Galileo.app/Info.plist

    Remove the application name (full-app-name) on the login and connection page, set the value to YES.

    /usr/libexec/PlistBuddy -c "Set galileo-custom-remove-login-full-app-name YES" ./Payload/Galileo.app/Info.plist

    Login screen rebranding

    RebrandingLogin.jpg

    Navigation rebranding

    RebrandingApp.png


  4. Replace the mobile provision file.

    cp "SmartITWatchExtension.mobileprovision" 
    "./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch Extension.appex/embedded.mobileprovision"

    cp "SmartITWatch.mobileprovision"
    "./Payload/Galileo.app/Watch/Watch.app/embedded.mobileprovision"

    cp "SmartIT.mobileprovision" "./Payload/Galileo.app/embedded.mobileprovision"

  5. Remove the BMC code signature.

    rm -r "./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch Extension.appex/_CodeSignature/"

    rm -r "./Payload/Galileo.app/Watch/Watch.app/_CodeSignature"

    rm -r "./Payload/Galileo.app/_CodeSignature"

  6. Re-sign the IPA using the name of your company Apple iOS Distribution certificate installed on this machine in place of "iPhone Distribution: BMC Software, Inc.".

    /usr/bin/codesign -f -s "iPhone Distribution: BMC Software, Inc." --entitlements
    "./SmartITWatchExtension.entitlements"
    "./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch Extension.appex"

    /usr/bin/codesign -f -s "iPhone Distribution: BMC Software, Inc." --entitlements
    "./SmartITWatch.entitlements" "./Payload/Galileo.app/Watch/Watch.app"

    /usr/bin/codesign -f -s "iPhone Distribution: BMC Software, Inc." --entitlements
    "./SmartIT.entitlements" "./Payload/Galileo.app"

  7. Create the .ipa zip file.

    zip -qr "SmartIT-rebranded.ipa" Payload

    You must provide this new .ipa file when you deploy Smart IT to your users.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*