Terrain Office

v3.2.11
Release Notes and Quick Start Guide

Last Update: 14 October 2024

Copyright © Caterpillar 2024
All rights reserved.

Property of Caterpillar and may not be reproduced, transferred, sold, or otherwise disposed of, without the written
permissionpermission

Cat® Terrain Office 3.2.11 Page: 1

Release Notes 14 October 2024
Contents
Change History ..................................................................................................... 4
Related Artifact ..................................................................................................... 5
Introduction ............................................................................................................ 5
Passive FTP Ports .................................................................................................. 6
Notice of Future Obsolete Features ....................................................................... 7
Oracle Database ................................................................................................... 7
System Updates...................................................................................................... 7
OpenJDK .............................................................................................................. 7
Fleet Integrated....................................................................................................... 8
Terrain Office/Drilling Version Upgrade ................................................................ 8
New and Improved Features .................................................................................. 9
SQL Windows Authentication ................................................................................ 9
Productivity File Filter .......................................................................................... 10
File Audit Event Report ....................................................................................... 11
Updated Drill Models ........................................................................................... 12
Drill Appfile Template .......................................................................................... 13
Drilling Bit Types ................................................................................................. 13
Drill Operator Access Level ................................................................................. 14
Data Share Updates............................................................................................ 15
Consumables Improvements ............................................................................... 16
New User Role.................................................................................................... 17
Monitor Site (GIS) Improvement .......................................................................... 17
Fixed Issues........................................................................................................ 18
Database Schema Changes ................................................................................. 23
New Tables ..................................................................................................... 23
Modified Tables ............................................................................................... 26
Installation ............................................................................................................ 27
Preparation ......................................................................................................... 27
Upgrade Warning ................................................................................................ 27
Custom Windows Services (Local) Settings ......................................................... 28
Data Execution Prevention (DEP) Settings .......................................................... 29
DNS Entities ....................................................................................................... 30
Ports ................................................................................................................... 30
Firewall Settings.................................................................................................. 31
Permissions ........................................................................................................ 32
Power Management Settings .............................................................................. 32
Upgrading the Software ....................................................................................... 33
Upgrading from release 1.3 or earlier .................................................................. 33
Upgrading from release 2.0 or later ..................................................................... 33
Cat® Terrain Office 3.2.11 Page: 2
Release Notes 14 October 2024
 Backing up Data.................................................................................................. 34
Uninstalling the Current Version .......................................................................... 34
Potential Automatic Reboot During Installation .................................................... 35
Installing the New Version ................................................................................... 36
Validating the Installation .................................................................................... 42
Rolling Back the Installation ................................................................................ 42
CAT Tools Software ............................................................................................ 43
Securing Terrain Office Services ......................................................................... 44
Option 1 .............................................................................................................. 45
Option 2 .............................................................................................................. 46
CPI 538813 – Openfire CVE 2023-32315 ICA ..................................................... 47
Troubleshooting ................................................................................................... 49
Client/MCU ......................................................................................................... 49
CAT Reports/CAT Configurator ........................................................................... 50
OCMetsTool Settings .......................................................................................... 51
GeoServer Reset Process................................................................................... 52
Help File Link ...................................................................................................... 54
Known Issues ....................................................................................................... 55

Cat® Terrain Office 3.2.11 Page: 3

Release Notes 14 October 2024
Change History

Date Change Edited By Revision

15-Feb-2023 Draft creation/initial review Mills 1.0

20-Feb-2023 Updated Links in Introduction Section Mills 1.1

15-Mar-2023 Updated Troubleshooting/Known Issues Mills 1.2

05-May-2023 Added new section: System Updates Mills 1.3

25-May-2023 GeoServer Logs Price 1.4

21-Jun-2023 Updated Known Issues Mills 1.5

11-Jul-2023 Updated for content covering v3.2 Maint 1 (3.2.8) Mills 1.6

27-Sep-23 Updated Troubleshooting/GeoServer Logs sections Mills 1.7

1-Dec-23 Updated for content covering v3.2 Maint 2 (3.2.9) Mills 1.8

9-Jan-24 Terrain Office/Drilling Version Upgrade Mills 1.9

8-May-24 Updated for content covering v3.2 Maint 3 (3.2.11) Mills 2.0

14-Oct-24 Updated Introduction Mills 2.1

Cat® Terrain Office 3.2.11 Page: 4

Release Notes 14 October 2024
 Information in this document is subject to change without notice. While every effort has
been made to ensure that the information contained within this document and the
features and changes described are accurate, Caterpillar cannot accept any type of liability for
errors in, or omissions arising from the use of this information.

This document and all related documentation are the property of Caterpillar and may not be
reproduced, transferred, sold, or otherwise disposed of, without the written permission of the
owners.

Related Artifact

Name: CatMineStarSetup-3.2.11.99103_x64

Size on 1.75GB
Disk:

Checksum F0E32140635139CFBB63E15E4BCBC75A761B7910CFF1C34FBD9AF8FEC4894F45
(SHA-256)

Introduction
Welcome to the release notes for Cat® Terrain Office release v3.2.x, which delivers
functionality and other improvements beyond those delivered in previous releases.

The release notes should be read in conjunction with the following:

• REHS7327 Installation and Administration of Cat® Terrain Office

• RENR9562 Cat® Terrain Office Software Systems Operation
• Terrain Office Online Help
• Secure Deployment Guide (Office Software tab)
• Terrain Office Compatibility Matrix (Product Support Materials tab)

Cat® Terrain Office 3.2.11 Page: 5

