REL-248 Patch Release Notes

for Address Manager v9.3.1

CONFIDENTIAL - For customer's internal use only.

This document may not be reproduced or distributed without the written consent of BlueCat.

© 2021 BlueCat Networks (USA) Inc. and its affiliates.

 Contents

Contents

REL-248 Patch Release Notes....................................................................3

Reasons for release............................................................................................................................ 3
Description of issue.............................................................................................................................3
Affected software versions.................................................................................................................. 3
Effects on service................................................................................................................................3
Rollback support..................................................................................................................................3
Location of patch.................................................................................................................................3
Applying the patch to Address Manager.............................................................................................4
Rolling back the patch........................................................................................................................ 4
Release Support Policy....................................................................................................................... 5

Terms and Conditions.................................................................................6

ii | CONFIDENTIAL
 REL-248 Patch Release Notes

REL-248 Patch Release Notes

Patch for REL-248 on Address Manager v9.3.1.

Reasons for release

Announcement Date: October 27, 2021
This patch addresses a product defect in Address Manager. Applying this patch resolves the defect listed
in Description of issue on page 3.

Description of issue

Address Manager performance and optimization

This Address Manager patch introduces improvements in the area of DNS/DHCP server patch application,
and is recommended to be applied before applying BIND patch REL-248 to DNS/DHCP Servers.
Application of the REL-248 patch to DNS/DHCP Servers without installing the patch to Address Manager
first may result in significant delays during installation.
Note: For more information, refer to article KI-024965 on BlueCat Customer Care.

Affected software versions

This issue affects the following versions of Address Manager software:
• Address Manager v9.3.1

Effects on service
Applying this patch will restart Address Manager service, resulting in a service interruption.
Attention: BlueCat advises customers to apply this patch during a controlled or planned
outage. Customers should schedule a maintenance window during non-peak times in order to
minimize the effects of this interruption.

Rollback support
This patch supports rollback. For details, refer to Rolling back the patch on page 4.

Location of patch
Customers can obtain this patch from article 17905 on BlueCat Customer Care (login required).

CONFIDENTIAL | 3
REL-248 Patch Release Notes for Address Manager v9.3.1

• bam_9.3.1-001_REL-248_x86_64.zip—installation file. This zip file contains the following artifacts:

• bam_9.3.1-001_REL-248_x86_64.tar.gz—tarball file.
• bam_9.3.1-001_REL-248_x86_64.key—associated public key file.
• bam_9.3.1-001_REL-248_x86_64.run.zip—runzip file. This zip file contains the following artifact:
• bam_9.3.1-001_REL-248_x86_64.run—run file.
Attention: This patch can be applied on Address Manager v9.3.1 only. Install this patch before
installing the REL-248 patch to DNS/DHCP servers for optimal performance. Installing REL-248
to DNS/DHCP servers without patching the Address Manager server first may result in significant
delays during installation.

Applying the patch to Address Manager

Download the patch from BlueCat Customer Care and apply it via the Address Manager user interface.
Attention: Before installing a new patch, first ensure that Address Manager servers and DNS/
DHCP servers are running the same version. Once this is confirmed, apply the patch to Address
Manager servers, followed by DNS/DHCP servers. Address Manager server patches must be
applied before DNS/DHCP server patches.
Attention: When configuring new replication between Address Manager servers, servers must
be running the same software version and patch. Customers currently running Address Manager
in replication should apply the patch to the Primary server only. When the patch is applied to the
Primary server, all replicated servers are patched automatically. In the event that a standby server
becomes inaccessible during patch application, the patch may have to be applied directly from the
CLI once it is accessible. Please contact BlueCat Customer Care if any issues arise during patch
application to servers in replication.
1. Download the installation file from BlueCat Customer Care and extract the tarball file and its
associated public key file.
2. Log in to the Address Manager user interface as an administrator.
3. Select the Administration tab.
4. Under General, click Version Management.
5. Click Software Update.
a) Upload an Address Manager update: Click Choose File and select the tarball file.
b) BCN Public Key Security File: Click Choose File and select the associated public key file.
6. Click Submit. The Update Confirmation page opens.
7. Under Confirm Application of Update, verify that you are applying the tarball file to the Address
Manager server.
8. Click Yes.
After the patch application process, the Address Manager service will restart.

