CA

CA Licensing Readme r1.90.07

______________________________________________________________________

1.0  Welcome

2.0  Operating System Support
2.1  Microsoft Windows (Operating System Support)
2.2  UNIX

3.0  Version Identification

4.0  IPv6 Support

5.0  Installation Considerations
5.1  Microsoft Windows
5.2  Linux and UNIX
5.3  $CASHCOMP
   5.3.1  Return Values

6.0  General Considerations

7.0  Known Issues
7.1  RPM Deletes Files During Upgrade on SuSE Linux 9.0
7.2  Installing an Older Version of CA LicensingLink Issues for Linux and UNIX Only
7.3  Windows Administrator Only Writable Issue
7.4  Linux/UNIX World Writable Issue
7.5  Removal of licrmt and licrmtd
7.6  Separate Installation Script
7.7  Single Threaded DLL

8.0  Changes Made After r1.8
8.1  Enhancement (Windows Only)
8.2  Issues Fixed

9.0  Published Fixes

10.0  International Support

11.0  Contact CA

______________________________________________________________________
1.0  Welcome

Welcome to CA Licensing 1.9. This document contains
operating system support, installation considerations,
known issues, and information about contacting CA Technical
Support.

______________________________________________________________________
2.0  Operating System Support

CA supports these operating systems for the duration of
their life cycle as determined by the operating system's
manufacturer or until CA announces that it is dropping
support. For the latest information about supported
operating systems, visit http://ca.com/support.

The following provides information about the operating
systems and minimum service packs supported by CA Licensing.

2.1  Microsoft Windows (Operating System Support)

Note: CA Licensing 1.63.02.03 is the last supported version
of licensing for Windows 98 and ME.

 *   Microsoft Windows NT 4 SP6A

 *   Microsoft Windows 2000 SP3

 *   Microsoft Windows 2000 SP4 Rollup1

 *   Microsoft Windows XP Professional SP3

 *   Microsoft Windows 2003 Server

 *   Microsoft Windows Vista

 *   Microsoft Windows 2008 Server
 
 *   Microsoft Windows 7

 *   Microsoft Windows 8

 *   Microsoft Windows 2012 Sever



Note:  Support for AMD and Itanium 64-bit platforms is
included for Microsoft Windows XP, Windows 2003 Server,
Vista, and Windows 2008 Server.

2.2  UNIX

 *   AIX 5.1+ for PowerPC 32- and 64-bit

 *   DEC Tru64 4.0

 *   HP 11.11+ for PA-RISC 32- and 64-bit 

 *   HP 11.23+ for PA-RISC 32- and 64-bit

 *   HP 11.x for Itanium

 *   Linux AMD - (Kernel version - 2.6.16.21-0.8-smp) for AMD
     64-bit

 *   Linux (Kernel version 2.2) for Intel 32-bit

 *   Linux (31-bit) (Kernel version 2.2) for s390. Only 32-bit
     libraries are provided.

 *   Solaris 5.10 for AMD 32- and 64-bit

 *   Solaris 5.10 for Intel 32-bit

 *   Solaris 5.8+ for SPARC 32- and 64-bit

 *   MAC OS (Kernel version 8.9.0+) for PowerPC

 *   MAC OS (Kernel version 8.7.0+) for Intel

______________________________________________________________________
3.0  Version Identification

The latest version of CA Licensing on Windows is r1.90.07.

The latest version of CA Licensing on Linux is r1.90.04 and UNIX is
r1.90.03

______________________________________________________________________
4.0  IPv6 Support

IPv6 is enabled in r1.8 and later versions and can operate
in the following environments:

 *   Pure IPv4

 *   Pure IPv6

 *   Mixed IPv4 and IPv6

CA Licensing r1.8 leverages underlying operating system's
IPv6 features to provide IPv6 support. For configuring IPv6
on your operating system,  refer to your operating system
manual.

Important! CA Licensing r1.8 has IPv6 support as long as
the operating system supports IPv6 and the operating system
is configured to use IPv6. Microsoft Windows NT, Microsoft
Windows 2000, and DEC Tru64 are the only platforms
supported that do not have IPv6 support.

