<div class="container">
<h1>Recommended update for google-cloud-sap-agent</h1>
<table class="table table-striped table-bordered">
<tbody>
<tr>
<th>Announcement ID:</th>
<td>SUSE-RU-2024:2015-1</td>
</tr>
<tr>
<th>Rating:</th>
<td>moderate</td>
</tr>
<tr>
<th>References:</th>
<td>
<ul>
<li style="display: inline;">
<a href="https://bugzilla.suse.com/show_bug.cgi?id=1225166">bsc#1225166</a>
</li>
<li style="display: inline;">
<a href="https://bugzilla.suse.com/show_bug.cgi?id=1225558">bsc#1225558</a>
</li>
</ul>
</td>
</tr>
<tr>
<th>Affected Products:</th>
<td>
<ul class="list-group">
<li class="list-group-item">Public Cloud Module 12</li>
<li class="list-group-item">SUSE Linux Enterprise High Performance Computing 12 SP2</li>
<li class="list-group-item">SUSE Linux Enterprise High Performance Computing 12 SP3</li>
<li class="list-group-item">SUSE Linux Enterprise High Performance Computing 12 SP4</li>
<li class="list-group-item">SUSE Linux Enterprise High Performance Computing 12 SP5</li>
<li class="list-group-item">SUSE Linux Enterprise Server 12</li>
<li class="list-group-item">SUSE Linux Enterprise Server 12 SP1</li>
<li class="list-group-item">SUSE Linux Enterprise Server 12 SP2</li>
<li class="list-group-item">SUSE Linux Enterprise Server 12 SP3</li>
<li class="list-group-item">SUSE Linux Enterprise Server 12 SP4</li>
<li class="list-group-item">SUSE Linux Enterprise Server 12 SP5</li>
<li class="list-group-item">SUSE Linux Enterprise Server for SAP Applications 12</li>
<li class="list-group-item">SUSE Linux Enterprise Server for SAP Applications 12 SP1</li>
<li class="list-group-item">SUSE Linux Enterprise Server for SAP Applications 12 SP2</li>
<li class="list-group-item">SUSE Linux Enterprise Server for SAP Applications 12 SP3</li>
<li class="list-group-item">SUSE Linux Enterprise Server for SAP Applications 12 SP4</li>
<li class="list-group-item">SUSE Linux Enterprise Server for SAP Applications 12 SP5</li>
</ul>
</td>
</tr>
</tbody>
</table>
<p>An update that has two fixes can now be installed.</p>
<h2>Description:</h2>
<p>This update for google-cloud-sap-agent fixes the following issues:</p>
<ul>
<li>Update to version 3.3 (bsc#1225166, bsc#1225558)</li>
<li>Build updated to use -mod=vendor during build</li>
<li>Updated go.mod and go.sum with dependencies for safetext,
using go mod vendor for github action</li>
<li>Add actual values and comments to usagemetrics.go to ensure that
error and action codes are only appended to the end of the list.</li>
<li>Remove usage metrics from configureinstance.go</li>
<li>Add a hard Disable for reliability metrics collection
until the namespace is created and tested.</li>
<li>Adding metrics for time taken by each query</li>
<li>Add SHA224 of labels as a new label.</li>
<li>Remove collect_reliability_metrics from configuration.json</li>
<li>Small tweaks to backint log and inquire path generation</li>
<li>Fix for unmarshalling backint configuration.</li>
<li>Implementation of instant snapshot group backup workflow</li>
<li>Backint changes around shorten_folder_path</li>
<li>Rename max_diagnose_size_gb to diagnose_file_max_size_gb</li>
<li>Adding start and finish logs in performance diagnostics</li>
<li>Validate that all disks mapped to /hana/data belong to the same consistency group.</li>
<li>Rename backint monitoring metrics parameter</li>
<li>Trim folder prefix for Backint INQUIRE output.</li>
<li>Add the ability to test the database connection</li>
<li>Reduce log level of some storage messages to debug.</li>
<li>Finalize guest action request and response format.</li>
<li>Backint dashboard fix logs</li>
<li>Add scorecards to backint dashboard</li>
<li>Making proto changes for HANA Monitoring support
for multiple tennats and ha setup</li>
<li>Add total upload/download time to log.</li>
<li>Add HANA indexserver.ini metrics to WLM metric collection.</li>
<li>Add Netweaver role metrics as part of process metrics</li>
<li>Rotate old support bundles.</li>
<li>Update the default value of confirm-data-snapshot-after-create
to false. and add to usage()</li>
<li>Add option to confirm HANA snapshot as successful before disk snapshot is uploaded.</li>
<li>Change log level from warn to info for non-critical messages.</li>
<li>Add diagnose_folder parameter to Backint</li>
<li>Add a 1 GB buffer to needed bytes for diagnostic</li>
<li>Add labels to group snapshot backup.</li>
<li>Enable the show status and restart agent functions for Windows.</li>
<li>Add WLM metric collection for num_completion_queues and num_submit_queues.</li>
<li>Collect support bundle on Backint errors.</li>
<li>Adding usage metrics to performance diagnostics</li>
<li>Collect agent-only support bundle on failure of backint and hanadiskbackup.</li>
<li>Minor Backint improvements</li>
<li>Add ability collect only agent logs using agent-logs-only flag to supportbundle</li>
<li>Bump version to 3.3</li>
<li>Add Backint metrics dashboard</li>
<li>DO NOT remove log files on uninstall</li>
<li>Adding more unit tests</li>
<li>Changing location of zipped file to within the
final folder identified by unique timestamp.</li>
<li>Minor refactorings and improvements with increasing code coverage</li>
<li>Make sure DB instance number is recorded in System data.</li>
<li>Change configuration.json to 0664 to ensure world cannot write.</li>
<li>Add Netweaver Java discovery to SAP Agent.</li>
<li>Add a new version of functions to read cloud properties from metadata server.</li>
<li>Updating generated protos to proc-gen-go v1.34.1</li>
<li>Updating runConfigureInstance method and adding unit tests
for covering configure instance ote invocation</li>
<li>Zip the final bundle and add upload functionality</li>
<li>Record database SID alongside tenant DB SIDs</li>
<li>Reduce log severity in discovery</li>
<li>Add HANA version to product version data</li>
<li>Fix race condition in tests</li>
<li>Read disk mapping from instance info if source disk
is not provided to hanadiskbackup</li>
<li>Add option to shorten the folder path in the bucket.</li>
<li>Add SSL support for cmdline-based querying and some bugfixes</li>
<li>Move recovery package to shared directory.</li>
<li>Update protoc-gen-go version to v1.34.0 in multiple protos</li>
<li>Adding FIO commands to performance diagnostics</li>
<li>Remove error logs when errors are being returned</li>
<li>Adding perfdiag to performance diagnostics</li>
<li>Add AppInstance data to discovery data uploads.</li>
<li>Introduce protos for guestactions messages and responses.
Support multiple commands per message.</li>
<li>Update wording for HANA Insights rules.</li>
<li>Configureinstance updates.</li>
<li>Adding a check for retention policy before performing backup operation.</li>
<li>Remove the unused loglevel flag from logusage OTE</li>
<li>Change the language around the default parameters being
optimized for performance in backint</li>
<li>Add instance role to SAP System properties</li>
<li>Increase wait time for index server to stop.</li>
<li>Integrating backint OTE into performancediagnostics</li>
<li>Update wording around configureinstance unsupported machine type.</li>
<li>Pass the right disk name to check if disk is attached</li>
<li>Integrating new DB Handle and hdbuserstore key support
with remaining HANA DB dependant workflows</li>
<li>Refactor HANA and filesystems specific code to a common hanabackup package</li>
<li>Bumps x/net dependency to v0.23</li>
<li>Append HANA Insights rule to WLM fake metrics file in script to generate WLM rule.</li>
<li>Integrating configure instance ote in performance diagnostics</li>
<li>Update disk backup OTE to parse paths even with /dev/mapper
in the middle of path, not necessarily as a prefix</li>
<li>Adding a few missing labels to wlm-fake-metrics.yaml</li>
<li>Changing loglevel for onetime.Init() calls</li>
<li>Refactor change - Move PD related functions to gce.go</li>
<li>Fix agentcommunication import replace statements</li>
<li>Update replace functions for new open source dependencies.</li>
<li>Set up scaffolding for guest actions handling in SAP Agent along with UAP library code</li>
<li>Backint upload/download metrics sent to cloud monitoring.</li>
<li>Cleaning up the performance diagntics file wth recent changes</li>
<li>Fixes to usage strings in OTEs for optional params</li>
<li>Integrating new database connector with HANA Monitoring
and adding support for HDBUserstore Key</li>
<li>Implement hdbsql commandline result parsing</li>
<li>SAP Discovery - Add SAP Instance Numbers to instance properties</li>
<li>Updating OTEs to include params for when OTE is invoked internally</li>
<li>Modifying flags to follow design changes</li>
<li>Create fake WLM metric overrides for testing</li>
<li>Implement constructors and query functions for querying
HANA DB via hdbuserstore using cmdline</li>
<li>Skeleton for querying HANA DB via hdbuserstore using cmdline</li>
<li>Parameterize Backint Diagnose max file size.</li>
<li>Metadata parameter added to Backint.</li>
<li>Adding initial layout for performance diagnostics OTE</li>
<li>Create a new API CreateClient() in shared logging which
returns an error in case of failures</li>
<li>Backint no longer writes ERROR if temporary chunk failed to delete.</li>
<li>Create onetime.Init() to condense reused code.</li>
<li>Fixing a typo in a process metrics retry logic comment</li>
<li>Rename workload_validation param with workload_evaluation in configure OTE</li>
<li>Send agent version in Write Insight requests</li>
<li>Ensuring /sap/cluster/resources covers all the nodes</li>
</ul>
<h2>Patch Instructions:</h2>
<p>
To install this SUSE update use the SUSE recommended
installation methods like YaST online_update or "zypper patch".<br/>
Alternatively you can run the command listed for your product:
</p>
<ul class="list-group">
<li class="list-group-item">
Public Cloud Module 12
<br/>
<code>zypper in -t patch SUSE-SLE-Module-Public-Cloud-12-2024-2015=1</code>
</li>
</ul>
<h2>Package List:</h2>
<ul>
<li>
Public Cloud Module 12 (aarch64 ppc64le s390x x86_64)
<ul>
<li>google-cloud-sap-agent-3.3-6.31.1</li>
</ul>
</li>
</ul>
<h2>References:</h2>
<ul>
<li>
<a href="https://bugzilla.suse.com/show_bug.cgi?id=1225166">https://bugzilla.suse.com/show_bug.cgi?id=1225166</a>
</li>
<li>
<a href="https://bugzilla.suse.com/show_bug.cgi?id=1225558">https://bugzilla.suse.com/show_bug.cgi?id=1225558</a>
</li>
</ul>
</div>