Release Notes 14 October 2024
Passive FTP Ports
This release there has been implementation in the site.settings.properties files a default
Passive FTP port range of 61000-61100. This is to ensure upon a graceful shutdown of a
machine, any files needing to be transferred will be done through Passive FTP.

If a sites network team wants to change the value of these ports, follow the below procedure:

1. Go to catmstarFiles>systems>main>config
2. Open site.settings.properties file
3. Search/Find ftp.passive.port.range = 61000-61100
4. Change numbers to desired port range
5. Save file and close
6. Restart services

Note: Ensure there is only a single space before/after =.

Cat® Terrain Office 3.2.11 Page: 6

Release Notes 14 October 2024
Notice of Future Obsolete Features
The following features will be obsolete in future releases. In some cases, it may impact other
products or capability sets. We will notify customers before removing these features; however,
you should review the list below and plan for anything that relates to you.

Oracle Database
Support for Oracle database will cease with version v3.3 of Terrain Office.

If you are an existing customer using Oracle, contact MineStar Implementation Specialist for
further assistance.

Note: SQL Server 2019 is the preferred platform

System Updates
This section outlines new and/or improved system update changes for Terrain Office.

OpenJDK
Java SE has been replaced with OpenJDK in order to comply with Oracle's new Java licensing
model, which requires commercial users to purchase a license for updates and support.
OpenJDK is a free and open-source alternative that provides a similar feature set to Java SE
and can be used without incurring licensing fees.

Cat® Terrain Office 3.2.11 Page: 7

Release Notes 14 October 2024
Fleet Integrated
When integrated, ensure the Machine ID(s) in Terrain Office matches the Machine ID(s)
configured in Fleet Office. This will ensure data in CAT Reports and CAT Editor are
synced properly.

Terrain Office/Drilling Version Upgrade

When upgrading Terrain Office, it is necessary to ensure the correct version of Office is being
utilized in the Hardware Setup screen for all drills. An incorrect version of Office selected or is
being used, errors will occur during productivity file processing and/or file transfers.

When upgrading Terrain for Drilling, ensure the Hardware Setup screen has the correct
version of Office selected during this process. As the above paragraph states, same errors will
result.

For example: Hardware Setup screen shows for Office, under Installed section, that
Terrain_v2.4 is selected but Terrain Server has v3.2 installed, this is a mismatch and will
cause errors. Select the correct version that Terrain Server has installed.

Please reference Compatibility Matrix document.

Cat® Terrain Office 3.2.11 Page: 8

Release Notes 14 October 2024
New and Improved Features
This section outlines the new and improved features in release 3.2.X

SQL Windows Authentication

Terrain Office now supports SQL authentication through a Windows account allowing services
such as Active Directory to adhere to security standards and password policies.

Note: Windows credentials will also need to be configured at the services-level.

See REHS7327 Installation and Administration of Cat® Terrain Office for more information

See Manage Site Settings > Productivity File Settings

Cat® Terrain Office 3.2.11 Page: 9

Release Notes 14 October 2024
Productivity File Filter
There is now a filter for productivity files, that is defaulted to 180 days or 6 months. Any
productivity file that is processed prior to 180 days from current date or in the future, will not be
reflected in SQL database. Any productivity file that contains records that are older than the
days defined or newer than the current date, will be logged in the reportingDB.log and rejected.

You are able to adjust the days or turn this filter off by going to
catmstarfiles\systems\main\config and open cat2db.settings file.

Cat2db.enable.productivity.filter if set to false will disable this filter.

Cat2db.productivity.filterByDays will adjust how many days/months productivity files will

process into database. This value can be edited from 1 to 1095 days (3 years).

Note: Date is calculated based on the Terrain Office servers current time.

Note: To reprocess productivity files that are outside the filter range, either disable the filter by
changing to false or adjust the filterByDays value as needed. Adjusting Either one of these
settings will require a services restart.

Refer to REHS7327 for more details.

Cat® Terrain Office 3.2.11 Page: 10

Release Notes 14 October 2024
File Audit Event Report
Administrators can now export a csv report of historical user actions, such as:

Office File Actions Office-To-Machine Actions

Conversion of files Activation of Files
Deletion of Files Change file group
Folders (Create, Delete, Rename) Deactivation of files
Movement (Copy, Cut, Paste) Onboard lists sent
Renaming of files Removal of files
Upload of Files Reboot requests

Example Report

Cat® Terrain Office 3.2.11 Page: 11

Release Notes 14 October 2024
Updated Drill Models
Terrain Office now supports an updated list of Drill Model types & dimensions including:

Caterpillar Drill Models Other Drill Models

MD5150 Articulated Sandvik DR410i LBH
MD6200 Sandvik DR412i LBH
MD6250 Sandvik DP1500i Articulated
MD6310
MD6380
MD6640 LBH

Cat® Terrain Office 3.2.11 Page: 12

Release Notes 14 October 2024
Drill Appfile Template
Drills now have an appfile template through Windows file explorer at
catmstarfiles\systems\main\cat_minestar_file_repository\design\sample_files. This template file
can be found in Office webpage under Office Files by selecting
sample_files>GPS_App_Files>Drill.

Note: Sending appfiles from Office is not supported for drills. Refer to KENR8684 for details
applying the appfile.

Drilling Bit Types

Terrain Office now supports an additional AQM column called Bit Type and Supported Bit
Types to be sent to the Terrain for Drilling onboard system

See Manage Site Settings > Terrain (Drilling and Draglines) > AQM Columns

Cat® Terrain Office 3.2.11 Page: 13

