CA ITCM Release 12.8 Readme

1.0 Welcome

Welcome to the CA IT Client Manager Release 12.8 readme. This readme contains supported operating environments, documentation changes, accessibility features, and known issues.

The readme is supplementary to the Release 12.8 documentation and is available only in English language.

Note: The localized versions of readme are available at support.ca.com.

CA ITCM Release Notes also contains information that is required to install, configure, and use the functionalities included in this release.

2.0 Hardware Specifications and Requirements

The following tables provide the minimum recommended hardware specifications and requirements for this release.

Actual hardware requirements depend on the system load on the system, including the frequency and amount of data collected and transferred and the number of operations.

2.1 Enterprise Manager Specifications

A DSM enterprise manager requires (at a minimum) the following hardware configuration:

2.2 Domain Manager Specifications

A DSM domain manager requires (at a minimum) the following hardware configuration:

2.3 Scalability Server Specifications

A DSM scalability server requires (at a minimum) the following hardware configuration:

Note: These minimums apply to all supported Windows, RedHat, and SuSE operating environments.

2.4 Agent Specifications

A DSM agent requires (at a minimum) the following hardware configuration:

Note: These minimums apply to all supported agent environments.

2.5 DSM Explorer Specifications

The DSM Explorer requires (at a minimum) the following hardware configuration:

Note: These minimums apply only to supported Windows operating environments.

2.6 Specifications for an SQL Server MDB on Windows

A Microsoft SQL Server management database (MDB) on Windows requires (at a minimum) the following hardware configuration:

2.7 Specifications for an Oracle MDB

Installing more than one Oracle MDB instance requires (at a minimum) the following hardware configuration:

3.0 Known Issues and Troubleshooting

This section describes the known issues, limitations, and solutions for this release.

3.1 CA ITCM Manager Installation Fails with SQL Server 2012 SP1

Symptom:

When I install CA ITCM manager on a system with SQL Server 2012 SP1 installed, the ITCM installation fails with the following error:

Installation of 'CA Secure Socket Adapter failed'
Return Code1618

Solution:

This error is due to an issue on SQL Server 2012 SP1, msiexec.exe processes run after installation of SQL Server 2012 SP1. When you install CA ITCM manager; as another MSI installer is in progress, the installation fails with the error 1618.

Microsoft has posted a description of the bug and a link to the patch (KB2793634). For example, https://support.microsoft.com/kb/2793634. Also, you can download the fix from Microsoft Downloads section. For example, http://www.microsoft.com/en-us/download/details.aspx?id=36215.

3.2 OS Deployment Fails While Using Centralized NFS Share for CA ITCM OSIM

Symptom:

When I use CA ITCM OSIM to deploy SLES 11.x, OpenSuSE 12.x, Oracle Enterprise Linux, and XenServer 6.x operating systems using the centralized NFS share, operating system installation hangs at the target machine.

Solution:

You can fix this issue in the following manner:

• Use CD/DVD option for creating the OS Images of the mentioned operating systems instead of the centralized NFS server.

3.3 CA ITCM Domain Manager Installation Fails

Symptom:

CA ITCM domain manager installation on Windows, Oracle MDB fails, only when ITAM 12.8 is already installed.

Solution:

Follow these steps:

1. Rename the folder jre under the path \Program Files\CA\SC\Mdb\Windows\ as jre_OLD.
2. Copy the JRE folder under the path \WindowsProductFiles_x86\JRE from DVD to C:\Program Files\CA\SC\Mdb\Windows\
3. Start the ITCM installation.
4. After the installation completes, perform the following steps:
   • Rename the folder jre as jre_1.7
   • Rename the folder jre_OLD as jre.

Note: When you do not install ITAM, install CA ITCM and then ITAM to avoid these manual steps.

3.4 Staging or Deployment of OS Image Fails

Symptom:

Staging or deployment of RHEL, SLES, Open SUSE, ESXi, and XEN Server OS image fails if boot server is running on Windows 8 and Windows Server 2012 and later versions.

Solution:

Use the boot server on any other supported operating systems. See the compatibility matrix for supported boot server operating systems.

3.5 Location Awareness Rule Evaluation

Caf restart triggers Location Awareness rule evaluation when the hidden comstore parameter disable_la_on_all_registers is set to 0 and caf restart does not trigger Location Awareness rule evaluation when the hidden comstore parameter disable_la_on_all_registers is set to 1.

You can create the parameter on the agent machine with the following command:

ccnfcmda -cmd setparametervalue -ps itrm/agent/solutions/generic/LocationAware -pn disable_la_on_all_registers -v 1

3.6 IP Address Range for Location Awareness Evaluation

Symptom:

Location Awareness evaluation does not include the boundary values of IP address range.

Solution:

Define the expected IP address range with the preceding and succeeding values in both starting and ending directions respectively. For example, if you want an IP address range of 10.10.10.1-10.10.10.10, specify the range 10.10.10.0-10.10.10.11.

3.7 DMM: Recent Document Settings and DMM Share Access

Recent Document Settings

CA ITCM delivers a new recent document settings option for all CA ITCM-supported MS-Office applications. You can now select the recent document settings. This option works only if files are available at the same location as before migration. Otherwise, when you click the recent document, it displays a standard system error.

Configure DMM Share Access:

When the DMM network share runs on Windows Server 2008 or higher, the DMM Apply procedure execution fails with a runtime error on some of the target machines during the restoration phase.

Follow one of these steps:

• Use a DMM network share that runs on Windows Server 2003 SP2.
• Use a DMM network share that runs on Windows Server 2008 SP2 or Windows Server 2008 R2, with SMB 2.0 disabled as follows:
  1. Open Regedit.
  2. Navigate to HKLM, System, CurrentControlSet, Services, LanmanServer, Parameters.
  3. Add a DWORD key with the name smb2 and set the value to 0.
  4. Restart the server.

3.8 Change in SD Deployment Behavior in DSM GUI When Using Specific Computer Group, Software Group or Procedure Group

When a particular Computer Group, Software Group or Procedure group is selected, the options to Deploy Software Packages, Deploy SW Group and Deploy procedure Group respectively, are hidden if no selection is made in the right-hand pane of the selected entity.

3.9 Error with Owned Inventory Links

Symptom:

When I open CA ITCM WAC, Console, Computer and Users, All computers, Host, Inventory tab, Owned inventory, and click any of the following links:

• Generic components
• Specific components
• Legal Info and
• Cost Info

I get the following error:

Error: The SELECT permission was denied on the object 'arg_rel_asset_cfg_gen', database 'mdb', schema 'dbo'.

Solution:

The error is due to a problem with user ca_itrm permissions. You can fix this issue by applying the patch RO65886 available at support.ca.com.

3.10 Creating a Package on Windows 8 Fails

Symptom:

When I run SXP Packager to create a package on Windows 8, I get the following error message:

Error 007 The following file could not be copied:
C:\autoexec.bat to C:\Program Files\CA\DSM\bin\Save\001\asc0001.sav

Solution:

You can fix this issue in the following manner:

• Delete the DSM\bin\Save folder before creating a package.
• Verify that .NET framework 3.5 is installed and enabled.

For more information, see Prerequisites for SXP Packager on Windows 8 in CA ITCM Packager Admin Guide.

3.11 Creating a Package on Windows 2008 x64 Fails

Symptom:

When I run SXP Packager to create new package on Windows 2008 x64, I get the following error message:

GetLink.exe has stopped working.

Solution:

You can fix this issue in the following manner:

1. Go to Microsoft Download Center.
2. Download and Install Microsoft Visual C++ 2010 Redistributable Package (x64).

For more information, see Microsoft documentation.

3.12 WAC External Assets Support

This release does not support view and management of the External Assets in WAC.

3.13 WAC Change of Browser Locale

When you change the locale on the browser, logout and relogin to WAC for better functionality.

3.14 caf status cfProcessManager Shows Alert Collector Process Information as Empty

