Professional Server Setup & installation

aboardarmServers

Dec 4, 2013 (3 years and 10 months ago)

157 views










Dynamic AI

Professional Server

Setup & installation








2

of
38

Dynamic AI Professional Server setup & installation
















Version 4.
4
.

Last updated:
December 4, 2013




This document is part of

the documentation for

license protected Dynamic AI
TM




Co
pyrights (C) 1998
-
200
5

CINTAC A/S

All rights reserved


Dynamic AI Professional Server setup & installation
3

of
38


Contents

Introduction

................................
................................
................................
.................

5

Pre
-
installation tasks

................................
................................
................................
.

6

Requirements

................................
................................
................................
.........

6

Hardware

................................
................................
................................
..........

6

Operating system

................................
................................
.............................

8

System software environment

................................
................................
..........

9

External software

................................
................................
...........................

10

Installing Dynamic AI

................................
................................
...............................

11

Automatic Installation

................................
................................
...........................

12

File extraction

................................
................................
................................
.

13

Configuration

................................
................................
................................
..

15

Manual Installation

................................
................................
................................
...

20

Upgrading

................................
................................
................................
..................

22

Selecting a backup
-
strategy for Dynamic AI

................................
.........................

24

Un
-
install Dynamic AI

................................
................................
...............................

25

Manual Un
-
install

................................
................................
................................
..

25

Appendix A: Troubleshooting installati
on

................................
.............................

28

Problems with IIS (Internet server)

................................
................................
.......

28

Problems with Security

................................
................................
.........................

30

Problems with component registration

................................
................................
.

31

Other issues

................................
................................
................................
.........

32

Appendix B: NTFS and IIS permissions

................................
................................
.

33

Windows 2003 IIS Web Service Extensions

................................
........................

34

Dynamic AI security access requirements

................................
...........................

35

App
endix C: Files installed by Dynamic AI

................................
............................

36

4

of
38

Dynamic AI Professional Server setup & installation




Dynamic AI Professional Server setup & installation
5

of
38


Introduction

This document describes the installation and configuration of the Dynamic
AI Professional server.


The document is intended for IT
-
professionals. It describes requireme
nts and
recommendations for system software, hardware configurations and walks
through every step of the actual installation of the Dynamic AI Server.


In order to use this document, you must be familiar with windows, and have
some knowledge of Microsoft I
nternet Information Services to successfully
install it.

6

of
38

Dynamic AI Professional Server setup & installation



Pre
-
installation tasks

This chapter discusses the elements that you need to consider before
installing Dynamic AI.


This includes:



H
ardware



A qualifying Microsoft Windows operating system installed



A working
IIS
web server



D
atabase
Clients / D
rivers



The Dynamic AI installation files



A valid Dynamic AI license or trial license code



A Windows user account with administrative privileges

Requirements

Hardware

The importance of fast hardware for your Dyna
mic AI server is tied in with
the type of use you expect.


Since much of a Dynamic AI operation
-
cycle is taken up by network traffic
and processing by the data provider, the performance of these components
has a large impact on the perceived Dynamic AI pe
rformance. Thus it is
equally important that these components are geared to the task.


Dynamic AI itself takes up only about 12 MB of disk space initially, but
allowing for system databases, preview databases, cached data and log file
growth, a minimum of
200 MB free space is recommended. This is in
addition to necessary system software, such as operating system, web
-
server
and data access components.


Dynamic AI Professional Server setup & installation
7

of
38



1) Client Request
Transport

Very short time, no resource consumption
on the Dynamic AI Server.

User acti
vates am item in the browser,
causing a request to be send over the
network to the web server

2) Dynamic AI Pre
-
Query Processing

This typically takes a very short time and
consumes very few resources

The Dynamic AI server receives the
client request, vali
dates access rights
and sends a query to the underlying
database. More than one query may
be needed for a particular Dynamic AI
report

3) Network
Transport

Very short time, low Dynamic AI Server
resource consumption.

The Database query is transported
over

the network from the Dynamic AI
server to the relevant database server.

4) Data provider
processing

Data provider processing takes a variable
time, depending on factors such as
complexity, database power, indexing and
size of result set

The remote databa
se server processes
the query. If the query is complex or
working on un
-
indexed tables, it will
take more time.

5) Network
Transport

Might be time consuming, depending on
network speed and size of result set, low
resource consumption on the Dynamic AI
Ser
ver.

The database server returns the query
result to the Dynamic AI server.
Larger results take longer time.

6) Dynamic AI
result formatting

This typically takes a very short time,
depending on size of result set and
complexity of calculations

Dynamic AI
takes the result set
provided by the database server and
formats in into HTML based on the
stored report design

7) Client Response
transport

Might be time consuming, depending on
network speed and size of result set