Release Notes 14 October 2024
Drill Operator Access Level
When "Drill" is selected a new section will appear below. These access levels are for
Autonomous Drilling Systems (ADS) Operators only. There is no affect for Terrain for Drilling
(TfD) when choosing either option, but it is best to use the default "Standard Operator".

Depending on the level chosen allows different access features to be unlocked for the operator
Onboard. In the image below are the differences for each access level. Again, this is for
Autonomous Drilling Systems (ADS) only.

Cat® Terrain Office 3.2.11 Page: 14

Release Notes 14 October 2024
Data Share Updates
Added support for a Machine Bucket Position query which will provide bucket details
triggered by every bucket load such as:

• Machine Name
• Timestamp
• Bucket Position (Easting, Northing, Elevation, and Heading)
• Material Name

Example Payload Response

See Data Share Implementation Manual for more information

Cat® Terrain Office 3.2.11 Page: 15

Release Notes 14 October 2024
Consumables Improvements
Consumables Import
Terrain Office now allows you to mass import serial and model numbers in Onboard
Lists>Consumables utilizing a .csv file, instead of entering them in one by one.

Note: Must have Consumable Suppliers, Consumable Types, and Consumable Models set up
first

Refer to RENR9562 - Systems Operation manual for further details.

Unique Consumable
When a serially tracked consumable is selected by Onboard, that consumable will be unavailable
for other drill machines.

Cat® Terrain Office 3.2.11 Page: 16

Release Notes 14 October 2024
New User Role
Site Monitor
A new role has been added in Manage Users. This role allows the ability to update designs in
Monitor Site (GIS) without needing an Administrator role.

Monitor Site (GIS) Improvement

Drag and Drop Design Layers
In Monitor Site (GIS) added the ability to reorder design layers by dragging and dropping them
without needing to remove and re-add the layers.

Cat® Terrain Office 3.2.11 Page: 17

Release Notes 14 October 2024
Fixed Issues
CPI Description Resolution
Number

495066 In a small number of setups integrated Improved scheduled clean up task to

with Command, the Minestar log can grow cover wider range of log files
excessively resulting in large disk
consumption

501796 While generating Mission Audit Report for Adjusted code to increase character
mission cancelled due to User Defined length
Machine Stability Limit Exceeded, it
reports incorrect Fail Code and Fail
Category

503284 Drill Pattern Control & Shift Selection Adjusted source code to allow the ability
Does Not Work in 'Select Mode' to select multiple holes while in ‘Select
Mode’

503530 Misconfiguring an SSL certificate can If invalid certificate or keystore password

result in services not starting up correctly is applied, a warning message will be
displayed

506108 Drill hole hover-over information pop-up Added an “X” button to the hover popup to
blocks the selection of holes allow the user to close it

506611 When using Windows Server 2019 and Moved Terrain Office files from
“Storage Sense” enabled, can cause C:\Windows\Temp folder
Terrain Office webpage to not respond or
display 404 error

506932 When Manage & Transfer files tab is Adjusted code to prevent the Refresh icon
closed and reopened again, Refresh from being in a constant reload state
button is in constant state of reloading

507676 Once new project is created the Remove, Improved the UI refresh rate to decrease
Edit, and Send to Machine buttons take 3 amount of time until the buttons become
or more minutes to become functional functional

508851 When reconverting a PTS file, Terrain When reconverting the same PTS file,
Office will overwrite the CAT file but not Terrain Office will now overwrite both files
the DXF file

508967 Users with Read/Write access cannot Restored permissions for Read/Write
remove holes from Drill Machine users to remove holes from Drills

509364
Unable to edit start times in grid view for Can now edit start times in grid view
CAT Editor

Cat® Terrain Office 3.2.11 Page: 18

Release Notes 14 October 2024
 509941 Onboard Files appears blank despite the Improved the file transfer process to
onboard machine having files prevent “null” entries for

511827 Terrain Office allowed a Consumable ID Added a warning message stating

number larger than 32767, which is not minimum/maximum values that also
supported by Terrain for Drilling prevents the user from entering outside
stated values

512341 In certain scenarios, sending a text Sessions now close properly when
message from Office would result in machines are rebooted from within Office
duplicated text messages being received
by the onboard operator

512823 Processing large amounts of Drill Improved the reliability of processing

Productivity files, SQL server can become Productivity file(s)
´locked up´. Occurs prominently with ADS
or OMA-related production files

512883 In CAT Editor>Drill Hole Editor the upload Adjusted icons to represent “down arrow”
and download icons can be confusing as download report as a .csv, and “up
arrow” as upload a .csv file.

514249 Draw profile tool does not display Fixed a UI issue so now the station values
elevation or station value after drawing a show when cursor is on profile line
profile line

513989 Within 3D View of an elevation design file Adjusted code to give correct conversion
and a related “On Grade Progress” layer value
loaded, “To Design” value incorrect
conversion

514720 Autonomous Artifacts are not visible in Autonomous Artifacts are now visible
Terrain Office Monitor Site when a GeoTiff when a GeoTiff file is loaded as the
is loaded as the background background

516512 In Draw Profile Tool inaccurate Station Adjusted code to reflect correct Station
value, and adjusting “Profile View” window values and adjusting “Profile View”
width causes numbers on right side to window.
exaggerate their values when using
Mining Survey Feet

516534 Operator (Extended role) logins, relating Extended Operator roles will no longer
to ADS drills, expires 6 months after expire unless the role is archived
creation

518460 ADS Extended Operator roles may not Upon upgrade/installation Extended
sync correctly upon Terrain Office Operator(s) information is no longer
upgrade/installation missing