______________________________________________________________________
5.0  Installation Considerations

5.1  Microsoft Windows

Important! Prior to installing CA Licensing, all CA
products must be shut down.

To install or upgrade CA licensing, run silent.exe from a
command line, or double-click the icon on your desktop. CA
Licensing installs the native system language by default.

To force an installation to a drive other than the system
drive, run the following from a command line: 

 silent.exe <system-drive-letter>

Replace system-drive-letter with the drive letter of the
system. The system-drive letter is optional. For example:

 silent.exe E

This localized installation also installs the native system
language by default.

Silent.exe exits when trying to install CA Licensing on a
non-supported platform (such as Windows 95/98 or ME) with
no visible message to the user. However, a message is
recorded in the installation logs.

The content of CA_LIC should not be modified by the client.
If any files are deleted or modified, CA Licensing becomes
unstable or inoperable. Any subsequent installations of CA
Licensing to fix the problem will not necessarily work.

5.2  Linux and UNIX

To install or upgrade CA licensing, run the following from
a command line:

 ./install <installation-path>

Replace installation-path with the complete path. The
installation-path is optional.

If $CASHCOMP is defined on the user system, see $CASHCOMP.

Note: It may be necessary to source /etc/profile or
/etc/csh.login (depending on the shell) to set up the user
environment variables. 

On Linux, the installation script invokes the following rpm
command by default:

 rpm -U --replacefiles --replacepkgs --prefix $CASHCOMP ca-lic*rpm

5.3  $CASHCOMP

If $CASHCOMP is defined on the user system, the
installation path argument is ignored, if provided. 

If $CASHCOMP is not defined and the installation path is
not provided, the default value of the installation path is
assumed as one of the following:

 *   /Library/Application Support/CA/SharedComponents for MAC OS

 *   /opt/CA/SharedComponents for the rest of the UNIX platforms

If only $CALIB is defined, $CASHCOMP is defined as the
parent directory of $CALIB. 

5.3.1  Return Values

The following table lists the return codes that are output
to stderr (the console):

======================================================================
Value  Definition
======================================================================
0      Success
------ ---------------------------------------------------------------
21     Installpath directory exists, but is not writable
------ ---------------------------------------------------------------
23     CA_LIC directory exists, but is not writable
------ ---------------------------------------------------------------
27     Installation must be performed by a user with root permissions
------ ---------------------------------------------------------------
30     Error copying files
------ ---------------------------------------------------------------
31     Unable to create all symbolic links in lib library
------ ---------------------------------------------------------------
33     Unable to create symbolic link to CA_LIC directory
------ ---------------------------------------------------------------
34     Component may not be installed in the root directory
======================================================================

______________________________________________________________________
6.0  General Considerations

A complete list of CA product descriptions can be found at
www.ca.com. 

______________________________________________________________________
7.0  Known Issues

This section describes known issues, workarounds, and
solutions for this release of CA Licensing.

7.1  RPM Deletes Files During Upgrade on SuSE Linux 9.0

While attempting to upgrade an installation on SuSE Linux
9.0, RPM deletes all files that are marked to be updated
instead of updating them. To prevent this problem, upgrade
the Linux installation to SuSE 9.0 SP1.

7.2  Installing an Older Version of CA LicensingLink Issues for Linux and UNIX Only

If CA Licensing r1.8 is already installed and an attempt is
made to install an older version, the r1.8 installation
remains intact and functional, but several soft links
(depending on the platform), may not be removed. These may
include the following:

 *   $CASHCOMP/lib/liblicdscvr.so

 *   $CASHCOMP/lib/liblicencrypt.so

 *   $CASHCOMP/lib/licdscvr.so

 *   $CASHCOMP/lib/licencrypt.so

These soft links are not needed by version r1.8 and can be
manually deleted.

7.3  Windows Administrator Only Writable Issue

Several files in the licensing system require update. In
releases prior to 1.63, several files were writable only
for users logged on with administrative privileges.
Beginning In release r1.70, a user logged on without
administrator privileges can exercise license code
properly. Installation of licensing requires administrative
authority and has not been altered by this release.

A process/program named logwatnt is launched to manage
update access of files. 

