Setting Environment Variables for Automatic Offload

To set the environment variables for Automatic Offload mode, described in Automatic Offload Controls, use the appropriate commands in your command shell:

• For the bash shell, set the appropriate environment variable(s) as follows:

  export MKL_MIC_ENABLE=1

  export OFFLOAD_DEVICES=<list>

  For example: export OFFLOAD_DEVICES=1,3

  export OFFLOAD_ENABLE_ORSL=1

  export MKL_HOST_WORKDIVISION=<value>

  For example: export MKL_HOST_WORKDIVISION=0.2

  export MKL_MIC_WORKDIVISION=<value>

  export MKL_MIC_<number>_WORKDIVISION=<value>

  For example: export MKL_MIC_2_WORKDIVISION=0.33

  export MKL_MIC_MAX_MEMORY=<value>

  export MKL_MIC_<number>_MAX_MEMORY=<value>

  For example: export MKL_MIC_0_MAX_MEMORY=2G

  export MKL_MIC_REGISTER_MEMORY=1

  export MKL_MIC_RESOURCE_LIMIT=<value>

  For example: export MKL_MIC_RESOURCE_LIMIT=0.34

  export MIC_OMP_NUM_THREADS=<value>

  export MIC_<number>_OMP_NUM_THREADS=<value>

  For example: export MIC_0_OMP_NUM_THREADS=240

  export OFFLOAD_REPORT=<level>

  For example: export OFFLOAD_REPORT=2

  export LD_LIBRARY_PATH="/opt/intel/mic/coi/host-linux-release/lib:${LD_LIBRARY_PATH}"

  export MIC_LD_LIBRARY_PATH="/opt/intel/mic/coi/device-linux-release/lib:${MKLROOT}/lib/mic:${MIC_LD_LIBRARY_PATH}"

  export MKL_MIC_THRESHOLDS_?GEMM="<N>,<M>,<K>"

  For example: export MKL_MIC_THRESHOLDS_?GEMM="2000,1000,500"

• For a C shell (csh or tcsh), set the appropriate environment variable(s) as follows:

  setenv MKL_MIC_ENABLE 1

  setenv OFFLOAD_DEVICES <list>

  For example: setenv OFFLOAD_DEVICES 1,3

  setenv OFFLOAD_ENABLE_ORSL 1

  setenv MKL_HOST_WORKDIVISION <value>

  For example: setenv MKL_HOST_WORKDIVISION 0.2

  setenv MKL_MIC_WORKDIVISION <value>

  setenv MKL_MIC_<number>_WORKDIVISION <value>

  For example: setenv MKL_MIC_2_WORKDIVISION 0.33

  setenv MKL_MIC_MAX_MEMORY <value>

  setenv MKL_MIC_<number>_MAX_MEMORY <value>

  For example: setenv MKL_MIC_0_MAX_MEMORY 2G

  setenv MKL_MIC_REGISTER_MEMORY 1

  setenv MKL_MIC_RESOURCE_LIMIT <value>

  For example: setenv MKL_MIC_RESOURCE_LIMIT 0.34

  setenv MIC_OMP_NUM_THREADS <value>

  setenv MIC_<number>_OMP_NUM_THREADS <value>

  For example: setenv MIC_0_OMP_NUM_THREADS 240

  setenv OFFLOAD_REPORT <level>

  For example: setenv OFFLOAD_REPORT 2

  setenv LD_LIBRARY_PATH "/opt/intel/mic/coi/host-linux-release/lib:${LD_LIBRARY_PATH}"

  setenv MIC_LD_LIBRARY_PATH "/opt/intel/mic/coi/device-linux-release/lib:${MKLROOT}/lib/mic:${MIC_LD_LIBRARY_PATH}"

  setenv MKL_MIC_THRESHOLDS_?GEMM "<N>,<M>,<K>"

  For example: setenv MKL_MIC_THRESHOLDS_?GEMM "2000,1000,500"