Installation of ADE
This chapter explains the system requirements for the Analytica Decision Engine (ADE) and describes how to install, upgrade, and uninstall ADE.
- Windows XP, Windows Server 2003, 2008, or 2012, Windows Vista, Windows 7, or Windows 8.
- 40 MB of hard drive space, plus whatever you need for your applications
- At least 2GB of RAM. More is better if your users will run multiple parallel applications.
- You also need a development language environment to build your application using ADE. This could be Visual Studio with VB.NET, C#, ASP.NET, VC++, or any other COM or .NETenabled development environment. You can also use ADE from Microsoft Office Visual Basic for Applications (VBA) or from Windows Scripting Host ('CScript.exe' or WScript.exe), as well as other COM-enabled or ActiveX automation-enabled packages.
You can download the ADE installer from [Lumina Downloads]. The installation contains the ADE in-process automation server (Adew.dll), the ADE local automation server (ADE.exe), auxiliary files needed by ADE, this ADE User Guide, and example programs.
Installing the Analytica Decision Engine Files
Installing from the Network
- Obtain an ADE activation key from Lumina. You normally get one via e-mail when you buy an ADE license or subscription.
- Download the ADE setup executable. The location of the file on the internet is provided when you receive your activation key. Save the file to disk.
- Run (i.e., double click) the file you just downloaded to begin the ADE installer. Make sure you are running it from an admin account.
- Follow the instructions. Read and agree to the license agreement, select a directory for the installation, and enter your activation key when prompted. The installer communicates with Lumina’s activation server to activate and download a license that is keyed to you computer.
The activation process stores a license in a file named ADE.lic. This license is keyed to the computer (the same ADE.lic won’t work on a different computer), but is valid for all users of the same computer, including special accounts used by your web server.
If activation fails as a result of the installer being unable to communicate with the activation server (either because your computer is not connected to the internet, or because your corporate firewall blocked the communication), you will need to manually activate the license. This involves these steps:
- Allow the installer to finish (leave the activation key blank).
- Find your computer’s host id as follows.
- Start > All Programs > Analytica Decision Engine > Configure License
- Find your host id at the bottom right corner of the dialog.
- Go to http://Lumina.com/support/activate-analytica
- Select ADE, Individual license, and fill in the remaining fields (make sure your host id is entered exactly, including any hyphens if any) and submit.
- On the thank you web page, find your license name. It will appear after “LICENSE lumina” and will look something like ade_123_45 (the numbers will differ).
- When you receive the email, save the attachment (ADE.lic) to the ADE install directory.
- Run ADE.exe
- In the dialog that appears, enter your license name from step5. Leave the RLM Server field blank.
- Test the installation by running AdeTest and pressing the New ADE.CAEngine button. If this succeeds without reporting a licensing error, you got it right.
Installed Manuals and Examples
The default installation directory, if you did not change it when running the installer, is
C:\Program Files\Lumina\ADE 4.6
Four example programs should also have been installed in that directory underneath the examples directory. They are as follows:
- Tutorial.NET — This program is referred to by the Analytica Decision Engine Tutorial. It is recommended that you read the Analytica Decision Engine Tutorial completely before writing your own programs that depend on ADE.
- AdeTest — This program allows you to call or test the methods of ADE objects through a GUI. You can run AdeTest.Exe (in the bin directory), or you can trace through the code in the Visual Studio.NET 2005 debugger to observe each method being called.
- asp_exam — This program shows you how to access ADE through a Microsoft ASP program.
- excel_exam — This program shows you how to access ADE from any application with Visual Basic for Applications (VBA) support, including the Microsoft Office suite of applications.
Entering a new license code
If you need to activate a different license you must run the ADE installer (or go through the manual activation process).
Upgrading from an earlier version of ADE
ADE 4.6 has been configured to install without disturbing previously installed versions of ADE. This allows you to compare the performance and output of your application under the different versions. However, it also means that your existing applications continue to use the previous version until you have changed them to use ADE 4.6
To uninstall ADE, select Add/Remove Programs in the Windows Control Panel. Scroll through the list to find “Analytica Decision Engine 4.6.” Click the Remove button and proceed through the uninstall wizard
|Introduction to ADE <-||Installation of ADE||-> The ADE Tutorial|