Cat® Terrain Office 3.2.11 Page: 19

Release Notes 14 October 2024
 518468 Integrated with Fleet, Manage MWF Files Adjusted code to not enable “Manage
box in Terrain Office becomes enabled Files in Terrain” after a change is made in
when a change is made to Productivity Manage Site Settings when integrated
Polling Interval with Fleet

518940 In certain scenarios, when creating/editing Adjusted code to prevent error message
a new User, an error message will appear, and “Apply” button staying in a loading
and/or the "Apply" button will continually state when creating/editing a user
appear in a loading state

519197 When multiple design holes selected, Can now edit those values when editing a
Terrain Office does not allow Northing, hole and/or multiple holes
Easting, Angle, Azimuth, or Instructions to
be set edited

519239 Various Control Center tabs/Help link do Program files are no longer stored in
not respond, or the webpage displays a C:\Windows\Temp folder
404 error

519305 Unable to rotate elevation in 3D mode Adjusted source code to allow the ability
using mouse to rotate in 3D mode using mouse

519932 Flickering occurs when scrolling up and Fixed UI issue while scrolling up and
down in Machine List down does not flicker

520300 GeoTiff files with unknown SRS do not Adjusted code to give a default SRS
load

520505 In Manage Projects archiving a Project Adjusted code to refresh the window
does not refresh the visualization window

521503 Adjusting default admin username can Default admin username can no longer be
result in the webpage not loading edited

521664 When generating a Datashare Adjusted code to report Material ID and

MachineBucketPosition query, Material ID Material Name
and Material Name is null

521714 Bad timestamps received from onboard A filter has been added when processing
can lead to injection of erroneous data productivity files.
into the reporting database.
Please reference REHS7327 for further
details.

522589 Aquila hole clean-up job not running Adjusted code to improve aquila hole
correctly cleanup

Cat® Terrain Office 3.2.11 Page: 20

Release Notes 14 October 2024
 524293 When initializing a new coordinate Adjusted code to reflect correct
system, importing a GPS.dc file may conversion when initializing a new
result in improper conversion coordinate system

526550 After upgrade, AQM column 12 is Adjusted code to have column 12 default
defaulted to be blank causing server side to “ignored”
exception errors

527132 In Machine View the mined-out progress Adjusted code so mined-out progress
changes depending on the zoom level reflects the same at any zoom level

527780 In Manage Projects, duplicate project Terrain Office now prevents duplicate
names were allowed names of Projects from being created,
even if original project was archived

527789 In Manage Bound Templates, copying an Adjusted code to prevent “Apply” button
established template allows “Apply” button being active until “Layer” is filled
to be active while “Layer” field is blank

528143 Unable to use “Remove Holes by Pattern” Adjusted code to allow removal of holes
in Machine View when pattern is by pattern when generated by Onboard
generated by Onboard

529031 Generating Auto Drill Report in Cat Adjusted code to report the correct
Reports contain N/A values in values.
Auto/Manual Drilling Columns
There are two scenarios where N/A will show in
Auto/Manual Drilling columns:
1. If the actual depth of the hole is zero to less
than 1 meter

2. If there is a start time mismatch between

hole profile and state tables

529505 When integrated with Fleet, Terrain Office Adjusted code so FTP checkbox stays
FTP becomes unchecked after closing marked
window

534799 When creating an Autonomous Inclusion Adjusted coded to not allow overlapping
Zone can overlap another already of Autonomous Inclusion Zones
established Autonomous Inclusion Zone

535183 Left-Clicking on machine’s icon did not Adjusted code for pop-up window to
display the machine’s status information render when left clicking on machine icon

537468 Machine View or Monitor Site tabs, Updated System Operation manual
draglines appear to be same size as drills, informing User(s) can adjust scalability
dozers etc.
Refer to RENR9562 for further details

Cat® Terrain Office 3.2.11 Page: 21

Release Notes 14 October 2024
 540161 Cat Editor State & Delay Segments start Users can now edit the “From” time for
times not editable for Grading & Loading the “State” and “Delay” segments for
machines as was available in previous Terrain for Grading & Loading (TfGL)
versions machines

Cat® Terrain Office 3.2.11 Page: 22

Release Notes 14 October 2024
Database Schema Changes
New Tables
Below are new tables and column values which are being introduced with this release

DR_C_ADS_CRITICAL_ZONE_OBJECTS

Column Name Type Nullable Primary Key Unit

CRITICAL_ZONE_ID integer N Y

CRITICAL_ZONE_NAME nvarchar Y N

VERSION numeric Y N

LAST_CHANGED datetime Y N

DR_C_ADS_DANGER_ZONE_OBJECTS

Column Name Type Nullable Primary Key Unit

DANGER_ZONE_ID integer N Y

DANGER_ZONE_NAME nvarchar Y N

VERSION numeric Y N

LAST_CHANGED datetime Y N

DR_C_ADS_DRILL_STATE

Column Name Type Nullable Primary Key Unit

STATE_ID integer N Y

STATE_NAME nvarchar Y N

VERSION numeric Y N

LAST_CHANGED datetime Y N

DR_C_ADS_EVENT

Column Name Type Nullable Primary Key Unit

EVENT_ID integer N Y

EVENT_NAME nvarchar Y N

VERSION numeric Y N

LAST_CHANGED datetime Y N

Cat® Terrain Office 3.2.11 Page: 23

Release Notes 14 October 2024
DR_C_EVENT_REASON

Column Name Type Nullable Primary Key Unit

REASON_ID integer N Y

REASON_NAME nvarchar Y N

VERSION numeric Y N