Rolling back the patch

Revert the changes to packages introduced by this patch.
Note: If you deleted the compressed installation file after applying this patch, start from step 1. If
the files are still on your system, proceed to step 3.
1. Download the installation file from BlueCat Customer Care and extract the runzip file.
2. Copy the runzip file to the /tmp directory of your . If using a UNIX/Linux system, this can be performed
with scp <runzip file> root@<addressmanagerserverIP>:/tmp.

4 | CONFIDENTIAL
 REL-248 Patch Release Notes

3. Log in using SSH and the root account.

Note: If you are STIG compliant, you must log in as bluecat and use the su - command to
gain access to the root shell.
4. Change to the /tmp directory, then type the following commands:

unzip <runzip file>

chmod +x <run file>
./<run file> rollback

5. At the prompt, type yes and press ENTER to confirm rollback.

During the patch rollback process, the Address Manager service will restart.

Release Support Policy

BlueCat is continuously developing enhancements and new functionality for its software solutions. As a
result, BlueCat regularly releases major and minor updates that incorporate all of the latest changes to its
products. As long as the customer's BlueCat products are under an active Maintenance Services contract
with BlueCat Customer Care, the customer will be entitled to receive and download these releases.

Testing and applying recommended software updates

It is the responsibility of the customer to apply software patches as necessary in order to maintain
the stability and security of their IP environments. BlueCat strongly recommends a stand-alone lab
environment for testing in order to minimize the risk to a production operation. Within the test environment,
you can check resolutions, updates and upgrades to isolate a specific problem, confirm a fix, or test an
update.
Note: For more information on release support policy and change management, contact BlueCat
Customer Care at https://care.bluecatnetworks.com.

CONFIDENTIAL | 5
REL-248 Patch Release Notes for Address Manager v9.3.1

Terms and Conditions

READ THIS BEFORE INSTALLING OR USING BLUECAT PRODUCTS, SERVICES, AND
DOCUMENTATION
The material herein is subject to the applicable BlueCat License Agreement previously entered into
between BlueCat and your company, or if none, then to BlueCat’s standard terms and conditions which
you can view and download from https://bluecatnetworks.com/license-agreements/. BlueCat reserves the
right to revise this material at any time without notice.
Company names and/or data used in screens and sample output are fictitious, unless otherwise stated.

Copyright
©2001—2021 BlueCat Networks (USA) Inc. and its affiliates (collectively ‘BlueCat’). All rights reserved.
This document contains BlueCat confidential and proprietary information and is intended only for the
person(s) to whom it is transmitted. Any reproduction of this document, in whole or in part, without the prior
written consent of BlueCat is prohibited.

Trademarks
Proteus, Adonis, BlueCat DNS/DHCP Server, BlueCat Address Manager, BlueCat DNS Edge, BlueCat
Device Registration Portal, BlueCat DNS Integrity, BlueCat Gateway, BlueCat Mobile Security, BlueCat
Address Manager for Windows Server, and BlueCat Threat Protection are trademarks of BlueCat.
iDRAC is a registered trademark of Dell Inc. Windows is a registered trademark of Microsoft Corporation.
UNIX is a registered trademark of The Open Group. Linux is a registered trademark of Linus Torvalds.
QRadar is a registered trademark of IBM. ArcSight is a registered trademark of Hewlett Packard. Ubuntu is
a registered trademark of Canonical Ltd. CentOS is a trademark of the CentOS Project. All other product
and company names are registered trademarks or trademarks of their respective holders.

6 | CONFIDENTIAL
BlueCat Networks (USA) Inc. and its affiliates.
www.bluecatnetworks.com
Toll Free: 1.866.895.6931
Document #: 3337
Published in Canada
Date: October 2021