If you did not install Alert Collector, the command output must not show an entry for Alert Collector.

However, on Windows computers, the caf status cfprocessmanager command shows the Alert Collector process information as empty even if Alert Collector is not installed.

4.0 Documentation Changes

This section describes the changes and revisions in the documentation.

4.1 CHM and Java Help

The CHM and Java Help files are not updated for this release.

4.2 Language Support for ITCM Release Notes in DMM Documentation

CA ITCM Release Notes in the DMM is available at Bookshelf_Files, PDF folder in the following languages only:

• English
• French
• German
• Japanese

4.3 Asset Management Admin Guide: Collecting Delta Values

In the Configuring Asset Management, Collect Tasks, Collecting Delta Values section, ignore the following note:

Note: The agent does not send delta values in case of signature scanning.

4.4 Implementation Guide: Automated Migration

In the Implementation Guide, see the following Automated Migration topics for more information about Installing Automated Migration.

4.4.1 Configure Automated Migration

Before you can use automated migration, complete the following tasks:

1. Configure CA IT PAM User Account in CA ITCM.
2. Enable SSL for Web Console and Automation Web Services.
3. (Optional) Modify Automation Service Configuration File.

4.4.1.1 Configure CA IT PAM User Account in CA ITCM

Automated migration uses CA IT PAM to automate the OS migration workflow. To enable CA IT PAM to interact with CA ITCM, configure a CA IT PAM user account in the DSM domain manager.

Note: The CA IT PAM user that you are configuring must have execute permissions in CA IT PAM.

To configure CA IT PAM user account in CA ITCM

1. Create a local WINNT user account for the CA IT PAM user in the domain manager computer. You can skip this step, if you want to use LDAP user credentials of the CA IT PAM user.

   Important! Automated migration does not support Sun One Directory Server. If you are using Sun One Directory Server as your LDAP, use a WINNT user account for the CA IT PAM user.

2. Add the CA IT PAM user account to CA ITCM security profiles and grant Full Control to the following security object classes:
   • Software Job
   • Computer
   • Software Job Container
   • OS Installation Image
   • Procedure
   • Asset Group
   • Common Query
   • Manager
   • Database Credentials
   • Policy Software Based
   • Software Group
   • Software Package

   The CA IT PAM administrator is authorized to access CA ITCM to perform the necessary functions. You specify the credentials of this user while creating the migration jobs.

4.4.1.2 Configure DMM Share Access

If the DMM network share runs on Windows Server 2008 or higher, the DMM Apply procedure execution can fail with a runtime error on some of the target machines during the restoration phase.

Follow one of these steps:

• Use a DMM network share that runs on Windows Server 2003 SP2.
• Use a DMM network share that runs on Windows Server 2008 SP2 or Windows Server 2008 R2, with SMB 2.0 disabled as follows:
  1. Open Regedit.
  2. Navigate to HKLM, System, CurrentControlSet, Services, LanmanServer, Parameters.
  3. Add a DWORD key with the name smb2 and set the value to 0.
  4. Restart the server.

4.4.1.3 Enable SSL for Web Console and Automation Web Services

Enabling Secure Socket Layer (SSL) for Web Console and automation web services lets them communicate over a secure channel.

Follow these steps:

1. Follow the instructions in the Enable SSL for Web Console and Web Services topic in Web Console Help.
2. Change the value of the following parameters in the WACConfig.properties file in addition to the parameters specified in Enable SSL for Web Console and Web Services topic in the DSM Web Console Help:
   • WIN7SERVICE_URL:

     Defines the automation web service URL. Modify the URL to start with https instead of http. For example, https://testmachine.test.com/axis/services/automationService

   • ITCMEPR

     Defines the CA ITCM WebService URL. Modify the URL to start with https instead of http. For example, https://testmachine.test.com/UDSM_R11_WebService/mod_gsoap.dll

3. Complete the remaining instructions in the Enable SSL for Web Console and Web Services topic.

4.4.1.4 (Optional) Modify Automation Service Configuration File

