[RMHI Home]
[HerbalThinkTCM software] [Tutorials]
[RMHInet] [Courses/Certification] [FAQ]
[Subscribe] [Articles]
[About] [Contact]

— updated 2018-04-11


Herbalists' BootCamp
Beginner Tutorial #2-supplement:   common user errors, known OS problems

by Roger W. Wicke, Ph.D.
These BootCamp tutorials will help you get started using the HerbalThink-TCM software, ensure it is installed correctly, demonstrate how to use important features and modules, and teach you basic principles of Chinese herbology that you can begin applying practically. Successful completion of this series is required for all applicants to the RMHInet brainstorming network and to our professional courses.

Copyright ©2016-2019 by RMH-Publications Trust; all rights reserved.

Jump to another tutorial in this sequence:
#1: Introduction, Download #2: Setup and Documentation #3: Self-Study Reference #4: Herbal Tutor #5: Pulse Simulator #6: CaseQuery #7: AutoSage-TCM #8: Completing member/admission requirements

Subtopics on this page…


Tutorial #2-supplement:   common user errors, known OS problems

The vast majority of known user errors and problems occur on the Windows operating system.


User not decompressing ZIP file as per instructions

On Windows, it is possible to navigate the contents of a ZIP file without decompressing it. Unfortunately, this can lead to a lot of confusion and user error. The original ZIP file/folder can look very similar to the decompressed folder, and if you attempt to run the software from the original, compressed ZIP folder, it may often fail to run correctly, resulting in error messages within the Console usually stating that a particular file could not be found.

The vast majority of our user support problems with Windows is due to this single issue, and the solution is to be sure you are following the installation instructions exactly:



"Could not open/create prefs root node..."

20171108: Recently, I've become aware of a relatively rare error that apparently happens only on Windows systems that have never had a version of Java installed previously. In such cases, when you attempt to run HerbalThinkTCM or CaseQuery, you will receive the following type of error message and the software will not run:

java.util.prefs.WindowsPreferences <init>
WARNING: Could not open/create prefs root node Software\JavaSoft\Prefs
at root 0x80000002. Windows RegCreateKeyEx(...) returned error code 5.

The fix to this error is to manually create the missing file object by performing the following steps:

  1. Log in to an administrative user account to do the following:
  2. Go into your Start Menu and type  regedit  into the search field.
  3. Navigate to path  Computer\HKEY_LOCAL_MACHINE\Software\JavaSoft 
    (Windows 10 seems to now have this here:  Computer\HKEY_LOCAL_MACHINE\Software\WOW6432Node\JavaSoft 
  4. Right-click on the  JavaSoft  folder and click on  New -> Key 
  5. Name the new key  Prefs . You should now be able to launch the HerbalThink-TCM software without errors.

Oracle, the makers of Java, have supposedly been aware of this error for several years, but had given it low priority because it only happens on a small number of systems which do not have Java pre-installed. (For this reason, our installation instructions for Windows now include a recommendation that you first install a version of Oracle Java on your system before installing HerbalThink-TCM.)

If you encounter this error, please contact your assigned BootCamp tutor if you need assistance.


Tiny, unreadable windows

A few Windows 10 users have complained of program windows appearing very small such that they are unreadable. Here is what I found by doing an Internet search and reviewing what Oracle and other websites have said about this problem.

The problem happens when the user's computer is running Windows 10 with a high-DPI (dots-per-inch) monitor. Normally, the operating system, Oracle's Java JRE, and the Java application must all coordinate/communicate with each other so that application windows are sized and rendered correctly based on screen size, resolution, and other system properties. Unfortunately, this does not always happen. Oracle's Java 8 has a bug in it that declares it to be "high-DPI-aware" when, in some cases, it is not. This apparently is the case with the HerbalThink-TCM software. Supposedly, according to Oracle, this problem has been fixed in Java 9, and we are looking into incorporating Java 9 into a future release of HerbalThink-TCM.

Until we upgrade to Java 9, according to several websites I read, there is a simple fix, outlined below. I have not fully tested this, as I do not use any high-DPI monitors, but I did at least verify the procedure below is correct for my Windows 7 system:

  1. First quit any HerbalThink-TCM applications.
  2. Navigate to the following file within your HerbalThink-TCM package:
    (If file extensions are set to 'hidden', the preceding file will appear as  java .)
  3. Right-click and select  Properties .
  4. Select the  Compatibility  tab.
  5. Check  Override high DPI scaling behavior .
  6. If the  Scaling performed by:  option-field is available, choose  System .

When you launch HerbalThink-TCM or CaseQuery applications, windows should now scale correctly. If not, you may need to reboot your system for changes to take effect.

Linux:   We have not yet had any users complain of this problem on Linux, but in case it does arise, the following may work for Linux systems running a high-DPI monitor:
If you can add parameters to the java shell script that launches the application, you can use the option -D to pass a value for the  sun.java2d.uiScale  property to specify a scaling factor for Java2D. This will scale your application. The scaling factor value is a double. Make sure that you pass this option to the java binary itself, not the launched Java application.
Example:   to launch xxx.jar with a UI scaling factor of 2.5:
    java -Dsun.java2d.uiScale=2.5 -jar xxx.jar
If you experience this problem on Linux, ask your assigned tutor for help with the preceding.

Go back to   Tutorial #2:   CaseQuery