The HTML response is send back to
the r
equesting client browser over the
network.

8) Client rendering

Might be time consuming depending on
client processing power and complexity
and size of result set

The client computer processes the
result and renders the HTML.

Conceptual breakdown of a Dy
namic AI operation cycles.
The Dynamic AI Server is responsible for the
computing power required by the white processing boxes



It is recommended that production Dynamic AI installations be installed on
current

hardware. Depending on types of tasks perfor
med with Dynamic AI,
network speed, server memory and processing power is important:


RAM is important
when

CPU power is
important when

Network speed is
important when

Disk Speed is
important when



There are many
concurrent users
(Please allow at
least 5 M
B of
ram per
concurrent user)



There are many
different reports
defined



Often used
report
collections are
large and has
complex
calculations




Data sources
do not reside
on the
Dynamic AI
server



Large
amounts of
data are
moved
through
Dynamic AI



Data sources

is installed
on the
Dynamic AI
server


8

of
38

Dynamic AI Professional Server setup & installation



A good guideline for RAM consumption is OS requirements + 128Mb + 5Mb
per concurrent User, making 256Mb the minimum recommendation for a
dedicated Dynamic AI server with a low number of users.

Operating system

Micro
soft Windows is required to run Dynamic AI.


Supported
Windows Server
versions are Windows 2003 Server,
Windows
2000 Server and Windows NT 4.0 Server.


The Windows clients, Windows XP Professional, Windows 2000
Professional and NT 4.0 Workstation, are sup
ported but have limitations in
supported simultaneous HTTP connections and are only recommended for
tests/development.


Windows XP home edition is not supported.


Dynamic AI runs on top of the Microsoft
IIS
web server. The

version of IIS
are tied to the
ve
rsion of Windows is installed on the Dynamic AI server.


The recommended platforms are Windows 2000 or 2003 server (or advanced
server)


Refer to the below table for details on software versions:


Windows version

IIS version

Notes

Windows 2003 Server

IIS

6.0

Security settings must be manually
configured

Active Server Pages must be enabled
in Web Service Extensions



see
“Installing Dynamic AI”

Windows 2000 Server

IIS 5.0


Windows NT 4.0 Server

IIS 4.0

Requires SP3 and option pack.

*) Windows 2000
Profe
ssional

IIS 5.0


*) Windows NT 4.0
Workstation

IIS 4.0

Requires SP3 and option pack.

*) Windows XP Professional

IIS 5.1


*) Workgroup mode due to IIS limitation of 10 concurrent HTTP connections (~3 concurrent users)


Dynamic AI is per default installed

as a virtual directory under the Default
Web Site installed on most windows versions. The system database files
reside on the same server computer. This scenario supports a substantial
Dynamic AI Professional Server setup & installation
9

of
38


number of users depending on usage frequency, network conditions and
h
ardware.


The web server and site name can be changed from the setup program.


Dynamic AI is also available in an Enterprise version. The enterprise version
makes it possible to have multiple Dynamic AI servers sharing the same
system database, which in th
is case is an Oracle, Microsoft SQL server or
IBM DB/2 backend. The Enterprise version thus supports a virtually endless
number of users. The Enterprise version also supports highly secure
environments with access to the Dynamic AI server from the Internet
, with
its

High
-
security
DMZ setup.


The server must be configured for the TCP/IP protocol.

System software environment

Apart from the operating system,
IIS

must be installed on the Dynamic AI
Server.


IIS must be installed separately on Windows 2003 se
rver.
Windows 2000
Server

and Windows XP

Professional install

IIS by default.


Dynamic AI can be setup to allow users to send reports etc as emails to
external users. If you want to use this feature, make sure you install the
SMTP Service feature when ins
talling and configuring IIS.


Microsoft Data Access Components version 2.5 (MDAC

2.5) or later must be
available.
They are always installed with Windows 2000 or later versions.
These components allow access to various data sources using OLEDB
and
are usually installed already as part of the operating system, but they can also
be downloaded from http://www.microsoft.com/data/.


If installing versions later than

MDAC

version 2.6 or later, please note that
ODBC drivers are not include
d in the MDAC package.
Y
ou
will
need to
download and install these drivers separately. The download is called JET
service pack, and can be found on http://www.microsoft.com/data/


Dynamic AI connects to databases through OLEDB or ODBC. Please note
that usi
ng OLEDB under most circumstances will result in greater
performance. It is recommended to use OLEDB providers if they are
available for the databases you wish to connect.

10

of
38

Dynamic AI Professional Server setup & installation



External software

The operating system configuration described above, includes the M
icrosoft
Data Access Components (MDAC)
.


MDAC allow connections to Microsoft SQL server and to Microsoft Access
and various other ODBC compliant file based databases. MDAC also
provides the basis for O
LEDB connectivity.


If your Dynamic AI installation needs to access data on other databases, such
as Oracle
,
MySQL
or IBM DB/2, you will need to install appropriate client
connectivity and OLEDB compliant drivers for these databases.


Refer
to the documentation that comes with client drivers for your particular
database version.

Dynamic AI Professional Server setup & installation
11

of
38


Installing Dynamic AI

Before performing the actual installation, make sure that your target system
has all the necessary components installed, including Operating sys
tem,
Internet Information Services and
relevant
database
client
components. Also
make sure you have a valid Dynamic AI license (or trial license) code.


Refer to the Requirements section of this document.


NOTE
S

ON WINDOWS 2003 INSTALLATION
S
:


This sectio
n gives a brief overview of things to be aware of when installing
on Windows 2003 Server.


Windows 2003 Server takes a different approach to security settings than
previous windows versions. This means that features that were installed and
enabled by defau
lt in earlier versions are now disabled or not installed at all.


The Dynamic AI setup program does not make changes to file permissions or
to operating system security settings.


For these reasons, there are a few things that need to be set manual
ly


Ref
er
to Appendix B for information on how to change the settings.



BEFORE INSTALLING DYNAMIC AI:

-
Make sure that IIS has been installed on the server

-
Make sure the web service extension, “Active Server Pages” has been
allowed



AFTER INSTALLING DYNAMIC AI:

-
Make sure the necessary file permissions are set on the Dynamic AI files.

12

of
38

Dynamic AI Professional Server setup & installation



Automatic Installation

The automatic installation is a two
-
step procedure.


You will have a single executable file that includes the entire installation
package.


The file is nam
ed “DAI_4_
buildnumber
install.EXE”. (
Buildnumber

indicates
the internal version of Dynamic AI.)


We refer to this file simply as DAI_install.exe.


TIP: If you are familiar with software installations, and are sure the
prerequisites such as Internet Informat
ion Server, Data Access Components
(MDAC) etc. are in place; you will find the installation and subsequent
configuration of Dynamic AI very easy.


The installation is a two
-
step procedure, consisting of file extraction and
configuration.


File extraction i
s straight forward, and requires only specification of a
destination directory with adequate disk space. The default destination
directory is c:
\
dynamic
\


Once extraction has completed, the program will automatically launch the
daisetup.exe utility that co
nfigures the Internet Information Server. This
utility can also be manually launched from the destination directory.


If you accepted the default destination directory, the daisetup.exe utility will
already have default settings that match most needs. You
can just accept the
default values and press next. The only information you will need to enter is
the license information.


If you are unsure of any element, or are installing on a computer hosting
more than one web site, please read through the following

before
proceeding.




Dynamic AI Professional Server setup & installation
13

of
38


Step one, extracts necessary files to a common installation point (c:
\
dynamic
\

is the default)
,

t
hen launches the setup utility.


Step two is the setup utility, which will guide you through the configuration
of Dynamic AI.


The setu
p utility is also used for
upgrading,
re
-
creation of the global.asa
configuration file

and removal of
Dynamic AI
.

File extraction

Execute the DAIinstall.exe file.


The install wizard will guide you through the extraction steps:




Welcome message


click
N
ext or Exit to
cancel installation


License agreement.

Click
N
ext to accept or Exit to cancel
installation

14

of
38

Dynamic AI Professional Server setup & installation





Select installation path.

The default installation point is c:
\
dynamic
\

If you accept this, press
N
ext, otherwise
correct and press
N
ext.



Warning message if the directory does not
exist.

Click
Y
es to accept, or
N
o, to specify
another directory name



Final confirmation page before actual file
extraction begins.


Click
N
ext.


Files are extracted to the specified
installation point. This ta
kes less than 30
seconds.

Dynamic AI Professional Server setup & installation
15

of
38




File extraction has completed.


Leave the box checked to proceed directly
to the configuration utility

Or

Uncheck the box if you plan to configure the
Dynamic AI server later.


Click E
x
it


Configuration

If you just finished e
xtracting the files and left the Launch box checked, the
configuration program will start automatically.


Otherwise, start the DAIsetup.exe program from the installation point you
chose during extraction. If you accepted the default settings, the full path

to
the configuration program will be c:
\
dynamic
\
daisetup.exe


TIP: If the license information was made available to you electronically,
copy it to the clipboard. If license information is found in the clipboard, the
daisetup.exe configuration program will

automatically enter it for you.

16

of
38

Dynamic AI Professional Server setup & installation



Main Setup Screen



The purpose of the main setup
screen is to gather information
about what task you want to
accomplish.


Entering the license key you got
with the purchase of the Dynamic AI
license provides information

about
the nature of the license you have,
as information, such as version of
Dynamic AI (Professional or
Enterprise edition) is encoded in the
license key.