The automation service configuration file contains configuration parameters that automated migration uses for various tasks. In most cases, the default settings help automated migration to work with optimized performance. However, you can modify certain settings to improve the job performance depending on your environment, the load that your servers can handle, and so on.

To modify the automation service configuration file

1. Open the C:\Program Files\CA\DSM\Automation Service\bin folder or %autohome%\bin folder.
2. Edit the automation.config file in a text editor.
3. Change the value of the required parameters. For more information about each parameter, see Automation Service Configuration File.

   Note: An integer value in the automation.config file must not contain or be surrounded by spaces. When you specify an integer value in the automation.config file, verify that there is no space, within and around the value. Any space in the integer value can result in the malfunctioning of the automation service.

4. Save the file and restart tomcat using the following commands:

   caf stop tomcat

   caf start tomcat

   The changes to the configuration file take effect.

4.5 Implementation Guide: How to Configure and Monitor the CA ITCM Infrastructure Health

In the How to Configure and Monitor the CA ITCM Infrastructure Health, Understand HM Architecture and Basics, Health Monitoring Components, Alert Collector section, read the following notes.

Note: Whenever the FIPS mode is changed, verify the associated Change Action parameter value. If the parameter value is other than Reboot the machine, after the CAF restart you must also restart the following ones to switch the FIPS mode successfully for all the CA ITCM components:

On a Manager or standalone Alert Collector computer:

• Alert collector
• Health Monitoring Agent

On a scalability server or agent computer:

• Health Monitoring Agent

4.6 CA Patch Manager Solution Guide: Understanding Offline Patching Architecture

In the Understanding Offline Patching Architecture section, read the following notes for Online Export topic:

Note: The CIC installer provides an option for automatic startup at the end of the installation as a service. After the installation, restart the computer to start the service automatically without any manual intervention.

4.7 Implementation Guide: Appendix-H: Accessibility Features

Read the following Accessibility Features section as Appendix-H in Implementation Guide.

4.7.1 Accessibility Features

CA Technologies is committed to ensuring that all customers, regardless of the ability, can successfully use its products and supporting documentation to accomplish vital business tasks. This section outlines the accessibility features that are part of CA ITCM.

4.7.1.1 Product Enhancements

CA ITCM offers accessibility enhancements in the following areas:

• Display
• Sound
• Keyboard
• Mouse

Note: The following information applies to Windows-based and Macintosh-based applications. Java applications run on many host operating systems, some of which already have assistive technologies available to them. For these existing assistive technologies to provide access to programs written in JPL, they need a bridge between themselves in their native environments and the Java Accessibility support that is available from within the Java virtual machine (VM). This bridge has one end in the Java VM and the other on the native platform, so it is slightly different for each platform it bridges to. Sun is currently developing both the JPL and the Win32 sides of this bridge.

Display

To increase visibility on your computer display, you can adjust the following options:

• Font style, color, and size of items

  Lets you select font color, size, and other visual combinations.

• Screen resolution

  Lets you change the pixel count to enlarge objects on the screen.

• Cursor width and blink rate

  Lets you make the cursor easier to find or minimize its blinking.

• Icon size

  Lets you make icons larger for visibility or smaller for increased screen space.

• High contrast schemes

  Lets you select color combinations that are easier to see.

Note: If you want to enable the separated user interface for operating systems prior to Windows Vista instead of using the in-process GUI, apply the The Software Delivery, Agent, Always display GUI for logged on user configuration policy.

Note: To enable the assistive technologies (AT) to read the text from the SD job check window in operating systems prior to Windows Vista, apply the Software Delivery, Agent, Always display GUI for logged on user configuration policy to the agent.

Sound

Use sound as a visual alternative or to make computer sounds easier to hear or distinguish by adjusting the following options:

• Volume

  Lets you turn the computer sound up or down.

• Text-to-Speech

  Lets you hear command options and text read aloud.

• Warnings

  Lets you display visual warnings.

• Notices

  Gives you aural or visual cues when accessibility features are turned on or off.

