|
|
|
|
|
Introduction to CONTROL-M client components installed on a Citrix machine
This best practice includes information and required steps for installing and setting up CONTROL-M client components on a Citrix machine.
For Citrix hardware settings for CONTROL-M client components, see Control-M/EM Hardware Sizing Template.
Before proceeding with CONTROL-M support, ensure that the latest Control-M fix packs are installed.
The following list includes references to setting up Control-M in a Citrix environment.
Security settings
Firewall
If the Control-M client and server components are separated by a firewall, the web server port must be open in the firewall.
SSL
For SSL communication with https, the Tomcat CA certificate must be included in the Windows trusted certificates store.
CONTROL-M/EM permissions
All users, whether admin or not, can access Control-M components on the Citrix machine.
The following table lists the Control-M/EM directory permission settings on the Citrix machine. Ensure that the following permissions are set accordingly.
Local path |
Permissions |
<EM DIR> |
Read Note: Ensure it is inherited to all its children |
<EM DIR>\log |
Read and Write |
<EM DIR>\data |
Read and Write Includes templates and ApplicationForms directory TimeZone.dat file includes time zone definitions Note: Ensure it is inherited to all its children |
<EM DIR>\bin\plugin |
Read and Write |
<EM DIR>\etc\domains\communication.xml |
Read and Write NOTE: This file must be accessible for all OS users. |
<EM DIR>\ini |
Read and Write For Control-M/EM administrator user |
<EM DIR>\client_health_check |
Read and Write |
<EM DIR>\usagetool |
Read and Write |
[HKEY_LOCAL_MACHINE] |
Read |
%APPDATA%\BMC Software\Control M Enterprise Manager\X.0.0.0\<Instance Name> |
Read and Write |
Login profile settings
Settings are stored per OS user (the user that logged into the Citrix client) and not per EM user.
When logged in for the first time, the directory %APPDATA%\BMC Software\ Control M Enterprise Manager\X.0.0.0\<Instance Name> is created. The directory includes the ClientUserSettings.xml file and another directory named Layout. The ClientUserSettings.xml file includes all user settings.
Log settings
You can configure log settings for specific Control-M components to collect information for troubleshooting purposes.
The following table includes a list of the components and the corresponding log file setting:
Component |
Log file setting |
CCM and XML utilities |
<EM_DIR>\ini\xxx_DiagLvls.ini (xxx is component name) Note: To prevent two processes from writing into the same file, set IsPIDUsed parameter to 1 in the ini file. |
CMWA automation client |
File > Options > Diagnostics. The debug level is saved in the file user.config in %LOCALAPPDATA%\BMC Software. Each user has their own settings |
Parent Topic |