DNASYS.INI
Make eDNA fly
Presenter – Ryan Schumacher
● Support Analyst
● 2nd year presenting at the User Conference
● Background in Electrical Engineering
● 5 years in contract/consulting engineering
for the power industry
Confidential & Proprietary.
What is DNASYS.ini?
● Local eDNA configuration for a workstation or server
● Shared configuration for all eDNA applications
● Provides SvcDir a list of addresses to look for other SvcDirs
● Provides eDNA services and clients with the address and port of the SvcDir
● Provides connection instructions to eDNA clients
● Provides time zone and Daylight Saving time information
● Provides other eDNA client configuration options
Confidential & Proprietary.
Where is the DNASYS.INI file?
● For eDNA services and clients prior to the 2014R1 release, it is located
in C:\Windows\.
● The SvcDir list was in the Windows Hosts file:
● C:\Windows\System32\drivers\etc\hosts
● Starting with the 2014R1 release, it is located in
%ALLUSERPROFILE%\InStep\
● In Windows 7, 2008, or newer: C:\ProgramData\InStep\
● C:\ProgramData\ is a hidden folder. Type it in the path bar if not visible
● If a computer runs eDNA applications from both periods, then both
DNASYS.INI files must be kept and maintained.
Confidential & Proprietary.
Where is the DNASYS.INI file?
● Can be edited in eDNA Explorer
Confidential & Proprietary.
Default DNASYS.INI
Example:
● The basics of the DNASYS.INI are
setup during the installation
process when running any of the
eDNA installers
● If an eDNA tool or API is run on a
system without an existing
DNASYS.INI file, then a default file
is created.
Confidential & Proprietary.
[SVCDIR]
SVCDIR_01=127.0.0.1
PORT=6321
[dst1]
tz1=Pacific
Data1=1970, 2006, 10, 5, 1, 120, 0
Data2=1970, 1973, 4, 5, 1, 120, -60
Data3=1974, 1974, 1, 65535, 6, 120, -60
Data4=1975, 1975, 2, 65535, 23, 120, -60
Data5=1976, 1986, 4, 5, 1, 120, -60
Data6=1987, 2006, 4, 1, 1, 120, -60
Data7=2007, 2037, 11, 1, 1, 120, 0
Data8=2007, 2037, 3, 2, 1, 120, -60
[CLIENT]
USE_REGIONAL_SETTINGS=0
SHOW_ID_SELECTOR=0
DNASYS.INI Sections
● Section heading are in square brackets [ ]:
● [SVCDIR]
● [dst1]
● [CLIENT]
● [PROXY]
Confidential & Proprietary.
[SVCDIR]
● PORT=
Example:
[SVCDIR]
SVCDIR_01=127.0.0.1
PORT=6321
● The SvcDir communication port.
● Must be the same for all workstations and servers that are in
communication
● SVCDIR_xx= (incrementing starting at SVCDIR_01)
● IP Address, hostname, or Fully qualified domain name
● DNASYS SvcDir entries take precedence over hosts entries
● Format has changed from old hosts entries
Confidential & Proprietary.
[dstX]
● tz=
● Time zone
● DataX=
● Definition of Daylight Saving Time
rules
● Startyear, EndYear, Month, Week,
Day, Minutes, Offset (minutes)
● Auto_Update_dst_info=0
● If set to ‘0’, then it disables the dst
update from the SvcDir
Confidential & Proprietary.
Example:
[dst1]
tz1=Pacific
Data1=1970, 2006, 10, 5, 1, 120, 0
Data2=1970, 1973, 4, 5, 1, 120, -60
Data3=1974, 1974, 1, 65535, 6, 120, -60
Data4=1975, 1975, 2, 65535, 23, 120, -60
Data5=1976, 1986, 4, 5, 1, 120, -60
Data6=1987, 2006, 4, 1, 1, 120, -60
Data7=2007, 2037, 11, 1, 1, 120, 0
Data8=2007, 2037, 3, 2, 1, 120, -60
[CLIENT]
● IP_ADDRESS=
● For use on machines with multiple
NICs
● MAX_DNA_SVCDIR=
● Max Number of SvcDirs that clients
and services will communicate with
● PREFERRED_DNA_SVCDIR
● Defines the SvcDir that clients should
attempt to communicate with first
● Some clients will display a message
if they cannot connect to this SvcDir
Confidential & Proprietary.
Example:
[CLIENT]
IP_ADDRESS=127.0.0.1
MAX_DNA_SVCDIR=5
PREFERRED_DNA_SVCDIR=127.0.0.1
TRACE_FILE=C:\DNA\APITRACE.TXT
NET_TRACE_FILE=C:\DNA\APITRACE.TXT
PORT_MIN=5000
PORT_MAX=7000
GMT_TIME_BIAS=240
GMT_DST_BIAS=1
USE_REGIONAL_SETTINGS=0
DATE_TIME_FORMAT= %H:%M:%S %b %d %Y
SHOW_ID_SELECTOR=1
COMPRESS_APPSERV_FILE=1
[CLIENT]
● TRACE_FILE= &
NET_TRACE_FILE =
● Writes some debugging info for
communication between clients and
services
● Should not be left on long term
Confidential & Proprietary.
Example:
[CLIENT]
IP_ADDRESS=127.0.0.1
MAX_DNA_SVCDIR=5
PREFERRED_DNA_SVCDIR=127.0.0.1
TRACE_FILE=C:\DNA\APITRACE.TXT
NET_TRACE_FILE=C:\DNA\APITRACE.TXT
PORT_MIN=5000
PORT_MAX=7000
GMT_TIME_BIAS=240
GMT_DST_BIAS=1
USE_REGIONAL_SETTINGS=0
DATE_TIME_FORMAT= %H:%M:%S %b %d %Y
SHOW_ID_SELECTOR=1
COMPRESS_APPSERV_FILE=1
[CLIENT]
● PORT_MIN= & PORT_MAX=
● Defines the range of Client ports that
can be used by eDNA clients and
services
● Service client ports are opened
before service listening ports
● If not specified, then client ports are
used in the 49152 – 65535 range
Confidential & Proprietary.
Example:
[CLIENT]
IP_ADDRESS=127.0.0.1
MAX_DNA_SVCDIR=5
PREFERRED_DNA_SVCDIR=127.0.0.1
TRACE_FILE=C:\DNA\APITRACE.TXT
NET_TRACE_FILE=C:\DNA\APITRACE.TXT
PORT_MIN=5000
PORT_MAX=7000
GMT_TIME_BIAS=240
GMT_DST_BIAS=1
USE_REGIONAL_SETTINGS=0
DATE_TIME_FORMAT= %H:%M:%S %b %d %Y
SHOW_ID_SELECTOR=1
COMPRESS_APPSERV_FILE=1
[CLIENT]
● GMT_TIME_BIAS=
● Forces eDNA to display times using
this offset from GMT rather than the
local time settings
● In minutes
● GMT_DST_BIAS=
● Sets whether Daylight Saving Time
rules are used when
GMT_TIME_BIAS is set.
Confidential & Proprietary.
Example:
[CLIENT]
IP_ADDRESS=127.0.0.1
MAX_DNA_SVCDIR=5
PREFERRED_DNA_SVCDIR=127.0.0.1
TRACE_FILE=C:\DNA\APITRACE.TXT
NET_TRACE_FILE=C:\DNA\APITRACE.TXT
PORT_MIN=5000
PORT_MAX=7000
GMT_TIME_BIAS=240
GMT_DST_BIAS=1
USE_REGIONAL_SETTINGS=0
DATE_TIME_FORMAT= %H:%M:%S %b %d %Y
SHOW_ID_SELECTOR=1
COMPRESS_APPSERV_FILE=1
[CLIENT]
● USE_REGIONAL_SETTINGS=
● If 0, then eDNA Client tools use the
English – United States time format
● If 1, then eDNA Client tools use the
time format defined on the local
computer
● DATE_TIME_FORMAT=
● Overrides the time format when
USE_REGIONAL_SETTINGS=0
● Formatting parameters are based on
C++
Confidential & Proprietary.
Example:
[CLIENT]
IP_ADDRESS=127.0.0.1
MAX_DNA_SVCDIR=5
PREFERRED_DNA_SVCDIR=127.0.0.1
TRACE_FILE=C:\DNA\APITRACE.TXT
NET_TRACE_FILE=C:\DNA\APITRACE.TXT
PORT_MIN=5000
PORT_MAX=7000
GMT_TIME_BIAS=240
GMT_DST_BIAS=1
USE_REGIONAL_SETTINGS=0
DATE_TIME_FORMAT= %H:%M:%S %b %d %Y
SHOW_ID_SELECTOR=1
COMPRESS_APPSERV_FILE=1
[CLIENT]
● SHOW_ID_SELECTOR=
● If 0, then always use Point Picker
● If 1, then use ID Selector if available
● COMPRESS_APPSERV_FILE=
● If set then files are compressed
before sent to be saved to the
AppServ database
Confidential & Proprietary.
Example:
[CLIENT]
IP_ADDRESS=127.0.0.1
MAX_DNA_SVCDIR=5
PREFERRED_DNA_SVCDIR=127.0.0.1
TRACE_FILE=C:\DNA\APITRACE.TXT
NET_TRACE_FILE=C:\DNA\APITRACE.TXT
PORT_MIN=5000
PORT_MAX=7000
GMT_TIME_BIAS=240
GMT_DST_BIAS=1
USE_REGIONAL_SETTINGS=0
DATE_TIME_FORMAT= %H:%M:%S %b %d %Y
SHOW_ID_SELECTOR=1
COMPRESS_APPSERV_FILE=1
[PROXY]
● IP_ADDRESS=
● IP address of the DNAPrxy service
● IP_ADDRESS_SECONDARY=
● IP address of the secondary
DNAPrxy service to be used if the
primary does not respond to the
client
● PORT=
● The TCP port used by both the
primary and secondary DNAPrxy
services.
Confidential & Proprietary.
Example:
[PROXY]
IP_ADDRESS=127.0.0.1
IP_ADDRESS_SECONDARY=127.0.0.2
PORT=7007
LOCATION_1=AltLocation
LOC_1_IP_ADDRESS=127.0.0.3
LOC_1_PORT=7008
[PROXY]
● LOCATION_x=
● The name assigned to the proxy
● LOC_x_IP_ADDRESS=
● IP address DNAPrxy service to
associate with the associated
location
● LOC_x_PORT=
● The TCP port used by the DNAPrxy
service associated with the location
Confidential & Proprietary.
Example:
[PROXY]
IP_ADDRESS=127.0.0.1
IP_ADDRESS_SECONDARY=127.0.0.2
PORT=7007
LOCATION_1=AltLocation
LOC_1_IP_ADDRESS=127.0.0.3
LOC_1_PORT=7008
[PROXY]
[PROXY]
LOCATION_1= Chicago
LOC_1_IP_ADDRESS=1.1.1.1
LOC_1_PORT=1111
LOCATION_2= Dallas
LOC_2_IP_ADDRESS=2.2.2.2
LOC_2_PORT=2222
LOCATION_3= New York
LOC_3_IP_ADDRESS=3.3.3.3
LOC_3_PORT=3333
Confidential & Proprietary.
Questions?
Confidential & Proprietary.
Confidential
& Proprietary.
© 2015 Schneider
Electric Software, LLC. All rights reserved.