Skip to main content

Admin Corner

Find out all the admin-relevant content

  • 14 Topics
  • 0 Replies
14 Topics
T
Employee
TomMinEmployee
published in Admin Corner
Which information is useful when creating a ticket for TrendMiner support?

When creating a ticket for the TrendMiner support team it is useful to include detailed information about the issue. This will ensure that the issue can be investigated and fixed in shortest amount of time possible.Creating a detailed ticket will prevent a lot of back and forth communication and will increase the chance of a quick resolution.Steps on the creation of a detailed support ticket:Write a clear and concise title that describes the issue with a few words.Useful information to include in the ticket description:A detailed and clear explanation of the issue. Screenshots or videos provide additional clarity. Upload the appliance logs. This can be requested from your administrator if you do not have the required permissions: https://documentation.trendminer.com/en/how-to-extract-appliance-logs-.html If there are multiple TrendMiner installations within your organization. please specify which installation you are experiencing the issue on. Which version of TrendMiner are you using?

220
T
Employee
12 days ago
Stijn Agten
Employee
Stijn AgtenEmployee
published in Admin Corner
Virus scanners

To ensure security, TrendMiner allows the installation and running of virus scanners next to the TrendMiner application, only on single node deployments and with certain conditions. While antivirus software is an important security measure, it is crucial to note that TrendMiner's performance is closely tied to I/O performance as the application builds a time series index using many small local files, grouped into time-based structures. Virus scanners, particularly those that scan all disk I/O, may still cause performance degradation or failures in some cases.  Important Considerations:Performance Impact: Antivirus processes that scan disk I/O can introduce delays, potentially affecting TrendMiner’s responsiveness. In extreme cases, it may cause system failures, such as:User experience degradation due to slower I/O performance and CPU/Memory spikes caused by the antivirus software. Delays in monitoring events, due to slower indexing, related to slower I/O performance  TrendMiner upgrade

220
Stijn Agten
Employee
27 days ago
Stijn Agten
Employee
Stijn AgtenEmployee
published in Admin Corner
Ever wondering what these md5 and sha1 files are?

If you ever downloaded TrendMiner from our file server you might have noticed there are a lot of files on there. The .tar.gz files are the actual TrendMiner installation/upgrade packages. The .zip file is the connector installation/upgrade package. But do you know what these .md5 and .sha1 files are? md5 and sha1 are 2 different cryptographic hash functions. A cryptographic hash function is a mathematical algorithm that takes an input of any size and produces a fixed-size, unique output (hash) that appears random. It is designed to be secure, meaning even a small change in the input drastically changes the output, and it is computationally infeasible to reverse or find two different inputs with the same hash.TrendMiner provides the hashes of the installation packages for you as a customer to verify that the file you downloaded is identical to the one which is hosted on our server and the file was not corrupted during download.How do you do that?Download and open the .md5 from our file

280
Stijn Agten
Employee
2 months ago
T
Employee
TomMinEmployee
published in Admin Corner
How to use the PlantIntegrations API to check which tag data is fetched from a historian?

If you notice that a certain tag in TrendMiner is displaying data that might be incorrect, you can use the PlantIntegrations API to check which tag data is being retrieved from the historian.If the data in the historian corresponds with the data in TrendMiner, the faulty data is already present in the historian and should be rectified there.To access the PlantIntegrations API you can do the following:Open the IIS server on which PlantIntegrations is installed. Open the IIS manager and click on the PlantIntegrations website. On the right side of the screen you can now choose the ‘browse’ option which will lead you to the API.  This will lead you to the following API page: To perform an index call here you need the following information:Tag name Historian name Tag type Interpolation type Start- and enddate of the period you want to request Number of intervalsYou can find an example of an index call below in which the parts in green need to be configured depending on the call you want to

340
T
Employee
3 months ago
J
Employee
Jordi JorissenEmployee
published in Admin Corner
Invalid authenticator code

In our 2024.R1.0 release we introduced an additional layer of security, meaning an OTP code is mandatory to use the Admin account. (for ConfigHub and TrendHub login)You can read more about this in the article from Jef Vanlaer here.While trying to authenticate with the Admin account, I ran into following error message:  Invalid authenticator codeI found out that the root cause of this error is due to my TrendMiner server time not being in sync, thus the server thinks that the code I am providing is long expired/not valid yet.  After resolving the NTP issue my Admin login is working without issue again.

450
J
Employee
3 months ago
Stijn Agten
Employee
Stijn AgtenEmployee
published in Admin Corner
Support scripts and custom scripts