LAST_CHANGED datetime Y N

DR_C_ADS_STOPPAGE_FLAG

Column Name Type Nullable Primary Key Unit

STOPPAGE_FLAG_ID integer N Y

STOPPAGE_FLAG_NAME nvarchar Y N

VERSION numeric Y N

LAST_CHANGED datetime Y N

DR_C_BITTYPE

Column Name Type Nullable Primary Key Unit

bitTypeId integer N Y

NAME nvarchar Y N

VERSION integer Y N

LAST_CHANGED datetime Y N

Cat® Terrain Office 3.2.11 Page: 24

Release Notes 14 October 2024
DR_P_PERCEPTION_PERFORMANCE

Column Name Type Nullable Primary Key Unit

REPORT_ID integer N Y

MACHINE_ID integer Y N Reference to dr_c_machine

TIME_START datetime Y N

TIME_END datetime Y N

EVENT_ID integer Y N Reference to DR_C_ADS_EVENT

REASON_ID integer Y N Reference to

DR_C_ADS_EVENT_REASON
Reference to
DANGER_ZONE_ID integer Y N DR_C_ADS_DANGER_ZONE_OBJECTS

Reference to
CRITICAL_ZONE_ID integer Y N DR_C_ADS_CRITICAL_ZONE_OBJECTS

Y_NORTHING float Y N

X_EASTING float Y N

Z_ELEVATION float Y N

HEADING float Y N

PITCH float Y N

ROLL float Y N

MAST_ANGLE float Y N

STATE_ID integer Y N Reference to DR_C_ADS_DRILL_STATE

STOPPAGE_FLAG_ID integer Y N Reference to

DR_C_ADS_STOPPAGE_FLAG

VERSION numeric Y N

LAST_CHANGED datetime Y N

Cat® Terrain Office 3.2.11 Page: 25

Release Notes 14 October 2024
Modified Tables
Below are the columns which have been added or changed within existing tables

DR_P_HOLE_INFORMATION

Column Name Type Nullable Primary Key Unit

ACTUALBIT Integer Y N Reference DR_C_BITTYPE

DESIGNBIT Integer Y N Reference DR_C_BITTYPE

Cat® Terrain Office 3.2.11 Page: 26

Release Notes 14 October 2024
Installation
The following sections describe changes to and requirements for the installation process.

Preparation
The following procedures are required to be performed before upgrading to release 3.X

Upgrade Warning
If currently on 2.4 or prior, 3.X is a major upgrade that includes
schema changes,dependency upgrades, and data migrations.
Plan for this upgrade to take up to 6 hours to complete.
The backup procedures outlined in this document must be
carriedout to ensure a rollback can be performed in the event
of a failed or interrupted installation.

Cat® Terrain Office 3.2.11 Page: 27

Release Notes 14 October 2024
Custom Windows Services (Local) Settings
Please take note of custom settings that may have been applied to any Cat-related services
within the Windows Services (Local) menu outside of the default settings.

Performing an upgrade installation will not retain these settings.

Default Settings

Startup Type: Automatic

Log on as: Local System account

Example of Custom Settings:

Cat® Terrain Office 3.2.11 Page: 28

Release Notes 14 October 2024
Data Execution Prevention (DEP) Settings
Note: DEP settings have most likely been established by a global security policy. Please
consult with your local IT group before attempting any DEP changes.

Turn off the DEP settings by following the steps below.

1. Ensure you are logged in as an Administrator.

2. Open the Control Panel.
3. Click System and Security.
4. Click System.
5. Click Advanced system settings from the list on the left.
6. If you are asked to Approve the User Account Control query, then do so, otherwise,
continue with the next step.
7. In the Performance section, click the Settings button.
8. Click the Data Execution Prevention tab.
9. Select Turn on DEP for essential Windows programs and services only.
10. Click OK twice to close the dialogs.
11. Close the System window.

Note: Once you have completed the above steps, reboot the server or workstation.

Cat® Terrain Office 3.2.11 Page: 29

Release Notes 14 October 2024
DNS Entities
You should verify that DNS entities are propagated to all network segments. Otherwise, use IP
addresses in all cases rather than fully qualified names.

Ports
The server ports listed in the table below are required to be open to the Terrain Office Web
Client users.

Port Protocol Direction Purpose

8080 TCP Incoming Terrain Office Web Application

3003 TCP Incoming Asynchronous Messaging

7070 TCP Incoming GeoServer

9191 TCP Incoming Cat Editor Web Application

8787 TCP Incoming Text Messaging

Cat® Terrain Office 3.2.11 Page: 30

Release Notes 14 October 2024
Firewall Settings

1. Open the Control Panel.

2. Click System and Security.
3. Click Windows Firewall.
4. Click Advanced Settings.
5. Select Inbound Rules.
6. Click on New Rule.
7. In the New Inbound Rule Wizard, do the following.
a. Port, then click Next.
b. Select TCP and All local ports, then click Next.
c. Select Allow the connection, then click Next.
d. Select the appropriate profile (Domain, Private, Public), then click Next.
e. Specify a Name and click Finish.
f. Click New Rule and repeat steps a-d but in step b select UDP instead of TCP.

Note: Firewall settings have most likely been established by a global security policy. Please
consult with your local IT group before attempting any firewall changes.

Cat® Terrain Office 3.2.11 Page: 31

Release Notes 14 October 2024
 Permissions
1. Open File Explorer and browse to the installation drive for Terrain Office

2. Right-Click the catmstarFiles folder and select Properties

3. Click the Security tab

4. Ensure each user group is granted Full Control

5. Apply and OK

