Skip to main content

Environment Variables

Introduction

Environment variables are a fundamental part of developing application. eWam 7 tries as much as possible to follow the 12 factors methodology. One aspect of this is to leverage environment variables.

Default ewam env variables

eWAM accepts a certain number of environment variables to allow you to customize your development and run-time environment.

Environment VariablesDescriptionDefault
WYDE-ROOTThis variable is the main environment variable, pointing to the directory in which ewam-kernel have been installed.  Other environment variables that are not explicitly specified will be defined relative to this variable../node_modules /@ewam/kernel
WYDE-DLLDirectory from which application DLLs are loaded.  These application DLLs include DLLs you build with the C++ producer, as well as WAM system DLLs for various tools and options of WAM. (Note that starting for version 7.0.4, this environment variable support multiple folder (like PATH))./node_modules/@ewam/library/CPPDLL
WYDE-ADMINThe directory in which eWam and other Wyde solutions (wInterface, wPortal, ...) store accesses to external systems../ADMIN
WYDE-HELPDirectory in which WAM's on-line help is installed.  Note that, for this environment variable, you can put URL's in case the help is installed on a Web Server to which you have access.  For example, WYDE-HELP=https://mphasiswyde.github.io/ewam-docs/./node_modules/@ewam/help
WYDE-LICENSEThe directory in which ewam license file (eWAM6100.lcs) is located. It is recommended that you set it globally on your computer.WYDE-ROOT
WYDE-SERVERLICENSEThe directory in which server licenses files (wydeweb.lcs, wed.lcs, ewed.lcs) are located (WydeWeb, Wed, eWed). See Licenses for more information.WYDE-ROOT
WYDE-DEVTGVThe directory in which the development TGV data base W003001.TGV is located../TGV
WYDE-ERRDirectory in which logs are located../LOG
WYDE-IMPEXPDirectory from which import/export files are loaded and to which they are stored if full path name isn't supplied to the Import/Export Tool../IMPEXP
WYDE-REFDEVTGVDirectory in which the shared repository TGV data base W004001.TGV is located.  This variable must be set to the correct directory for workgroup functionality to work../TGV
WYDE-SYSTGVThe directory in which the system TGV data base W001001.TGV is located../TGV
WYDE-TESTTGVThe directory in which the development TGV data base (by default W007001.TGV) is located../TGV
WYDE-TGVThe root directory for TGV data bases.  Unless otherwise specified, WYDE-DEVTGV, WYDE_IMPEXP, WYDE-REFDEVTGV, WYDE-SYSTGV, and WYDE-TESTTGV point to his same directory. ./TGV
WYDE-TUTORIALDirectory in which WAM's on-line tutorials are installed.  Note that, for this environment variable, you can put URL's in case the tutorials are installed on a Web Server to which you have access. ./node_modules/@ewam/help
WYDE-CPPFILESDefault output for cpp generated files./.build/cpp
WYDE-COMPILERESULTSDefault output for cpp generated dlls./.build/cppdll

Using .Env

Before we get into the specifics, you should read the excellent post from John Papa

Change the Admin location

  1. Open boilerplate/developer/.env
  2. Change WYDE-ADMIN=../Admin to WYDE-ADMIN=./Admin2
  3. Open eWam
  4. Check the variable is changed