Last modified:	Thursday, Mar 8, 2007	Article ID:	23
Related products:	Xcalibur Global Management Software

---

Objectives

This document teaches how to use Xcalibur Global to configure custom icons.

Users can add custom icons to the Xcalibur Global icon pool. These icons can then be used in various connections created via Xcalibur Global or locally on the client device.

The method taught in this document is based on the following steps:

1. Select the OU containing the target device.
2. Create an Xcalibur Policy that is linked to the selected OU.
3. Configure the Xcalibur Policy to configure custom icons.

Applicable Product Version

• Xcalibur Global v.1.1 rev.2
• 2007 Resource Kit v.1 & SP3
• Chip PC client device firmware v.6.5.4
• Hot fix v.1 for Chip PC client device firmware v.6.5.4

Procedure

Select the OU Containing the Target Device

• The OU in our example is Thin Clients Demo
• The Domain in our example is net2.qa2

1. Launch the Xcalibur Global Management Console:
   From the Task Bar select:
   Start \ Programs \ Xcalibur Global 1.1 \ Management Console.
2. Locate the OU Thin Clients Demo:
   Expand the path:
   Xcalibur Directory Manager \ net2.qa2
   
   
   
3. Select the OU Thin Clients Demo.

Create an Xcalibur Policy that is linked to the selected OU

1. Right-click on the OU (Thin Clients Demo) to display the following drop-down menu:
   
   
   
2. Select Properties from the drop-down menu to display the OU properties.
3. A window titled <OU Name> Properties will appear.
4. Select the Xcalibur Policy tab.
5. Click the New button and select TC Policy from the drop-down menu to create a New Xcalibur Policy Object that will appear in the Xcalibur Policy Object Links column.
   
   
   
6. Enter a new name for the policy. In this example, we will be using the name Device – Custom Icon in RDP Connection. Press Enter.

Configure the Xcalibur Policy to configure custom icons

1. Select the Xcalibur Policy tab.
   
   
   
2. Select the new policy.
3. Click Edit to open the Policy Editor.
4. Expand the following policy branch:
   <policy name> \ Device Configuration \ 2007 Resource Kit v.1 \ Shell
   
   
   
5. Select the Custom Icons.
6. In the right pane, double-click on a Custom Icon <#>.
7. The Custom Icon <#> window will appear.
8. Select the Enabled option.
   
   
   
9. Click on the Browse for the icon file button.
10. The following Open window will appear.
    
    
    
11. Browse and select an icon file that is to be associated with the
    Custom Icon <#>.
12. Click the Open button to save your selection and continue.
13. The selected icon will now appear in the Custom Icon <#> window.
    
    
    
14. Click OK to save your settings and exit the Custom Icon <#> window.
15. Click to close the Policy Editor window and return to the Xcalibur Policy tab window.
16. Click OK to return to the Xcalibur Global Management Console window.

Conclusion

• Xcalibur Global now has a policy that will configure custom icons.
• The policy is linked to the OU that was selected.
• The policy will affect all devices within the OU and any child OUs (as long a there are no restrictions on policy inheritance).

Appendix – How to use a custom icon in a connection

To use a custom icon in a connection (ICA, RDP, IE, etc.), follow the procedure detailed below:

1. Locate the connection’s Change Icon button.
   For a new connection, the button will appear in the connection creation wizard.
   For an existing connection, the button will appear in the connection’s properties.
2. Click on the Change Icon button. The following window will appear:
   
   
   
3. Browse through the icons and select the desired Custom Icon #X.
4. Click OK to save your selection and to close the Change Icon window.
5. Return to the Policy Editor window. 
   For a new connection, complete the connection creation wizard.
   For an existing connection, click OK to save your changes and close the connection’s properties window.
6. Click to close the Policy Editor window and return to the Xcalibur Policy tab window.
7. Click OK to return to the Xcalibur Global Management Console window.

Movie: