Product |
Version |
Spotfire Service for R |
All Versions |
Keywords:
Spotfire R Service, R_HOME, SPOTFIRE_R_HOME, TERR, R installation, environment variables, Spotfire Client Hotfix, dedicated node manager, performance issues, open-source R, system requirements.
Description:
Issues are encountered for Spotfire Service for R while starting the service on Windows Node Manager machines, often related to the R Home configuration. These issues typically arise due to improper setup of the R_HOME and SPOTFIRE_R_HOME environment variables or an incompatible R installation. This KB provides steps to resolve the issue by correctly configuring the R environment, ensuring the R installation meets system requirements, and upgrading TERR and the Spotfire Client Hotfix.
Solution:
Prerequisites for Configuring Spotfire Service for R
Before configuring the Spotfire Service for R, ensure the following steps are completed on the computer running the node manager:
1. Install and Configure R:
Install a compatible version of open-source R as per the system requirements for Spotfire Service for R.
Ensure the R installation is complete and functional.
2. Set environment variables:
Set the R_HOME environment variable to the root directory of the R installation (e.g., C:\Program Files\R\R-4.1.0
).
Set the SPOTFIRE_R_HOME environment variable to the same path as R_HOME.
To set environment variables on Windows:
- Open the Start Menu and search for "Environment Variables."
- Click on "Edit the system environment variables."
- In the System Properties window, click on "Environment Variables."
- Under "System variables," click "New" and add the R_HOME and SPOTFIRE_R_HOME variables with the appropriate paths.
- Click "OK" to save the changes.
System Requirements for Spotfire Service for R 1.17.X LTS.
The following open-source R versions are supported:
-
R 4.4
-
R 4.3
-
R 4.2
-
R 4.1
-
R 4.0
Note:
- Open-source R (R) is available under separate open-source software license terms and is not part of Spotfire Service for R.
Additional Steps for Resolving the Issue
1. Upgrade TERR and Spotfire Client Hotfix:
- Upgrade TERR to version 1.17.6 or the latest compatible version.
- Apply the latest Spotfire Client Hotfix to ensure compatibility and resolve any known issues.
2. Run R Services on a Dedicated Node Manager:
- Configure R services to run on a dedicated node manager. This prevents resource contention and performance degradation.
3. Verify Configuration and Restart Services:
- After configuring the environment variables and upgrading the necessary components, restart the Spotfire R Service.
- Verify that the service starts without errors and that R-related functionalities are working as expected.
Reference Documentation
For detailed instructions and additional information, refer to the following documentation: