Cluster Server ACC Library
Installation Guide
AIX, Linux, Solaris
8.0.2
Last updated: 2023-06-28
Legal Notice
Copyright © 2023 Veritas Technologies LLC. All rights reserved.
Veritas and the Veritas Logo are trademarks or registered trademarks of Veritas Technologies
LLC or its affiliates in the U.S. and other countries. Other names may be trademarks of their
respective owners.
This product may contain third-party software for which Veritas is required to provide attribution
to the third-party (“Third-Party Programs”). Some of the Third-Party Programs are available
under open source or free software licenses. The License Agreement accompanying the
Software does not alter any rights or obligations you may have under those open source or
free software licenses. Refer to the third-party legal notices document accompanying this
Veritas product or available at:
https://www.veritas.com/about/legal/license-agreements
The product described in this document is distributed under licenses restricting its use, copying,
distribution, and decompilation/reverse engineering. No part of this document may be
reproduced in any form by any means without prior written authorization of Veritas Technologies
LLC and its licensors, if any.
THE DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED
CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED
WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH
DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. VERITAS TECHNOLOGIES LLC
SHALL NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN
CONNECTION WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS
DOCUMENTATION. THE INFORMATION CONTAINED IN THIS DOCUMENTATION IS
SUBJECT TO CHANGE WITHOUT NOTICE.
The Licensed Software and Documentation are deemed to be commercial computer software
as defined in FAR 12.212 and subject to restricted rights as defined in FAR Section 52.227-19
"Commercial Computer Software - Restricted Rights" and DFARS 227.7202, et seq.
"Commercial Computer Software and Commercial Computer Software Documentation," as
applicable, and any successor regulations, whether delivered by Veritas as on premises or
hosted services. Any use, modification, reproduction release, performance, display or disclosure
of the Licensed Software and Documentation by the U.S. Government shall be solely in
accordance with the terms of this Agreement.
Veritas Technologies LLC
2625 Augustine Drive
Santa Clara, CA 95054
http://www.veritas.com
Technical Support
Technical Support maintains support centers globally. All support services will be delivered
in accordance with your support agreement and the then-current enterprise technical support
policies. For information about our support offerings and how to contact Technical Support,
visit our website:
https://www.veritas.com/support
You can manage your Veritas account information at the following URL:
https://my.veritas.com
If you have questions regarding an existing support agreement, please email the support
agreement administration team for your region as follows:
Worldwide (except Japan) CustomerCare@veritas.com
Japan CustomerCare_Japan@veritas.com
Documentation
Make sure that you have the current version of the documentation. Each document displays
the date of the last update on page 2. The latest documentation is available on the Veritas
website:
https://sort.veritas.com/documents
Documentation feedback
Your feedback is important to us. Suggest improvements or report errors or omissions to the
documentation. Include the document title, document version, chapter title, and section title
of the text on which you are reporting. Send feedback to:
infoscaledocs@veritas.com
You can also see documentation information or ask a question on the Veritas community site:
http://www.veritas.com/community/
Veritas Services and Operations Readiness Tools (SORT)
Veritas Services and Operations Readiness Tools (SORT) is a website that provides information
and tools to automate and simplify certain time-consuming administrative tasks. Depending
on the product, SORT helps you prepare for installations and upgrades, identify risks in your
datacenters, and improve operational efficiency. To see what services and tools SORT provides
for your product, see the data sheet:
https://sort.veritas.com/data/support/SORT_Data_Sheet.pdf
Installing and removing the
ACC library
This document includes the following topics:
■ About the ACC library
■ Supported software
■ Installing the ACC library
■ Removing the ACC library
About the ACC library
The operations of a Cluster Server agent depend on a set of Perl modules known
as the ACC library. The library must be installed on each system in the cluster that
runs the agent. The ACC library contains common, reusable functions that perform
tasks, such as process identification, logging, and system calls.
Instructions to install or remove the ACC library on a single system in the cluster
are given in the following sections. The instructions assume that the ACCLib tar
file has already been extracted.
Note: The LogDbg attribute should be used to enable debug logs for the
ACCLib-based agents when the ACCLib version is 6.2.0.0 or later and VCS version
is 6.2 or later.
Installing and removing the ACC library 5
Supported software
Supported software
For information on the software versions that ACC Library supports, see the Veritas
Services and Operations Readiness Tools (SORT) site:
https://sort.veritas.com/agents.
Installing the ACC library
Install the ACC library on each system in the cluster that runs an agent that depends
on the ACC library.
To install the ACC library
1 Log in as a superuser.
2 Download ACC Library.
You can download either the complete Agent Pack tar file or the individual
ACCLib tar file from the Veritas Services and Operations Readiness Tools
(SORT) site (https://sort.veritas.com/agents).
3 If you downloaded the complete Agent Pack tar file, navigate to the directory
containing the package for the platform running in your environment.
AIX cd1/aix/vcs/application/acc_library/version_library/pkgs
Linux cd1/linux/generic/vcs/application/acc_library/version_library/rpms
Solaris cd1/solaris/dist_arch/vcs/application/acc_library/version_library/pkgs
Installing and removing the ACC library 6
Installing the ACC library
4 If you downloaded the individual ACCLib tar file, navigate to the pkgs directory
(for AIX and Solaris), or rpms directory (for Linux).
5 Install the package. Enter Yes, if asked to confirm overwriting of files in the
existing package.
AIX # installp -ac -d VRTSacclib.bff VRTSacclib
Linux # rpm -i \
VRTSacclib-VersionNumber-GA_GENERIC.noarch.rpm
Solaris # pkgadd -d VRTSacclib.pkg
See “Installing the ACC library IPS package on Oracle Solaris 11 systems”
on page 6.
Note: The LogDbg attribute should be used to enable debug logs for the
ACCLib-based agents when the ACCLib version is 6.2.0.0 or later and VCS
version is 6.2 or later.
Installing the ACC library IPS package on Oracle Solaris 11 systems
Install the ACC library IPS package on an Oracle Solaris 11 system.
To install the ACC library IPS package on Oracle Solaris 11 systems
1 Copy the VRTSacclib.p5p package from the pkgs directory to the system in
the /tmp/install directory.
2 Disable the publishers that are not reachable as package install may fail, if
any, of the already added repositories are unreachable.
# pkg set-publisher --disable <publisher name>
3 Add a file-based repository in the system.
# pkg set-publisher -g /tmp/install/VRTSacclib.p5p Veritas
4 Install the package.
# pkg install --accept VRTSacclib
5 Remove the publisher from the system.
# pkg unset-publisher Veritas
6 Enable the publishers that were disabled earlier.
# pkg set-publisher --enable <publisher name>
Installing and removing the ACC library 7
Installing the ACC library
Upgrading the agent for TibcoEMS
Perform the following steps to upgrade the agent with minimal disruption.
To upgrade the agent for TibcoEMS
1 Verify the version of the agent for TibcoEMS.
# rpm -qi VRTSvcstib | grep Version
The output resembles:
Version : 8.0.0.0
2 Save the configuration.
# haconf -dump -makero
3 Identify the TibcoEMS resource and service group.
# hatype -resources TibcoEMS
The output resembles:
tib_res
# hares -display tib_res | grep Group
The output resembles:
tib_res Group global tib_grp
4 Freeze the TibcoEMS service group.
# hagrp -freeze tib_grp
5 Check if the TibcoEMS agent is running.
# haagent -display TibcoEMS | grep Running
The output resembles:
TibcoEMS Running Yes
6 If the agent is running, stop the agent.
# haagent -stop TibcoEMS -force -sys hostname
7 Verify the status of the agent.
# haagent -display TibcoEMS | grep Running
The output resembles:
TibcoEMS Running No
8 Upgrade the agent.
Linux # rpm -Uvh VRTSvcstib-agentVersion-GENERIC.noarch.rpm
Installing and removing the ACC library 8
Removing the ACC library
9 Start the agent.
# haagent -start TibcoEMS -sys hostname
The output resembles:
VCS NOTICE V-16-1-10001 Please look for messages in the log file
10 Verify the status of the agent.
# haagent -display TibcoEMS | grep Running
The output resembles:
TibcoEMS Running Yes
11 Unfreeze the TibcoEMS service group.
# hagrp -unfreeze tib_grp
Removing the ACC library
Perform the following steps to remove the ACC library.
To remove the ACC library
1 Ensure that all agents that use ACC library are removed.
2 Run the following command to remove the ACC library package:
AIX # installp -u VRTSacclib
Linux # rpm -e VRTSacclib
Solaris # pkgrm VRTSacclib
Note: To uninstall the ACCLib IPS package on a Solaris 11 system,
run the following command:
# pkg uninstall VRTSacclib