On this screen you also select among different tasks:


Setup Dynamic AI
installs a clean instance

of Dynamic AI. You will be
asked to supply additional parameters on subsequent screens.


Upgrade

upgrades an existing, working version of Dynamic AI. Setup
automatically detects if an upgradeable version exists.

If the existing
installation is corrupt, or

you want to change the folder, please remove the
existing version and perform a fresh install.


Upgrade DAI files

allows you to patch the internal structure of a previous
versions repository files (dnmc.dai and dnmclog.dai)


Remove Dynamic AI

the Dynamic
AI web
-
application from the server’s
configuration, and un
-
registers the Dynamic AI components. The Dynamic
AI data files and any collections you might have created are kept intact.


Create configuration file

allows you to create or recreate the web
-
applic
ation
configuration file. This is appropriate if you are running setup from a
computer different from the Dynamic AI server.

Dynamic AI Professional Server setup & installation
17

of
38


Setup Options

Allow Data Caching

This option a
llow
s

the agent
to
pre
-
cache data sets. Data caching speeds up
the retrieval of data in some situations, but adds an element of r
isk, as cached
data are kept on the Dynamic AI server.

Allow Advanced Graphs

Determines if the ActiveX advanced graph object is installed. If this option is
not selected, advance graphs will not be available in Dynamic AI.

Include preview database

This opt
ion will ease the work of developers by providing a small, but very
fast subset of each data table for them to work on while designing content.


A small number of records are copied from the table or view worked on into
a Dynamic AI controlled data store (
the DNMCPREV.DAI file)


Allowing this has the benefit of fast access to a limited number of data rows,
making the design
-
time preview faster.


However, there is a small security issue connected with this, as intruders
could get hold of the preview table a
nd obtain the data subsets included
therein.


This screen is provided to
enter options for how
Dynamic AI operates. The
options are discussed
below.


Note that y
our screen might
not reflect all options, as
they are not relevant to all
Dynamic AI editions

18

of
38

Dynamic AI Professional Server setup & installation



Final Configuration


On this screen, choose the local
web server on which to setup
Dynamic AI. If Dynamic AI is
installed on a Windows 2000
Professional
, XP

or NT Workstation,
the “Default Web Site” is the only

choice available.


Enter the name of the web folder to
make Dynamic AI available on in the
“Web folder name” field provided.


When clicking “Finish”, the setup
program, will



Create all configuration files,



Register Dynamic AI components



Create the Web
application on
the chosen instance of Internet
Information Server



Place a shortcut to the Dynamic
AI server on the desktop.



Windows 2003 Server

Before using Dynamic AI on Windows 2003 server, you must ensure that
sufficient access privileges are set. Th
e users must have” modify”
permissions on the DAT folder under the Dynamic AI installation point.


On a default installation
, this is done by

giving the IUSR_machinename
account “modify“
-
access to the c:
\
dynamic
\
dat folder.


Refer to the Security section o
f Appendix A and the Permissions section of
Appendix B for more information

Test your installation

After completing the configuration utility, you can start Dynamic AI by using
the provided shortcut on the server desktop, or by entering the URL
http://localhost/dynamic/

in Internet Explorer on the server.


To access from other computers, enter the URL
http://
machinename
/dynamic/

from a browser (where machinename is the
n
ame of the Dynamic AI server computer).


Login information has been provided along with the License Certificate.

Dynamic AI Professional Server setup & installation
19

of
38



For more information on how to work with Dynamic AI, please consult the
Dynamic AI User Guide


Information on administrative and security aspe
cts of Dynamic AI can be
found in the Dynamic AI Administration handbook.

2
0

of
38

Dynamic AI Professional Server setup & installation



Manual Installation

In case using the automatic installation utility is not right for you, you can
perform most of the steps manually. It is recommended that you use the
automatic u
tility.


This requires a working knowledge of the Internet Service Manager


The following steps are required:


Component registration:

From the command line, issue the following commands:


regsvr32 c:
\
dynamic
\
COM
\
dnmcadm.dll

regsvr32 c:
\
dynamic
\
COM
\
dnmcai
.dll

regsvr32 c:
\
dynamic
\
COM
\
dnmcinit.dll

regsvr32 c:
\
dynamic
\
COM
\
dnmclogin.dll


Or

use the provided reg.bat file

Add the IIS virtual directory or virtual server



Browse to the local web server In the Internet Service Manager.



Right
-
click on the web serv
er and choose New | Virtual Directory



Type the name of the new directory (example: dynamic)



Click Next



Point to the INET directory in the Dynamic AI installation folder
(c:
\
dynamic
\
INET
\

is the default) and click Next



Leave the security settings as they ar
e and click Next



Right
-
click the newly created directory and choose properties



