Brief overview
- Branding URL per platform.
- How to confirm files are on the correct format?
- Get originals either from the above link or from the Partner.
- Open them using free tools such as Gimp, Icofx, Junior Icon Editor, etc
- How to check the files are delivered to the endpoints?
- The link above will confirm the platform received and used the provided icons.
- Local Folder: %ProgramData%\CentraStage\Brand
- Depending on the branding state, on the path above you'll find:
- Custom Branding: custombrandused file
- Default Branding: defaultbrandused
- A dobrandupdate file will be present if the Agent needs to download branding updates
- A corrupted file will also be created in case branding is not accepted by the Agent
- PS: Like the key file, these files have no extension
- You should see the branded icons downloaded to this same path
Representation in Log.txt
Specific values from account and platform were replaced with ###, AccountID, PLATFORM-IP...
- Pushing DEPLOY from the platform
|INFO|16|CsControlConnection: Request is XmlRpc - "cagbrandingchanged" MessageId: ###|{ "requestMethod": "cagbrandingchanged", "messageId": "###" }
|INFO|14|UIBrandManager: Brand file changed - True|{ }
|DEBUG|14|UIBrandManager: Scheduling branding for download|{ }
|INFO|30|SoftwareJobWorker: ID=###, Name=Brand, FileCount=1, CredentialsRequired=False, Interpreter=, Options=, Extension=|{ }
|INFO|30|SoftwareJobWorker: Downloading package ###|{ }
|INFO|30|SoftwareJobWorker: Max download time for this component is 1 minutes.|{ }
|INFO|30|Download: Downloading "https://update.centrastage.net/branding/ACCOUNTID.zip" (https://PLATFORM-IP/branding/AccountID.zip) to "C:\ProgramData\CentraStage\Packages\###" with resume true and limited to 0|{ "Url": "https:\/\/update.centrastage.net\/branding\/AccountID.zip", "ResolvedUrl": "https:\/\/PLATFORM-IP\/branding\/AccountID.zip", "Filename": "C:\\ProgramData\\CentraStage\\Packages\\###", "UseResume": true, "MaxBytesPerSecond": 0 }
|INFO|33|Download: Download of https://update.centrastage.net/branding/AccountID.zip (https://PLATFORM-IP/branding/AccountID.zip) started OK|{ "Url": "https:\/\/update.centrastage.net\/branding\/AccountID.zip", "ResolvedUrl": "https:\/\/PLATFORM-IP\/branding\/AccountID.zip" }
|INFO|33|Download: Downloaded https://update.centrastage.net/branding/AccountID.zip (https://PLATFORM-IP/branding/AccountID.zip) to "C:\ProgramData\CentraStage\Packages\###"|{ "Url": "https:\/\/update.centrastage.net\/branding\/AccountID.zip", "ResolvedUrl": "https:\/\/PLATFORM-IP\/branding\/AccountID.zip", "Filename": "C:\\ProgramData\\CentraStage\\Packages\\###" }
|DEBUG|14|UIBrandManager: The server supplied brand hash is ####|{ }
|DEBUG|14|UIBrandManager: The local 'C:\ProgramData\CentraStage\Packages\###' brand hash is ####|{ }
|INFO|14|UIBrandManager: Brand file changed - False|{ }
|INFO|14|UIBrandManager: Setting up new brand at - C:\ProgramData\CentraStage\Packages\###|{ }
- DEBUG / TRACE Mode will give you extra about the icons individually on the device
|DEBUG|4|UIBrandManager: Found custom brand. And file verification has not been performed yet.|{ }
|DEBUG|4|UIBrandManager: Checking if UI Brand corrupted|{ }
|DEBUG|4|UIBrandManager: UI Brand online.ico, Height: 32, Width: 32|{ }
|DEBUG|4|UIBrandManager: UI Brand offline.ico, Height: 32, Width: 32|{ }
|DEBUG|4|UIBrandManager: UI Brand desktopshortcut.ico, Height: 32, Width: 32|{ }
|DEBUG|4|UIBrandManager: UI Brand ondemandmode.ico, Height: 32, Width: 32|{ }
|DEBUG|4|UIBrandManager: UI Brand stopped.ico, Height: 32, Width: 32|{ }
|DEBUG|4|UIBrandManager: UI Brand agentrto.ico, Height: 32, Width: 32|{ }
|DEBUG|4|UIBrandManager: UI Brand alertmodeonline.ico, Height: 32, Width: 32|{ }
|DEBUG|4|UIBrandManager: UI Brand alertmodeoffline.ico, Height: 32, Width: 32|{ }
|DEBUG|4|UIBrandManager: UI Brand privacymode.ico, Height: 32, Width: 32|{ }
|DEBUG|4|UIBrandManager: UI Brand primarylogo, Height: 176, Width: 176|{ }
|DEBUG|4|UIBrandManager: UI Brand patchrebootwindow, Height: 35, Width: 260|{ }
|DEBUG|4|UIBrandManager: UI Brand cagPrimaryText, Length: 84|{ }
- When branding file is incorrect/corrupt
Using privacymode.ico as example
|ERROR|15|UIBrand: UIBrand.GetIcon('privacymode.ico')|{ "exception": {"Message":"Argument 'picture' must be a picture that can be used as a Icon.", "Data":{}, "TargetSite":"Void Initialize(Int32, Int32)", "StackTrace":" at System.Drawing.Icon.Initialize(Int32 width, Int32 height)\r\n at CentraStage.Cag.Core.Agent.UIBrand.GetIcon(String fileName)", "Source":"System.Drawing", "HResult":-2147024809} }
|ERROR|15|UIBrandManager: Corrupted: privacymode.ico|{ }
Defaulting back on Platform
- Same process should be present in the logs
- Brand folder should then contain our stock icons instead of custom