7.4  Linux/UNIX World Writable Issue

Several files in the licensing system require update. In
releases prior to 1.63, several files were "world
writable." Beginning in release r1.70, the permissions of
these files are changed to "644." 

The permissions of the following files are changed:

 *   ca.olf

 *   lic98.log

 *   lic98dbg.log

 *   lic98.dat

A new process/program named lic98fds will be launched to
manage update access of files. This program will be a
"setuid" authority. Since the license system is "root,"
lic98fds will be a "setuid root" program.

A new script named lic98setowner can be used to change the
owner of this program and the files it manages. The syntax
is as follows:

 lic98setowner <new-owner>

If you do not provide a <new-owner> on the command line, the
script prompts you to provide one.

7.5  Removal of licrmt and licrmtd

Beginning with r1.70, all references to licrmt and licrmtd
have been removed.

Upgrading to CA Licensing 1.9 will not delete licrmt and
licrmtd modules from an existing installation. This is to
ensure backward compatibility or the instances where licrmt
logic may be in force. The CA license client remains active
if it is already deployed.

7.6  Separate Installation Script

For each non-Windows platform on which CA Licensing is
supported, there is a separate installation package and a
separate install script.

7.7  Single Threaded DLL

Lic98.dll is a single threaded DLL. When using the
Licensing API, consider calling the Licensing API from the
CRITICAL SECTION of your code.

______________________________________________________________________
8.0  Changes Made After r1.8

8.1  Enhancement (Windows Only)

A bundling enhancement has been implemented to allow user
counts to be specified in the lic_comp_codes.dat file.

Releases prior to CA Licensing r1.9 had 1 user license 3AES
count that could generate 1 license for each 325C, 325D,
325V and 325I. The following string is the bundle code:

 <3AES,CA ARCserve Backup r12.0 for Microsoft Essential Business Server - Standard Edition!325C!325D!325V!325I>

With r1.9, 1 user license count can generate a certain user
count based on the number defined for the specific
component. For instance, 3 counts are defined for 325C and
4 counts are defined for 325D. 

In r1.9, 1 user license 3AES can generate 4 licenses for
325C, 3 licenses 325D, 1 user license 325V and 1 user
license 325I. The following string is the bundle code:

 <3AES,CA ARCserve Backup r12.0 for Microsoft Essential Business Server - Standard Edition!325C(3)!325D(4)!325V!325I>

8.2  Issues Fixed

The following are fixes made in 1.90.05:

*	'lic98-port' file left
	Sometimes lic98-port file is left behind, which prevents the Event Log Watch Service to restart.

The following are fixes made in 1.90.04:

*	Crash in MergeOlf.exe
	When using CALicnse.exe and the current directory is not same as the CA Licensing installed directory, a crash is reported within MergeOlf.exe.

*	Error Code 7316 returned on 64 bit Windows
	In few WoW64 machines, validating a license results in 7316 error due to machine type mismatch.

*	Problem installing CA Licensing using silent.exe
	CA Licensing installation fails when using silent.exe on a windows machine, where 8.3 filename is disabled and is installed as a non-admin user. 

*	Soft links, Lic98err directory are removed during upgrade to the latest from r1.7.x or later versions in Linux using RPM. 
	When upgrading from older version (specifically r1.7.x until 1.9.03), the soft links created for backward compatibility in /opt/CA are deleted. Also, the Lic98err directory which exists in CA-Licensing install directory is also deleted.

The following are fixes made in 1.90.03:

*	Vulnerabilities when using the system commands directly in UNIX platform and weak encryption algorithm. (UNIX and Windows) 
	The system commands like ps are used directly in Licensing. So, if a rogue script is replaced for ps then the machine could be vulnerable. This has been addressed ensuring that proper system ps is used.

	The encryption algorithm used is within a machine and for writing only the log information. As the data is not critical, added extra authentication to validate the invoker in lic98service.exe before writing the data. 

