<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:0130-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=1215672">bsc#1215672</a>
</li>
<li style="display: inline;">
<a href="https://bugzilla.suse.com/show_bug.cgi?id=1215673">bsc#1215673</a>
</li>
<li style="display: inline;">
<a href="https://bugzilla.suse.com/show_bug.cgi?id=1217373">bsc#1217373</a>
</li>
<li style="display: inline;">
<a href="https://bugzilla.suse.com/show_bug.cgi?id=1217374">bsc#1217374</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 four fixes can now be installed.</p>
<h2>Description:</h2>
<p>This update for google-cloud-sap-agent contains the following fixes:</p>
<ul>
<li>Update to version 2.8 (bsc#1217373, bsc#1217374)</li>
<li>Bump agent version to 2.8 to support C3/M3 certification</li>
<li>Update go.yml to use go 1.21</li>
<li>Switch from "slices" to "go_exp.../slices" for go version dependency</li>
<li>Use newly refactored discovery packages.</li>
<li>Fixes issue with diskname from source or device name</li>
<li>Adds extreme disk type IOps and Throughput for host metrics</li>
<li>Add <code>INTEGRATION</code> target config environment for collection definition testing</li>
<li>Add project number to SAP System proto</li>
<li>Add a cache to discovered resources. This reduces the number of API
calls needed to perform System Discovery</li>
<li>Replace windows wmic hardware queries with PowerShell wmi queries</li>
<li>Fix test flakiness</li>
<li>Improve development process for collection definition configuration</li>
<li>HANA PD based snapshot and restore - changes to add wait for uploading</li>
<li>Fix for kokoro build issue in processmetrics/networkstats</li>
<li>GCBDR SAPCoreAPP Package in Agent for SAP</li>
<li>Add version tracking for WLM validation config</li>
<li>Send workload validation config to remote instances for use during remote collection</li>
<li>Add flag for passing in workload validation config into remote collection OTE</li>
<li>
<p>Bump google.golang.org/grpc from 1.58.2 to 1.58.3</p>
</li>
<li>
<p>Update to version 2.7</p>
</li>
<li>Added ote for hma dashboards migration</li>
<li>Increase Max backoff in storage package to 300 seconds</li>
<li>Added subpaths for collection of required TCP metrics</li>
<li>Add more debug logs and increase the wait-time for PD operations in restore</li>
<li>No public description</li>
<li>Add 30 second timeout to read/write from the local file system for Backint</li>
<li>No public description</li>
<li>Adds RHEL 9 VM Manager policy</li>
<li>Extract cloud-related discovery functions into separate file</li>
<li>Adding timeout to systemReplication.py command execution</li>
<li>Allow download attempts without verifying connection to bucket</li>
<li>Invoke <code>collectiondefinition.Start</code> when starting the agent in daemon mode</li>
<li>SAP Agent CLI - usability improvements for flags and help menu</li>
<li>Add host project information to HANA DB component discovery data.</li>
<li>Use proto names for default configuration during Backint installation</li>
<li>Extending logging capabilities to all packages of the agent</li>
<li>Added a feature for exposing TCP connection metrics</li>
<li>Migrating context logging logic to all packages of SAP Agent</li>
<li>Add an ifthisthenthatlint to ensure new script is kept in sync with rule proto</li>
<li>(collectiondefition) - Discard unknown fields and remove breaking metrics</li>
<li>Moving commandlineexecutor from internal to shared for sqlserveragent</li>
<li>Define startup function for collectiondefinition package</li>
<li>Check error on close of destFile in backint restore</li>
<li>Allow trailing zeros for millisecond timestamps in Backint</li>
<li>Add pid to all agent logs</li>
<li>Bump SAP Agent version to 2.7 (placeholder release version)</li>
<li>Separate collection definition validation functionality into a separate file</li>
<li>Add datetime to migration folder for Backint installation</li>
<li>Add symlink for Backint log file to install directory</li>
<li>Set a deadline for the final flush to cloud logging</li>
<li>Increase chunk retry deadline in storage package</li>
<li>Fix order dependent tests in sapagent/internal/storage</li>
<li>Change support bundle feature to collect the OTE logs from new path</li>
<li>Usage logging for remote WLM validation metrics collection from the collector instance</li>
<li>Extract discovery functions performed on the host to a separate file</li>
<li>Improve agent shutdown experience in daemon mode</li>
<li>Fix Backint restoring incorrect file</li>
<li>Google Events - rule proto initial submission</li>
<li>Move gce package to shared folder for use by SQL Server agent</li>
<li>Add GCS integration into collectiondefinition package</li>
<li>Standardize import aliases</li>
<li>go mod updates</li>
<li>Fixing go/gotsan data race error in processmetrics_test</li>
<li>Add Backint support for Inquire line: <code>#EBID <external_backup_id></code></li>
<li>Chown Backint install directories to user/group of the opt/ folder</li>
<li>Create OTE logs under a subdir under /var/log as /var/log is only writable by root</li>
<li>Will not create an empty log file for logusage logs and one
time execution logs will have 0666 file mode</li>
<li>Setting the log file created to world read+write permission</li>
<li>Bump golang.org/x/net from 0.15.0 to 0.17.0</li>
<li>Add recovery_bucket parameter to Backint</li>
<li>Extract SAP related discovery functions to a separate file</li>
<li>Fix Backint install directory</li>
<li>Fix Backint parallel uploads</li>
<li>Move maintenance collector to beta API</li>
<li>Pruning batches to prevent time series duplication</li>
<li>Added a logger for incorporating service context keys in logs</li>
<li>Encode the DB password string to handle passwords with special characters</li>
<li>Handling non error scenarios better in netweaver.go</li>
<li>Internal change</li>
<li>fixes typo on backint install</li>
<li>Allow all users to execute google_cloud_sap_agent</li>
<li>Fix hdbbackint script.</li>
<li>Subdirs for Backint DIAGNOSE temporary files</li>
<li>Report zero-value metrics for upcoming maintenance</li>
<li>Clean up gcealpha functionality</li>
<li>Fix default configuration values in daemon and backint</li>
<li>Update the comment in proto to reflect that the metric
path in skip list should start with /sap</li>
<li>
<p>Implemented separation of context of different services</p>
</li>
<li>
<p>Update to version 2.6 (bsc#1215672, bsc#1215673)</p>
</li>
<li>Rolling back previous change for storing Project Number,
Project ID is sufficient, no need to add complexity</li>
<li>Determine location of HANA global.ini using SAP system discovery logic</li>
<li>Add numeric project ID prefix to object name for ReadMetrics</li>
<li>Discovery now looks up and stores project number with discovery data</li>
<li>ReadMetrics updates for IAM permissions and bucket object names</li>
<li>fixing the bug in backoff logic, using separate policies
for each collector and adding some logs</li>
<li>Backint migration from the old agent and supporting legacy parameters</li>
<li>adding new backoff policies for process metrics and fixing the
bug in process metrics sapservice collector</li>
<li>Bump SAP Agent version to 2.6</li>
<li>Fix an issue where HANA hosts may not be discovered
properly if hostname differs from instance name</li>
<li>Use Go 1.20 friendly sorting solution</li>
<li>adding retries in process metrics logic with backoffs</li>
<li>Fix parsing of instance (host/VM) name in Pacemaker pcmk_delay_max metric</li>
<li>Add the collection definition changes for the SAP HANA Topology metrics</li>
<li>Template for Cloud Monitoring Alerts for Backint errors</li>
<li>adding backoff to InstanceProperties to each collector</li>
<li>Reduced the number of parameters of startXX functions
by consolidating them into respective structs</li>
<li>completing TODO (b/298315981): Create a map from skipped
list metrics and pass it to collectors.</li>
<li>Proto package name changes to reflect the current path</li>
<li>Use instance_name instead of instance_id for baremetal systems</li>
<li>Decode encryption keys for Backint.</li>
<li>Moving HA replication metric to fast moving metrics</li>
<li>Added backoffs package in process metrics to keep the backoff policies
and retry policies separately and make it reusable acrosss process metrics</li>
<li>Install Backint OTE</li>
<li>Adding skip list logic to process metrics</li>
<li>Separating fastmoving metrics into a separate file from other process metrics</li>
<li>Update remote collection to use collected instance's Cloud Properties</li>
<li>ReadMetrics upload to bucket and send status to monitoring</li>
<li>Remove local implementation of DW API in favor of using generated third_party version</li>
<li>ReadMetrics read input file and write results to local filesystem</li>
<li>Clean up command line executions to collect SAP Control metrics</li>
<li>Adding new OTE structure for ReadMetrics</li>
<li>Add the SUSE specific spec file to keep upstream changes and SUSE packaging in sync</li>
<li>Collect and report upcoming maintenance</li>
<li>Add basepath override and gcealpha functionality</li>
<li>Making proto changes for process metrics re-arch</li>
<li>Changes for generating HANA Insights locally into a markdown file</li>
<li>Delay feature specific daily action logs by 24 hours
to avoid noise created by startup failures</li>
<li>Update to the rule "maximum_invalid_connect_attempts"</li>
<li>Add some missing related resources</li>
<li>Fix rate limiting for compression enabled uploads/downloads</li>
<li>Optional User-Agent parameter added to storage package client connection</li>
<li>Relocate gcealpha to /internal</li>
<li>Fix parse_test error</li>
<li>Retries added for opening files in Backint</li>
<li>Make processmetrics unit tests hermetic</li>
<li>Remove if-this-then-that requirement from WLM validation rule</li>
<li>Fix WriteInsight JSON encoding, and add missing elements</li>
<li>Add configuration value to change API endpoint for Data Warehouse calls</li>
<li>Storage package progress messages based off of read/writes directly to the bucket</li>
<li>Make Collect DB Metrics as NO-OP when metrics are being read from override file</li>
<li>Remove unused field from backint proto</li>
<li>Custom retries for the storage package with exponential backoff and MaxRetries setting</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-130=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-2.8-6.19.2</li>
</ul>
</li>
</ul>
<h2>References:</h2>
<ul>
<li>
<a href="https://bugzilla.suse.com/show_bug.cgi?id=1215672">https://bugzilla.suse.com/show_bug.cgi?id=1215672</a>
</li>
<li>
<a href="https://bugzilla.suse.com/show_bug.cgi?id=1215673">https://bugzilla.suse.com/show_bug.cgi?id=1215673</a>
</li>
<li>
<a href="https://bugzilla.suse.com/show_bug.cgi?id=1217373">https://bugzilla.suse.com/show_bug.cgi?id=1217373</a>
</li>
<li>
<a href="https://bugzilla.suse.com/show_bug.cgi?id=1217374">https://bugzilla.suse.com/show_bug.cgi?id=1217374</a>
</li>
</ul>
</div>