On the documents tab, enter “login.asp” as the default document

Copy backend data files

Navigate to the dynamic
\
dat folder, and make copies of all files beginning
with “emptydnm
c” removing the “empty”
-
part of the name.


This can also be done from the command prompt using the command


Copy

emtpydnmc*.dai dnmc*.dai

Dynamic AI Professional Server setup & installation
21

of
38


Generate the global.asa file

Use the automatic configuration utility to create the “global.asa” file.

Save the generat
ed file to the INET folder.


Test your installation

After completing the manual configuration, you can start Dynamic AI by
entering the URL
http://localhost/dynamic/

in Internet Explorer on the server.


To access
from other computers, enter the URL
http://
machinename
/dynamic/

from a browser (where machinename is the
name of the Dynamic AI server computer)


NOTE: If installing on Windows 2003 Server, there is an additiona
l step to
the installation. Please refer to the end of the Automatic Installation section


22

of
38

Dynamic AI Professional Server setup & installation



Upgrading

If you have a previous version of Dynamic AI running on the server, the
upgrade option will be available when running DAISetup.exe.

Upgrading will require

a short period of unavailability, since IIS needs to be
restarted in order to release the old
-
version components.


The upgrade procedure retains all of your previous settings, and upgrades
files, components and patches your dnmc.dai backend repository dat
a store.
Please backup your system before proceeding.


The upgrade is automatic, and only requires a few mouse clicks.


If for some reason you are unable to use the automatic upgrade function (if
you have a corrupt or non
-
standard installation), here are s
ome hints that will
be helpful.


Be aware that depending on which version you are upgrading from and to,
there might be changes in the Dynamic AI backend database.
Y
ou will need
to upgrade the existing Dynamic AI backend database to the structure the
new v
ersion requires.
The DAISetup.exe lets you upgrade your old .dai files.


Manual upgrade:

The steps required are:

Backup your existing installation

You will need the .dai files as well as any custom images etc.

Release components from IIS.

This can be don
e by either:

a.

Executing the IISRESET program

b.

Rebooting the server

c.

Executing the command “NET STOP IISADMIN” followed by the
“NET START W3SVC” command from the command prompt.

Un
-
registering the old version components

Run the unreg.bat file from the main Dy
namic AI folder (c:
\
dynamic
\
)


Dynamic AI Professional Server setup & installation
23

of
38


Overwriting old Dynamic AI files

Overwrite the old Dynamic AI version with the new files

Registering new version components

Run the reg.bat file from the main Dynamic AI folder (c:
\
dynamic
\
)

This will register the new compone
nts


Dynamic AI is now upgraded.


