Customize the TERR environment at startup

A user or an administrator can specify a variety of files, environment variables, and functions to customize a TIBCO Enterprise Runtime for R session. These options are processed when the session starts. Changing them does not affect the current session of TIBCO Enterprise Runtime for R.

These startup options are run in order and include the following.

  1. TERRenviron files
  2. TERRprofile files
  3. .TERRData files
  4. .First function

For both TERRenviron and TERRprofile, you can specify site-specific and user-specific files, which are processed in that order. Optionally, you can specify them as environment variables rather than files.

You can bypass running individual or all startup options by passing flags.

Optional startup flags Description
--vanilla All startup options ignored.
--no-environ All TERRenviron files and environment variables are ignored.
--no-site-file All site-specific profile files and environment variables are ignored.
--no-init-file All user-specific profile files and environment variables are ignored.

This flowchart shows you how these options are processed at startup.

customizing the TERR startup TERRenviron TERRprofile .TERRData .First TERRenviron TERRprofile .TERRData .First
  • TERRenviron
    The optional TERRenviron files can contain the definitions of environment variables to specify such customizations as JAVA_HOME and the project directory for TIBCO Enterprise Runtime for R. TERRenviron is the first file run in a customized TIBCO Enterprise Runtime for R startup.
  • TERRprofile
    The optional TERRprofile files can contain R code that is run in the TIBCO Enterprise Runtime for R session global enviornment so that objects created in them are visiable to the user.
  • .TERRData
    The file .TERRData is created in the current directory by the function save.image() when you quit TIBCO Enterprise Runtime for R and specify yes when prompted to save an image of the session.
  • .First
    If you create a function called .First and put it in a TERRprofile file, or if it is saved in .TERRData, then it is run as part of the TIBCO Enterprise Runtime for R startup.
Contents
Search Results