The Group “Users” is required, with Full Control permissions, for Postgres to install correctly.

Note: Full Control is Required for a successful upgrade installation.

If installing Terrain Office for the first time, ensure that the installing user has Full Control
on the installation drive itself.

Power Management Settings

1. Open Control Panel.
2. Click Hardware.
3. Click Power Options.
4. It is recommended that you select High Performance.

Note: Power Management settings have most likely been established by the system
administrator. Please consult with your local IT group before attempting any changes.

Cat® Terrain Office 3.2.11 Page: 32

Release Notes 14 October 2024
Upgrading the Software
Upgrading from release 1.3 or earlier
Before upgrading the office software from release 1.3 (or earlier) to release 3.X, you must
perform the following:

• Ensure the site elevation values are defined accurately for the mine site. The elevation
extents are defined in Manage Site Settings > Extents > Site Elevation Extents

• Consult with the mine site survey team regarding the correct site-specific coordinate
systems to configure in release 3.X, MiningSI, miningSurveyFeet, or MiningImprial.

o MiningSI coordinate system must be defined for all sites. (international system)

o MiningSurvey Feet coordinate system is only required for sites using US

measurements (survey foot).

o MiningImperial coordinate system is only required for sites using Imperial

measurements. (standard foot)

• Upgrade to the latest version of v2.4 before updating to v3.X

o Follow the Uninstall and Install procedure on Pages 17-23 to:

Upgrading from release 2.0 or later

Before upgrading the office software from release 1.3 or 2.0 to this release, you must perform
the following.

• Ensure the site elevation values are defined accurately for the mine site. The elevation
extents are defined in Manage Site Settings > Extents > Site Elevation Extents

Cat® Terrain Office 3.2.11 Page: 33

Release Notes 14 October 2024
Backing up Data
Note: The install wizard will prompt the user to perform a backup. This backup will capture the
data necessary to perform a rollback if any issue is detected during the upgrade procedure. It
is highly recommended that you perform the steps below in addition to the install wizard
backup.

Before upgrading, ensure that the following backup procedures are performed.

1. Backup the configuration files (*.ini) for selected Cat Tools Software, including Cat
Reports, Cat Editor, Cat Configurator, and Cat 2DB. These files are found in the following
locations.
• Cat Reports - …\Program Files (x86)\catmstar32\CatReports\Cat Reports.ini
• Cat Editor - … \Program Files (x86)\catmstar32\CatEditor\Cat DB Editor.ini
• Cat Configurator - …\Program Files (x86)\catmstar32\CatConfigurator\Cat
Configurator.ini

Note: A consolidated level 1 snapshot will backup the files mentioned above and can be
executed in place of copying individual files. The level 1 snapshot will be placed in the
\\catmstarfiles\systems\main\tmp directory as a zip file.

2. Backup customized timelines (timelines.ini). This file is found in the following location.
• Timelines - …\Program Files (x86)\catmstar32\CatEditor\Timelines.ini

3. Take a full server backup using VM Clone or NAS software. (recommended)

4. Perform a consolidated level 1 snapshot from \\catmstar\snapshot

Uninstalling the Current Version

Note: Communicate the outage to all concerned parties before uninstalling the software. It is
recommended that current design files be sent to each machine so that they may continue
production while the office server is down. Mobile equipment will continue to build productivity
and store progress which will be forwarded to the office server once communication has been
re-established.

Uninstall all components of Terrain Office by clicking Start > All Programs > Cat® MineStar
System™ and Tools > Change Cat® MineStar System™ and Tools Installation. Follow the
prompts to complete uninstallation. Alternatively you can uninstall via the Add or Remove
Programs > Cat MineStar System and Tools > Uninstall

Note: If the \\CATMSTAR directory remains following the server restart, delete it.

DO NOT remove the \\CATMSTARFILES directory as this is the primary data directory.

Cat® Terrain Office 3.2.11 Page: 34

Release Notes 14 October 2024
Potential Automatic Reboot During Installation

During the initial phases of the installation, in some cases, the server may automatically
reboot, without warning.

This is due to the inclusion of ‘bundled’ Microsoft Visual C++ 2015-2019 Redistributable.

Before this ‘bundled’ version, each year, 2015 – 2019 were individually installed.

If the server is running any 3rd party software which is actively using an indivually installed
VC++ version it will be automatically uninstalled and reinstalled under the ‘bundled’ version.

Depending on the software which is actively using the VC++ software, an automatic reboot
may occur.

If this occurs, allow the reboot to complete and re-run the Terrain Office installer.

Cat® Terrain Office 3.2.11 Page: 35

Release Notes 14 October 2024
Installing the New Version
Terrain Office installers can be located and downloaded from the following URL:

https://catdealer.com/en/products/digital-products-technology/minestar-solutions/minestar-
solutions-surface/terrain/terrain-release-downloads-documentation.html

Locate and right-click the Terrain Office Installer and select Run as administrator.

Follow the prompts below:

Cat® Terrain Office 3.2.11 Page: 36

Release Notes 14 October 2024
Cat® Terrain Office 3.2.11 Page: 37
Release Notes 14 October 2024
Cat® Terrain Office 3.2.11 Page: 38
Release Notes 14 October 2024
Cat® Terrain Office 3.2.11 Page: 39
Release Notes 14 October 2024
Cat® Terrain Office 3.2.11 Page: 40
Release Notes 14 October 2024
Cat® Terrain Office 3.2.11 Page: 41
Release Notes 14 October 2024
Validating the Installation

Log into Terrain Office with a known username and password. The URL for Terrain Office is:

http://[servername or IP]:8080/minestar/home/#/

NOTE: If the original system admin account password was never changed, you will be
forced to enter a strong password.

Restore the files you backed up in steps 1 and 2 of “Backing up the Data” to their original
locations. Where files with identical names were installed with the new version of Terrain
Office, replace them with the original (backed up) files.

It is highly recommended that a server restart is undertaken following successful installation

and start-up of Terrain Office. This should be performed as a matter of course.

The upgrade is complete. Refer to RENR9562 Cat® Terrain Office Software Systems
Operation for information on using Terrain Office.

Rolling Back the Installation

If services fail to start or the user interface is not accessible it may be necessary to roll back. It
is highly recommended that the Cat MineStar Product Support Team be notified and engaged
to assist with rolling back. Perform the steps below to roll back the installation.

Note: Ensure that you have the install package for the previous version that was installed
before starting the rollback process.

1. Uninstall the current version using the “Change Cat MineStar System and Tools”
utility.

2. Restart the server.

3. If the \\Catmstar folder still exists after restarting the server, delete it. Do not delete
the \\catmstarfiles folder.

4. Copy the contents of the \\catmstarfilesBackup folder to the \\catmstarfiles folder,

overwrite files if prompted.

5. Install the previous version of software to the existing \\catmstarfiles directory.

Cat® Terrain Office 3.2.11 Page: 42

Release Notes 14 October 2024
CAT Tools Software

Once provided as a separate standalone installer for client workstations, the CAT Tools
software is now updated exclusively through the main Terrain Office installer and will no longer
be available as a standalone setup.

CAT Tools consisted of:

CAT 2DB
CAT Editor
CAT Configurator
CAT Reports

To install these standalone programs on a workstation, launch the main Terrain Office installer
on the client workstaitons as an Administrator

Select Client to install all of the previously mentioned CAT Tools applications

or

Select Custom to choose an individual application

For information on backing up data from these applications see Backing up Data

Cat® Terrain Office 3.2.11 Page: 43

Release Notes 14 October 2024
Securing Terrain Office Services
Configure the following Terrain Office services to run (log on) using the Local system or
dedicated user account. Contact your site IT dept. before attempting to add or modify user
accounts.

• CAT Artemis Service

• CAT Comms Server Service

• CAT Editor Service

• CAT GeoServer Service

• CAT Messaging Service

• CAT MineStar Service

• CAT Productivity File Service

• CAT Postgres Service

• CAT XMPP Service

• MCU Server

See next page(s) for configuration options.

Cat® Terrain Office 3.2.11 Page: 44

Release Notes 14 October 2024
In some instances, you may not want to execute (Log on) the services in the Local System
account but would like to use a generic Windows account for running the services. In such
cases, please follow the steps below, either Option 1 or Option 2.

Option 1
Add the generic Windows login as an administrator of the machine and restart the services.

Note: WSRV indicates the step is relevant to Windows Server, WPRO indicates the procedures
are relevant to Windows 7/10 Professional, otherwise it applies to both.

1. WSRV - Open Control Panel, System and Security, User Accounts, Manage User

Accounts. WPRO - Open Computer Management.

2. WPRO - Expand Local Users and Groups. Click Users.

3. Add User.

4. Enter the relevant details and click Close.

5. Right-click on the new user and click Properties.

6. Click the Member Of tab.

7. Click Add.

8. Click Advanced.

9. Click New.

10. Click Find Now.

11. In the list that displays, click Administrators.

12. Click Apply, then click OK.

13. Click Start > Control Panel.

14. Click on System and Security.

15. Click on Administrative Tools

16. Double-click on Services and choose one of the above-listed services from the list.

17. Right-click the Service and click Properties.

18. Click the Log On tab, select This Account, and browse to the account created in step 5.

19. Provide the relevant Passwords.

20. Click Apply, and then click OK to exit the dialog. Close all other open Windows dialogs.

21. Restart the service.

22. Repeat steps 17-22 for other services.

Cat® Terrain Office 3.2.11 Page: 45

Release Notes 14 October 2024
Option 2
Note: Do not choose this option for CAT Productivity File Service or MCU Server.

Note: WSRV indicates the step is relevant to Windows Server, WPRO indicates the
procedures are relevant to Windows 7/10 Professional, otherwise it applies to both.

Add write and modify permissions for the generic user to the catmstar and catmstarFiles
folders and restart the services. Do this by following the steps below.

1. WSRV - Open Control Panel, System and Security, User Accounts, Manage User

Accounts. WPRO - Open Computer Management.

2. WPRO - Expand Local Users and Groups. Click Users.

3. Add User.

4. Enter the relevant details and click Close.

5. Open Windows Explorer, navigate to and right-click the catmstar folder.

6. Click Properties.

7. Click the Security tab > Edit.

8. Add User. (advanced > find now)

9. Enable Modify and Write permissions for User.

10. Click OK.

11. Repeat steps 7-12 for the catmstarFiles folder.

12. Close Windows Explorer.

13. WSRV - Click Start > Control Panel, V7 - Open Computer Management.

14. WSRV - Double-click Administrative Tools, WPRO - Expand Services and Applications.

15. Double-click Services and choose one of the above-listed services from the list.

16. Right-click the Service and click Properties.

17. Click the Log On tab, select This Account, and browse to the account created in step 6.

18. Provide the relevant Passwords.

19. Click Apply, and then click OK to exit the dialog. Close all open Windows dialogs.

20. Restart the Service.

21. Repeat steps 16 to 21 for other services.

Cat® Terrain Office 3.2.11 Page: 46