If you have already removed the old version components (the .dll files in the
COM folder, before un
-
registering them, there is a chance that you won’t be
able to successfully register the new components.


If possible, you
should obtain the dll files from the old version and replace
them into the COM folder, run the unreg.bat file and then replace the files
with the new version.


In case you have no way of obtaining the old version files, you will need to
manually remove reg
istration entries from the system registry, using the
regedit utility provided with the operating system.


Do not attempt to do that unless you are familiar with the windows registry.


Search for and remove references to the following files:



dnmcadm.dll



d
nmcai.dll



dnmcinit.dll



dnmclogin.dll


24

of
38

Dynamic AI Professional Server setup & installation



Selecting a backup
-
strategy for Dynamic AI


The most sensitive files in the Dynamic AI professional installation are the
“*.DAI” files located in the DAT directory under the main Dynamic AI
installation folder.


The
se files contain the Dynamic AI log, as well as data about users,
preferences and report definitions.


These files should be backed up often.


If you have a current backup of the files in the DAT folder, you will be able
to get your Dynamic AI server back
up and running by repeating the
installation and manually copying the DAT files to the new installation.


This can be time consuming, as installation of the operating system and
related components need to be installed. Depending on how critical your
instal
lation is, it is advisable to have a plan for recovering the entire server, in
case of a breakdown.

Dynamic AI Professional Server setup & installation
25

of
38


Un
-
install Dynamic AI

If you want to remove your Dynamic AI installation from the server, follow
these steps.





On the main setup screen, select
the Remo
ve Dynamic AI radio
button after filling in your Company
Name and license code.



Removes the Dynamic AI web
-
application from the server’s
configuration, and un
-
registers the
Dynamic AI components.



Manual Un
-
install

Un
-
installing Dynamic AI from the
server is best done using the Automatic
procedure described above.


Do not delete the files in the Dynamic AI folder, as there are components
registered. You will not be able to easily remove component registrations if
the components are missing. You can d
elete the files and folders later.

26

of
38

Dynamic AI Professional Server setup & installation




To manually un
-
install Dynamic AI, start by removing the web application
from Internet Information server.


Start the Internet Services Manager, and expand the web
-
server Dynamic AI
is installed on.


Right
-
click on the D
ynamic AI web folder, and select Delete. You will be
asked to confirm your choice.


Next you must un
-
register the Dynamic AI components.


This can be done either by executing the provided unreg.bat file from the
Dynamic AI directory or by issuing the follo
wing commands from the
command prompt:


regsvr32 /u c:
\
dynamic
\
COM
\
dnmcadm.dll

regsvr32 /u c:
\
dynamic
\
COM
\
dnmcai.dll

regsvr32 /u c:
\
dynamic
\
COM
\
dnmcinit.dll

regsvr32 /u c:
\
dynamic
\
COM
\
dnmclogin.dll


It is now safe to dispose of the files in the Dynamic
AI folder.

Dynamic AI Professional Server setup & installation
27

of
38


Options:



Select local web server: Chose the web server (often there are only one
web server available) where the Dynamic AI instance you want to
remove resides. The Drop down box “Web folder name” is
automatically populated with available web f
older names.




Select the appropriate “Web folder name” from the drop down box.




Unregister Components checkbox allows de
-
registration of Dynamic
AI components.




Remove web folder registration checkbox determines if the web folder
will be removed, meaning t
hat Internet Information Server will no
longer serve pages from that location.



When clicking finish, the Dynamic AI components are unregistered and the
web folder removed depending on the options checked.


This will not influence data; the Dynamic AI dat
a files and any collections
you might have created are kept intact.


If you want to totally remove, the Dynamic AI files, and loose your
collections etc, just remove the entire Dynamic AI directory from the server.


28

of
38

Dynamic AI Professional Server setup & installation



Appendix A: Troubleshooting installation

Typically a Dynamic AI professional installation works right away.
Especially if installed with the default parameters.


This chapter assumes that Dynamic AI is freshly installed on your server. If
you have had another installation of Dynamic AI installed

previously, refer to
the “Upgrading from a previous version” section below.


Elements contained in this chapter require

some knowledge of the NTFS file
system and related security as well as familiarity with the Internet Service
Manager tool used to admin
ister the web server.


Troubleshooting should start at the server itself.

There might be a problem for other computers to connect to the Dynamic AI
server, but these are often network related, and does not necessarily mean
that there is a problem on the D
ynamic AI server.


Therefore you should start by checking if Dynamic AI runs from the server it
is installed on.


The screenshots below may vary from the error messages you are getting.
This is because different versions of browsers display the errors in
different
ways.


The screenshots were made from an English language Windows NT
Workstation with service pack 6 and Internet Explorer 6.0 with “Show
friendly HTTP error messages” turned of (from the Advanced Tab in Internet
Options)

Problems with IIS (Inter
net server)

See Appendix A for more on IIS settings

Dynamic AI Professional Server setup & installation
29

of
38


Typical issues:

Error

Screen shot

Resolution

Cannot
find
server
message



It seems that the web server on
the computer does not respond.


TRY: the URL
http://localhos
t/

to
see if you get a response.

Make sure that IIS is installed
and running

If it is, make sure the web
service is started (from Internet
Services Manager)

404 Not
Found


This general error means that
the requested web document
could not be found on t
he server.

Assuming that you are accessing
the correct server, this indicates
that either the installation
program failed to register the
dynamic folder as a web folder,
or that you named the web folder
something else during
installation. This can be
corre
cted through the Internet
service manager.

Directory
listing
denied


This error occurs because there
is no default document
associated with the Dynamic AI
web folder.


Try the URL
http://localhost/dynami
c/login.asp

If this works, enable login.asp as
the default document for the
Dynamic AI web folder using the
Internet Service Manager


30

of
38

Dynamic AI Professional Server setup & installation



Problems with Security

Dynamic AI is constrained by the security set on the server it is installed on.


When the Dynamic

AI folder (typically c:
\
dynamic
\
) is created (during file
extraction), it inherits the NTFS security settings from the parent folder.


If NTFS settings on the server computer have been modified from the default
(made more restrictive), there is a chance D
ynamic AI can’t run properly.


In the default setup, the Dynamic AI server runs in the context of a local user
account (IUSR_
machinename
), which is created during IIS installation. It is
important that this user account has sufficient access rights to the
files in the
Dynamic AI folder.


See Appendix A for more on NTFS settings


Depending on which files are inaccessible, you will see different error
messages:


If you see a screen similar to this:

Then this might help:



In this case, the
IUSR_
Machinename
does not
have full access to the Dynamic
AI backend data files
(c:
\
dynamic
\
DAT
\
*.dai)


Please verify that either the
IUSR_
Machinename
account or
the account group
Everyone

has
read and write access to the files.

Dynamic AI Professional Server setup & installation
31

of
38




An error number
800a01ad

is a
general in
sufficient privileges
error.


This error is typically because the
IUSR_
Machinename
does not
have execute permission to the
Dynamic AI component files
(c:
\
dynamic
\
COM
\
*.dll)


Please verify that either the
IUSR_
Machinename
account or
the account group
Everyo
ne

has
execute permissions on these
files.


Problems with component registration

During automatic configuration, necessary .dll files are registered on the
server computer. These files are located in the COM folder under the
Dynamic AI installation direct
ory (typically c:
\
dynamic
\
com
\
)


This problem will typically show itself when Dynamic AI is requested the
first time. You will get a page similar to the below:



The 800401f3 Error is a
general component creation
error message.


It means that the server
c
annot find the requested
component, either because it
is missing or because it has
not been properly registered.


Typically registration of these components do not cause problems


however,
if a previous version of Dynamic AI has been installed, but not c
orrectly
removed, the older components might still be registered on the server,
causing problems with the newer components. If this might be the case, see
the section on Upgrading from a previous version.


32

of
38

Dynamic AI Professional Server setup & installation



If components have failed to register for whatever

reason, you can attempt a
manual re
-
registration:

First make sure none of the components are registered by un
-
registering all
components.


1.

Execute the unreg.bat file. This file is located in the main Dynamic
AI folder (c:
\
dynamic). You can do this severa
l times, if you have
previously attempted registration multiple times.

2.

Then execute the reg.bat file. This file is located in the main
Dynamic AI folder (c:
\
dynamic).

Other issues

Problem:

Graph Object keeps coming up with a message about being a trial ver
sion

Solution:

The Graph Object shipped with your version of Dynamic AI is not licensed.
This is intended if your Dynamic AI installation is a trial installation.


If your Dynamic AI license is a production license, please contact your
vendor for an updat
ed graph object.

Problem:

I’m getting an error message in the browser

Solution:

Go to
http://support.microsoft.com/

and enter the error number in the search
box.

This will help you determine whether the proble
m is associated with security
settings or a more general error. If this does not help, please contact your
vendor.

Dynamic AI Professional Server setup & installation
33

of
38


Appendix B: NTFS and IIS permissions

When working with web applications on IIS, it is important to understand the
mechanics of the security a
nd permissions involved.


The 2 main levels are IIS and the NTFS file system.


IIS has various methods of granting or denying access based on certificates,
IP
-
addresses etc, all of which are beyond the scope of this document,
however, there are 2 main auth
entication schemes that are worth discussing:


Anonymous Authentication

Non
-
anonymous authentication


With Anonymous Authentication, all users accessing the web
-
server gains
access without being authenticated. This is done by IIS assuming the
permissions o
f a special Internet Guest Account (called IUSR_
machinename
)
that is created when IIS is installed. When using Anonymous Authentication,
every users requesting pages of the web
-
server, will have access to the web
-
server corresponding to the permissions of
this user. This has the advantage
of easy administration, but requires the web application to maintain
its

own
level of security as all users have the same permission on the operating
system level. In Dynamic AI, individual user and group permissions are
h
andled by internal Dynamic AI security.


There are various forms of Non
-
anonymous authentication; (Basic, NTLM
etc.) When operating with any of these, IIS on the web server inherits the
permissions of the actual user. If the user has not yet been authentic
ated, IIS
attempts to authenticate the user before granting access, by prompting for NT
user ID and password. If authentication fails the user is denied access.


Integrated Windows Authentication is a variant of non
-
anonymous
authentication that allows the

credentials of a user currently logged in to a
windows computer to be passed safely without prompting the user.


An example of this is

IIS Server name: websrv1

IIS domain: COMP_DOM

User: user1

User domain: COMP_DOM

user1 has NTFS read permission on page1
.htm

IUSR_websrv1 has no permissions on page1.htm

user1 has No permission on page2.htm

IUSR_websrv1 has read permissions on page2.htm


With anonymous authentication, user requests information from websrv1,
and takes over the permissions of the local accou
nt IUSR_websrv1 on
34

of
38

Dynamic AI Professional Server setup & installation



websrv1. If the user requests page1.htm the request will be denied. A request
for page2.htm will be granted.


With windows integrated authentication, the user will gain access to
page1.htm but not to page2.htm.


Once through the IIS auth
entication, the user is known (IUSR_Machinename
or an authenticated Windows Account)


Now NTFS permissions are checked. If the current user (IUSR or the actual
user) has NTFS permissions for the requested file, access is granted.

Windows 2003 IIS Web Serv
ice Extensions

To use Dynamic AI on a Windows 2003 system, IIS must be set to allow the
“Active Server Pages“ Web Service Extension.



From Internet Information Services Manager, select “Web Service
Extensions”, then right
-
click on “Active Server Pages” a
nd select “Allow”

Dynamic AI Professional Server setup & installation
35

of
38


Dynamic AI security access requirements

By default a Dynamic AI installation will inherit the NTFS file system
security settings from the parent folder of the Dynamic AI directory. On a
Windows server installed with default settings and n
ot modified, this will
allow the group “
Everyone”

all NTFS access rights to the Dynamic AI
folder and underlying subfolders. (May depend on rights following the user
who installs Dynamic AI).


Having allowed Everyone NTFS access doesn’t mean that Dynamic A
I
default installation is open to “everyone” from the Dynamic AI IIS
application, please refer to the previous chapters. However in order to tighten
security Dynamic AI can be NTFS restricted for the IUSR_
Machinename
user account the following way (remove
the group everyone, add the group
admins for having administrative access to the C:
\
dynamic folder and
subfolders at file system level):


C:
\
dynamic
\
DAT and subfolder TMP
-
>
READ, WRITE access

for the
IUSR_
Machinename account


C:
\
dynamic
\
INET and subfolder
s (except TMP)
-
>
READ access
for the
IUSR_
Machinename account


C:
\
dynamic
\
INET
\
TMP
-
>
READ, WRITE access
for the
IUSR_
Machinename account


C:
\
dynamic
\
COM
-
>
READ access

for the IUSR_
Machinename account

36

of
38

Dynamic AI Professional Server setup & installation



Appendix C: Files installed by Dynamic AI



Directory
: Dynamic AI root: (c:
\
dynamic
\

is the default)

File

Description

COM

Directory

INET

Directory

DAT

Directory

Daisetup.exe

Configuration program

iis_start.bat

Batch file for starting Internet Information Services

iis_stop.bat

Batch file for stopping
Internet Information Services

unreg.bat

Batch file for un
-
registering components

reg.bat

Batch file for registering components



Directory: COM: (c:
\
dynamic
\
com is the default)

File

Description

DNMCAI.dll

DNMCLogin.dll

DNMCInit.dll

Main Dynamic AI com
ponents

DNMCADM.dll

Administration Component
-

Installed if “Allow
Administration” option was selected



Directory: INET: (c:
\
dynamic
\
inet is the default)

File

Description

DNMC.ASP

Main Dynamic AI page

Login.ASP

Main Dynamic AI page for login

DNMCADM
.ASP

Administration page. Installed if “Allow Administration”
option was selected

global.asa

Main Dynamic AI configuration file

DYNJS

Directory

Images

Directory

OBJECT

Directory

TMP

Directory
-

Exists if data caching is allowed



Directory: INET
\
DYN
JS: (c:
\
dynamic
\
inet
\
dynjs is the default)

File

Description

LE.js

PCE.js

SSC.js

SSCL.js

XCE.js

Client
-
side script files for Dynamic AI


Dynamic AI Professional Server setup & installation
37

of
38



Directory: INET
\
IMAGES: (c:
\
dynamic
\
inet
\
images is the default)

File

Description


Images used by Dynamic AI

0.gi
f

1.gif

2.gif

3.gif

4.gif

5.gif

6.gif

7.gif

8.gif

9.gif

ai.gif

aig.gif

aiw.gif

aiwg.gif

alert.gif

black.gif

borders.jpg

cfalse.jpg

cintac.gif

clear.gif

ctrue.jpg

daibig.gif

daibig.jpg

daihome.gif

daihome.jpg

daimed.jpg

default_coll.gif

default_zoom.gif

ema
il.gif

exitt.gif

export.gif

false.jpg

filler.gif

green.gif

happy.gif

I24.GIF

info.jpg

men.gif

plus.bmp

pro.gif

sea.gif

stylbgcolor.gif

stylbold.gif

stylcenter.gif

stylfgcolor.gif

stylleft.gif

stylright.gif

true.jpg



Directory: INET
\
OBJECT: (c:
\
dynamic
\
in
et
\
object is the default)

File

Description

teechart.cab

Charting Component

readme.txt

Information regarding Charting component licensing



Directory: DAT: (c:
\
dynamic
\
dat is the default)

File

Description

Dnmc.dai

Main Dynamic AI system database (used

unless enterprise
database is specified)

Dnmclog.dai

Main Dynamic AI system database (used unless enterprise
database is specified)

Dnmcprev.dai

Main Dynamic AI system preview database (used if
preview NORMAL is selected)

emptydnmclog.dai

Blank Dynamic

AI system database (used unless
enterprise database is specified)

emptydnmcprev.da
i

Blank Dynamic AI system preview database (used if
preview NORMAL is selected)

TMP

Directory
-

Exists if data caching is allowed

38

of
38

Dynamic AI Professional Server setup & installation











































Copyrights (C) 1998
-
2005

CINTAC A/S

All rights reserved