As you might already know TrendMiner provides some support scripts to make some tasks easier. Today we have 5 official support scripts: batch indexing: indexes the tags in a given list indexing performance testing: benchmarks the indexing performance provided by a historian at specific index resolutions listing tags in a historian: lists all tags available to TrendMiner for a specific historian listing indexed tags: lists all tags currently indexed in TrendMiner cleaning indexes: clears the index of those tags that match the provided criteria All details can be found in this documentation article: https://documentation.trendminer.com/en/support-scripts.html But next to these scripts you can also leverage the TrendMiner APIs to write your own script in your favourite language. For example: clean all indexes of a list of tags provided via a .csv file.Did you write your own scripts already? Which scripts would you like to see productised in TrendMiner? Let us know!

360
Stijn Agten
Employee
3 months ago
J
Employee
Jordi JorissenEmployee
published in Admin Corner
My tag does not load anymore after changing the (interpolation) type in the data source

TrendMiner does not support changing the (interpolation) type of a tag in the data source. This implies that for example when you change a tag from linear to stepped interpolation in your historian the tag will not load anymore in TrendHub and an error will be shown. You will also notice that the tag index can no longer be updated and goes to a STALE state.TrendMiner support can typically derive this from the logfiles, but if you already know this is the root cause of the problem then there are a few steps you can perform to resolve the issue.Refresh the tag cache manually in ConfigHub for the data source the tag is synced from (or wait up to 24h for the changes to be synced automatically) Restart the tm-compute service in ConfigHub or Edge Manager. Keep in mind that restarting tm-compute will entail downtime for the users (typically a few minutes). Re-index the tag. Edit and save all calculated tags which depend on the changed tag (it is not required to make any changes to the cal

290
J
Employee
4 months ago
Jef Vanlaer
Community Manager
Jef VanlaerCommunity Manager
published in Admin Corner
[Recording] TrendMiner 2024.R2.0 admin webinar

On June 20th, we hosted an admin webinar to prepare our admins for the upcoming 2024.R2.0 TrendMiner release. With this release, we are moving to a new Operating System (OS) given the end-of-support for Red Hat Enterprise Linux 7 (RHEL 7) and the derived CentOS 7.Two actions will be needed to upgrade your TrendMiner setup to version 2024.R2.0 once it is publicly released:The creation of a new TrendMiner server based on the new OS A migration of the application data to the new serverThis webinar details the prerequisites and steps to be taken to complete these actions.Additionally, it explains the migration options, including the new and highly recommended full system backup/restore functionality with secure storage on your own AWS S3 or Azure Blob Storage, which includes index migration. A detailed demo of this process is provided.Finally some important considerations and recommendations for planning the migration are outlined.Check out the recording below and refer to the "OS Migratio

290
Jef Vanlaer
Community Manager
4 months ago
Stijn Agten
Employee
Stijn AgtenEmployee
published in Admin Corner
How much disk space does TrendMiner need?

In Edge Manager → Diagnostics the available disk space and the total disk space of TrendMiner can be checked. The disk space shown there shows the space on the /mnt/data volume (the volume on which the TrendMiner appliance is installed and on which TrendMiner stores its data).Next to the /mnt/data volume there is also the root volume, on which the OS and system services are running. Both the root volume and the /mnt/data volume can run out of disk space which in both cases will result in service interruption.The root volume total disk space and usage is not shown in Edge Manager since TrendMiner does not actively use this volume. Disk space issues should not occur on this volume if the system requirements are met.The /mnt/data volume is used by the TrendMiner application for storing data. This data mainly consists of: Info stored in the database, e.g. saved work from users. Index data Logically, the more usage of TrendMiner and the more tags are being indexed, the more disk space wil

170
Stijn Agten
Employee
4 months ago
Stijn Agten
Employee
Stijn AgtenEmployee
published in Admin Corner
High appliance memory usage?

Sometimes we get contacted by admins who are concerned about the memory usage of their TrendMiner installation. In Edge Manager -> Diagnostics you can check the amount of memory (RAM) available for the TrendMiner server and the percentage of memory which is used. In most cases, when you check these numbers you'll notice that the usage is over 90%, often even close to 100%.  Rest assured, this is not an issue. Linux (the OS on which TrendMiner runs) uses all available memory for optimal performance, instead of leaving it unused. If you are interested to read up on all the details we can advise to check this site: https://www.linuxatemyram.com (disclaimer: this is an external website, unaffiliated to TrendMiner and TrendMiner is not accountable for the site nor its content).  So how does TrendMiner use its available memory?Each microservice in TrendMiner gets assigned a fixed amount of memory based on the needs of the service. Our engineers make sure everything fits within the minimal

290
Stijn Agten
Employee
4 months ago
Jef Vanlaer
Community Manager
Jef VanlaerCommunity Manager
published in Admin Corner
Prepare for the upcoming Operating System migration

Red Hat Enterprise Linux 7 (RHEL 7) and the derived CentOS 7 are nearing their end of support. To ensure continued reliability and security for TrendMiner, we are transitioning TrendMiner to run on to the long-term supported Red Hat Enterprise Linux 9 (RHEL 9) and AlmaLinux OS 9 distributions. Infrastructure can already be prepared based on these new OS’s and the new system requirements. A new pre-packaged virtual appliance image based on AlmaLinux 9 has been made available for this purpose.Migration optionsThere are 2 options to migrate the existing server data to the new instance:Full migration including index data based on remote backup & restore (Azure Blob Storage or AWS S3 Bucket are the supported options) Work migration excluding index data based on local backup & restoreThe full migration is highly recommended as it will ensure the smoothest migration path with the least disturbances for end-users.Full details, with additional considerations, can be found in our documen

150
Jef Vanlaer
Community Manager
5 months ago
Jef Vanlaer
Community Manager
Jef VanlaerCommunity Manager
published in Admin Corner
[Recording] TrendMiner 2024.R1.0 admin webinar

On April 9th, 2024 we hosted an exclusive webinar to discuss relevant topics for TrendMiner admins related to the 2024.R1.0 and upcoming releases (recording below).The following topics were covered:What’s new in 2024.R1.0?A quick overview of functional updates and newly available connectivity options. In 2024.R1.0, we added connectivity for Eschbach Shiftconnector, Wonderware 2020 and 2023 and Aspen APRM v14. A complete overview of supported connectivity options is available here.Admin roles comparedTrendMiner 2024.R1.0 introduces a new admin layer to better separate Infrastructure, System and Application administration tasks. Refer to this topic for a complete overview.About the upgradeThe 2024.R1.0 release introduces some major security improvements in ConfigHub and the way you can access ConfigHub. Refer to this documentation article to learn how to access ConfigHub after the upgrade by resetting the admin user password via Edge Manager. It is advised to only use the admin user for

270
Jef Vanlaer
Community Manager
7 months ago
Jef Vanlaer
Community Manager
Jef VanlaerCommunity Manager
published in Admin Corner
Edge Manager vs. ConfigHub

Since TrendMiner version 2023.R3.0 configuration settings have been split up between Edge Manager and ConfigHub. This way, tasks specific to infrastructure admins and system admins are clearly separated and access permissions can be aligned with your organizational structure.Edge Manager is the TrendMiner interface for infrastructure admins. It mainly contains functionality to keep your TrendMiner installation healthy and up-to-date. Edge Manager is not available to SaaS customers as infrastructure administration is taken care of by the TrendMiner team. On virtual appliances, some additional menus for virtual appliance configuration will be available, which do not appear on self-managed single node or private cloud setups. The following tasks can be done from Edge Manager:Checking the health status of TrendMiner services Downloading appliance logs for troubleshooting purposes Gaining insights into memory usage, disk usage (including adding more disk space), CPU usage and time settings

290
Jef Vanlaer
Community Manager
7 months ago
Jef Vanlaer
Community Manager
Jef VanlaerCommunity Manager
published in Admin Corner
TrendMiner admin roles compared

The TrendMiner setup knows 3 different administrator roles:Infrastructure administrator (taken care of by TrendMiner for SaaS setups) System administrator Application administratorThe table below provides an overview of these roles, required skills and access permissions, example tasks and where to perform these tasks in the TrendMiner User Interface.Obviously, one person can take up multiple admin roles, but as different types of tasks are typically distributed over multiple people or teams, these roles permit to match TrendMiner administration to your organizational structure.  ​ ​ ​ ​ Infrastructure administrator ​ ​ System administrator ​ ​ Application administrator ​ ​TrendMiner UI Edge Manager ​ConfigHub​ TrendHub, ContextHub, TrendMiner API ​Description ​The infrastructure admin is responsible for installation and maintenance of the TrendMiner servers on infrastructure, network and security l

330
Jef Vanlaer
Community Manager
7 months ago
Terms & ConditionsCookie settings