Release Notes 14 October 2024
CPI 538813 – Openfire CVE 2023-32315 ICA
1. Stop all Terrain Office Cat related services

2. In the “catmstar” folder, find “web.xml” file in

“catmstar\openfire\plugins\admin\webapp\WEB-INF”. After creating a buckup
of this file, edit the original file.

The content of this file is in the form of “xml”. Find a “<filter>” element that
contains the “<filter-name>AuthCheck</filter-name>” child element. The
“<filter>” element will appear as shown below:

3. The value inside the “<param-value>” element is a comma-separated list of

values. From the list, remove all asterisk “*” characters.

In the example shown above, there is only one “*” character. Once this “*” is
removed, the code will look like below:

4. Save the file.

5. To bind the webserver of the Openfire admin console to a specific network

interface, the “openfire.xml” configuration file can be used.

6. In the “catmstar” folder, find “openfire.xml” file in “catmstar\openfire\conf”. After

creating a backup of the file, edit the original file.

Cat® Terrain Office 3.2.11 Page: 47

Release Notes 14 October 2024
 7. Find the “<adminConsole>” element that is a direct child element of the root
“<jive>” element. Add new element named “<interface>” as a child element of
“<adminConsole>”. The value of the “<interface>” element should be the name
of the loopback interface or interface address. Setting the value to “127.0.0.1”
works on all tested environments.

The resting fragment of the “openfire.xml” file will appear as shown below:

8. Save the file.

9. Start all Cat related services.

10. To test if an instance of the server is affected, follow the steps below.

a. Open the browser in incognito mode. If not opened in the incognito

mode, ensure that there is no authenticated session with the server
admin console.

b. Open the below address:

On Terrain Server:

http://localhost:9090/setup/setup-s/%u002e%
u002e/%u002e%u002e/log.jsp

On Client:

http://<localhost or IP address>:9090/setup/ setup-

s/%u002e%u002e/%u002e%u002e/log. Jsp

If redirected to the login page, the instance is unaffected.

Cat® Terrain Office 3.2.11 Page: 48

Release Notes 14 October 2024
Troubleshooting
Client/MCU
After applying SSL/TLS settings, it is necessary to update Cat Office Services.

To do this open Cat Office Services

1. Click Add
2. Type new URL: https://[IP Address or Hostname]:8443/minestar
3. OK
4. Highlight the new URL
5. Set Default
6. Restart MCU Service

Cat® Terrain Office 3.2.11 Page: 49

Release Notes 14 October 2024
CAT Reports/CAT Configurator
Highly recommended to create a schedule in Cat configurator as certain reports rely on a
schedule to be configured before they will display correct, please see CAT Configurator Help
file for more information.

NOTE: DO NOT retroactively create a schedule. Start from present day forward.

Cat® Terrain Office 3.2.11 Page: 50

Release Notes 14 October 2024
OCMetsTool Settings
OCMets.exe is a process installed within the Terrain Office environment. This executable is
invoked whenever design files are converted, snippets are processed, or file export events are
launched. Due to high read/write activity, follow the steps below to establish OCMetsTool
compatibility.

In Windows Explorer, navigate to the following folder, \\catmstar\jetty\bin

Right-click OCMetsTool.exe and click Properties.

Click the Compatibility tab.

Click the Change settings for all users button.

Select the Run this program in compatibility mode for check box.

Select Windows 8 in the dropdown menu.

Select the Run this program as an administrator checkbox.

Note: If you are experiencing issues visualizing *.CAT files, try changing the compatibility
mode to Windows 8 or Windows XP SP3.

Click OK and Restart the Cat MineStar Services

Cat® Terrain Office 3.2.11 Page: 51

Release Notes 14 October 2024
GeoServer Reset Process
Taking a Backup
To prevent data loss, ensure that appropriate backups are in place before proceeding with this
process.

• Complete Level 1 snapshot

• Make a copy of the GeoServer data directory:
catmstarFiles\systems\main\data\geoserver\data_dir
• Alternatively, perform a full VM snapshot of the Terrain Office server as a backup.

Clearing C:\Windows\Temp
• Stop services except Postgres service
• Ctrl+A to highlight everything and delete
• There will be some items that cannot be deleted, it is fine to skip these

GeoServer Reset Tool

Using the built-in tool will automatically stop services, clean the necessary files, and restart
services.

• Browse to catmstar\utility-tools\
• Install the GeoserverResetTool

• Note the [Install Path] during the installation

• Browse to the selected [Install Path]\bin folder and double-click geoserverreset.bat

• Allow the command prompt window to automatically close and the Cat-related services
to startup
• If the above fails to run, please see next page for further instructions

Cat® Terrain Office 3.2.11 Page: 52

Release Notes 14 October 2024
If the above fails to run, in-place permissions may be preventing the script execution. If so, try
the below steps:

• Open Command Prompt – Run as Administrator

• Launch the geoserverreset.bat file found in the [Install Path]\bin folder
• Monitor the services for Cat Minestar and Geoserver services to start

Example:

Start Services:
• Start CatGeoServerService and CatMineStarService
• Restart productivity service

Cat® Terrain Office 3.2.11 Page: 53

Release Notes 14 October 2024
Help File Link
To access the Help file, you need to be logged in to Terrain Office. On the main page in the
upper right corner is the link to open the file.

Cat® Terrain Office 3.2.11 Page: 54

Release Notes 14 October 2024
Known Issues
Please visit https://catdealer.com/minestarsupport for a current list of known issues.

Cat® Terrain Office 3.2.11 Page: 55

Release Notes 14 October 2024