The following are fixes made in 1.9.02:

 *	Licreg.dll crashing during silent registration.

     	Licreg.dll is crashing while silent registration when ca_register_now function is 		called with silntreg.ini. This issue is resolved .

 *	Negative User count for ARCserve Channel license keys with Usercount "999999999"

     	When License keys with usercount 999999999 are applied, multiple of this count by factor greater than 2 resulting in negative value. This issue is resolved. 
 
 *	English messages are diaplaying in Localized versions
	
	English message is shown for invalid Proxy setting from product registration dialog in Localized versions. This is resolved for the languages that are supported by MFC.
	
The following are fixes made in 1.9.01:

 *   Memory Leak in Licensing DLL (32-bit and 64-bit Versions)

     A memory leak was found in the ca_license_query function
     when called with the LIC_USER_COUNT parameter.  The memory
     leak issue is resolved.

 *   Licensing APIs in 64-bit Windows Environment  (64-Bit Only)

     The licensing APIs in 64-bit Windows was indicating it had
     expired prior to the trial period. This issue is resolved. 

The following are fixes made after r1.8:

 *   Service Log Watch Service Message Not Translated

     The text CA Licensing Event Log Management was in English
     only. This text is now translated.

 *   Error Box Dialog No Longer Displayed for Windows Vista and
     Windows 2008 Server Operating Systems Due to Windows
     Security Policy Update

     The security policy states that "applications running in
     Session 0 should not create pop-up message boxes". In CA
     Licensing r1.9, the Log Watch Service running as a service
     in Session 0 no longer creates an error box display for
     Windows Vista and Windows 2008 Server.

 *   Executable Files Contain Manifest Information

     All executable files (.exe files) contain mainfest
     information to comply with Windows 2008 logo certification.

______________________________________________________________________
9.0  Published Fixes

All published fixes for this product can be found in
Published Solutions on http://ca.com/support.

______________________________________________________________________
10.0  International Support

An <internationalized> product is an English product that
runs correctly on local language versions of the required
operating system and required third-party products, and
supports local language data for input and output.
Internationalized products also support the ability to
specify local language conventions for date, time,
currency, and number formats.

A <translated> product (sometimes referred to as a <localized>
product) is an internationalized product that includes
local language support for the product's user interface,
online help and other documentation including local
language default settings for date, time, currency, and
number formats.

In addition to the English release of this product, CA
supports <only> those languages listed in the following table.

======================================================================
Language                     Internationalized        Translated
======================================================================
Brazilian-Portuguese         Yes                      Yes
---------------------------- ------------------------ ----------------
Chinese (Simplified)         Yes                      Yes
---------------------------- ------------------------ ----------------
Chinese (Traditional)        Yes                      Yes
---------------------------- ------------------------ ----------------
Czech                        No                       No
---------------------------- ------------------------ ----------------
Danish                       No                       No
---------------------------- ------------------------ ----------------
Dutch                        No                       No
---------------------------- ------------------------ ----------------
Finnish                      No                       No
---------------------------- ------------------------ ----------------
French                       Yes                      Yes
---------------------------- ------------------------ ----------------
German                       Yes                      Yes
---------------------------- ------------------------ ----------------
Greek                        No                       No
---------------------------- ------------------------ ----------------
Hungarian                    No                       No
---------------------------- ------------------------ ----------------
Italian                      Yes                      Yes
---------------------------- ------------------------ ----------------
Japanese                     Yes                      Yes
---------------------------- ------------------------ ----------------
Korean                       Yes                      Yes
---------------------------- ------------------------ ----------------
Norwegian                    No                       No
---------------------------- ------------------------ ----------------
Polish                       No                       No
---------------------------- ------------------------ ----------------
Russian                      No                       No
---------------------------- ------------------------ ----------------
Spanish                      Yes                      Yes
---------------------------- ------------------------ ----------------
Swedish                      No                       No
---------------------------- ------------------------ ----------------
Turkish                      No                       No
======================================================================

Note: If you run the product in a language environment <not>
listed in the table, you may experience problems.

______________________________________________________________________
11.0  Contact CA

Contact Technical Support

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

 *   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

Provide Feedback

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

If you would like to provide feedback about CA product
documentation, complete our short customer survey, which is
also available on the CA support website, found at http://ca.com/support. 



______________________________________________________________________
Copyright  2010 CA.
All rights reserved.