• Schemes

  Lets you associate computer sounds with specific system events.

• Captions

  Lets you display captions for speech and sounds.

Keyboard

You can make the following keyboard adjustments:

• Repeat Rate

  Lets you set how quickly a character repeats when a key is struck.

• Tones

  Lets you hear tones when pressing certain keys.

• Sticky Keys

  Lets those users who type with one hand or finger select alternative keyboard layouts.

Keyboard Shortcuts

The following table lists the keyboard shortcuts that CA ITCM supports:

Note: We have added a hot key, F6, in this feature pack to enhance product accessibility. With F6, navigation between panes of the SD Catalog and the Remote Control viewer is easier.

Mouse

You can use the following options to make your mouse faster and easier to use:

• Click Speed

  Lets you select how fast to click the mouse button to make a selection.

• Click Lock

  Lets you highlight or drag without holding down the mouse button.

• Reverse Action

  Lets you reverse the functions controlled by the left and right mouse keys.

• Blink Rate

  Lets you select how fast the cursor blinks or if it blinks at all.

• Pointer Options

  Let you do the following:

  • Hide the pointer while typing
  • Show the location of the pointer
  • Set the speed that the pointer moves on the screen
  • Select the size and color of the pointer, for increased visibility
  • Move the pointer to a default location in a dialog

4.7.1.2 Workarounds and Limitations

This section describes accessibility workarounds and limitations.

4.7.2 Truncated Text in the Remote Control Viewer

When you change display settings to High Contrast in the Remote Control viewer, some text can be truncated. Alternate (ALT) text is provided as a workaround.

4.7.3 Link List Contents May Change Depending on Focus

For the Remote Control viewer, all links are not displayed in the Links List window with Ins+F7. Link list contents can change depending on the focus because there are two HTML views on the Remote Control viewer page.

The links of the HTML view having focus appear in the Links List window. Use the F6 hot key to switch between HMTL views. This hotkey is useful for the screen reader for reading out information displayed on the screen, as the screen reader behavior depends on the focus on HTML view. As there are two HTML views on the Remote Control viewer page, the screen reader reads the HTML view having focus.

4.7.4 Using the JAWS Screen Reader in the Remote Control Viewer and Replayer

There is a known problem with the JAWS® Screen Reading Software when reading windows composed of more than one HTML view. After continued use, keyboard navigation and link activation can become unpredictable.

To improve consistency, we recommend that you disable the "as Web Page" option in the Remote Control viewer or replayer using the View, Current menu. Also, hide the Tutorial Bar whenever it is not in use.

You can also experience better results with the Remote Control viewer by disabling the Virtual PC Cursor using the JAWS+Z key combination.

4.7.5 Remote Sessions Limitation

In the case of the Remote Control viewer, the screen reader and any changes to the display settings do not work for remote sessions.

4.7.6 High-Contrast Mode Features

In high-contrast mode, the Remote Control viewer automatically makes some visual changes to enhance the visibility of the user interface. If high-contrast mode is enabled or disabled dynamically while the Remote Control viewer is in use, refresh the GUI, for example, by switching to a different node, to display the high-contrast changes.

Note: To refresh the RC Viewer Tutorial page, you can click any link in the tutorial.

5.0 Third-party License Agreements

The license agreements for this release are available in Bookshelf\Release Information\Third-Party License Agreements.

6.0 Contact CA

Contact CA Support

For your convenience, CA Technologies provides one site where you can access the information that you need for your Home Office, Small Business, and Enterprise CA Technologies products. At http://ca.com/support, you can access the following resources:

• Online and telephone contact information for technical assistance and customer services
• Information about user communities and forums
• Product and documentation downloads
• CA Support policies and guidelines
• Other helpful resources appropriate for your product

Providing Feedback About Product Documentation

If you have comments or questions about CA Technologies product documentation, you can send a message to techpubs@ca.com.

To provide feedback about CA Technologies product documentation, complete our short customer survey which is available on the CA Support website at http://ca.com/docs.

Copyright © 2013 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.