Difference between revisions of "Installation of ADE"

(link to Installing ADE in a Docker image)
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[Category:ADE User Guide]]
 
[[Category:ADE User Guide]]
[[ADE User Guide|<< Back to ADE User Guide]]
+
{{ReleaseBar}}
 +
<languages />
 +
<translate>
 +
<!--T:1-->
 +
[[ADE User Guide]] >
  
 +
<!--T:2-->
 
This chapter explains the system requirements for the Analytica Decision Engine (ADE) and describes how to install, upgrade, and uninstall ADE.  
 
This chapter explains the system requirements for the Analytica Decision Engine (ADE) and describes how to install, upgrade, and uninstall ADE.  
  
==System Requirements==
+
==System Requirements== <!--T:3-->
  
 +
<!--T:4-->
 
*Windows XP, Windows Server 2003, 2008, or 2012, Windows Vista, Windows 7, or Windows 8.
 
*Windows XP, Windows Server 2003, 2008, or 2012, Windows Vista, Windows 7, or Windows 8.
*40 MB of hard drive space (you need more space to develop your applications)
+
*40 MB of hard drive space, plus whatever you need for your applications
*2GB of RAM.
+
*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 (<tt>'''CScript.exe''</tt>' or <tt>'''WScript.exe'''</tt>), as well as other COM-enabled or ActiveX automation-enabled packages.  
 
*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 (<tt>'''CScript.exe''</tt>' or <tt>'''WScript.exe'''</tt>), as well as other COM-enabled or ActiveX automation-enabled packages.  
  
You can obtain all the files for installation of ADE from the ADE CD-ROM or you can download the installer from [[http://www.lumina.com/ana/support/download.htm Lumina Downloads]] . The installation contains the ADE in-process automation server (<tt>'''Adew.dll'''</tt>), the ADE local automation server (<tt>'''ADE.exe'''</tt>), auxiliary files needed by ADE, this ''ADE User Guide'', and example programs
+
<!--T:5-->
 +
You can download the ADE installer from [[http://www.lumina.com/ana/support/download.htm Lumina Downloads]]. The installation contains the ADE in-process automation server (<tt>'''Adew.dll'''</tt>), the ADE local automation server (<tt>'''ADE.exe'''</tt>), auxiliary files needed by ADE, this ''ADE User Guide'', and example programs.
  
==Installing the Analytica Decision Engine Files==
+
==Installing the Analytica Decision Engine Files== <!--T:6-->
 
===Installing from the Network===
 
===Installing from the Network===
Obtain an ADE 4.6 activation key from Lumina. This is supplied to you, usually through e-mail, when you purchase ADE.  
+
# 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.  
  
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.  
+
The activation process stores a license in a file named <tt>'''ADE*.lic'''</tt>, where the * is completes the name of your own license. 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.
  
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.
+
===Manual Activation=== <!--T:11-->
 
+
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 <tt>'''ADE.lic'''</tt>. 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.
+
 
+
===Manual Activation===
+
 
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:
 
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:
  
 +
<!--T:12-->
 
#Allow the installer to finish (leave the activation key blank).
 
#Allow the installer to finish (leave the activation key blank).
 
#Find your computer’s host id as follows.
 
#Find your computer’s host id as follows.
Line 40: Line 45:
 
#Test the installation by running <tt>'''AdeTest'''</tt> and pressing the '''New ADE.CAEngine''' button. If this succeeds without reporting a licensing error, you got it right.
 
#Test the installation by running <tt>'''AdeTest'''</tt> and pressing the '''New ADE.CAEngine''' button. If this succeeds without reporting a licensing error, you got it right.
  
===Installed Manuals and Examples===
+
===Installed Manuals and Examples=== <!--T:13-->
 
The default installation directory, if you did not change it when running the installer, is
 
The default installation directory, if you did not change it when running the installer, is
  C:\Program Files\Lumina\ADE 4.6  
+
  <code>C:\Program Files\Lumina\ADE {{#svarget:anarelease|6.0}}</code>
  
Two ADE manuals are installed into a subdirectory called docs. These are:
+
<!--T:14-->
*ADE Reference.pdf (the equivalent of the [[ADE User Guide]])
+
*ADE Scripting.pdf
+
 
Four example programs should also have been installed in that directory underneath the examples directory. They are as follows:  
 
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.  
 
*'''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.  
Line 53: Line 56:
 
*'''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.
 
*'''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===
+
===Entering a new license code=== <!--T:15-->
 
If you need to activate a different license you must run the ADE installer (or go through the [[Installation of ADE#Manual Activation | manual activation]] process).
 
If you need to activate a different license you must run the ADE installer (or go through the [[Installation of ADE#Manual Activation | manual activation]] process).
  
===Upgrading from an earlier version of ADE===
+
===Upgrading from an earlier version of ADE=== <!--T:16-->
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
+
ADE {{#svarget:anarelease|5.4}} 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 {{#svarget:anarelease|6.0}}
 +
 
 +
===Uninstalling ADE=== <!--T:17-->
 +
To uninstall ADE, select '''Add/Remove Programs''' in the Windows Control Panel. Scroll through the list to find “Analytica Decision Engine {{#svarget:anarelease|5.4}}.” Click the Remove button and proceed through the uninstall wizard
  
===Uninstalling ADE===
+
==See Also== <!--T:18-->
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
+
  
==See Also==
+
* [[Installing ADE in a Docker image]]
  
 +
<!--T:19-->
 
{| style="margin: 1em auto 1em auto;width: 100%;border:0;table-layout: fixed;" cellpadding=5
 
{| style="margin: 1em auto 1em auto;width: 100%;border:0;table-layout: fixed;" cellpadding=5
|+ ADE User Guide Navigation
 
 
|- style="text-align: center"
 
|- style="text-align: center"
|  [[Introduction to Analytica Decision Engine]] << Previous ||  [[Installation of ADE]] || Next >> [[The Analytica Decision Engine Tutorial]]
+
|  [[Introduction to ADE]] <- ||  [[Installation of ADE]] || -> [[The ADE Tutorial]]
 
|}
 
|}
 +
</translate>

Latest revision as of 20:53, 10 March 2021



Release:

4.6  •  5.0  •  5.1  •  5.2  •  5.3  •  5.4  •  6.0


Other languages:
English • ‎中文 • ‎中文(中国大陆)‎

ADE User Guide >

This chapter explains the system requirements for the Analytica Decision Engine (ADE) and describes how to install, upgrade, and uninstall ADE.

System Requirements

  • 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

  1. Obtain an ADE activation key from Lumina. You normally get one via e-mail when you buy an ADE license or subscription.
  2. 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.
  3. 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.
  4. 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, where the * is completes the name of your own license. 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.

Manual Activation

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:

  1. Allow the installer to finish (leave the activation key blank).
  2. Find your computer’s host id as follows.
    1. Start > All Programs > Analytica Decision Engine > Configure License
    2. Find your host id at the bottom right corner of the dialog.
  3. Go to http://Lumina.com/support/activate-analytica
  4. 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.
  5. 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).
  6. When you receive the email, save the attachment (ADE.lic) to the ADE install directory.
  7. Run ADE.exe
  8. In the dialog that appears, enter your license name from step5. Leave the RLM Server field blank.
  9. 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 6.0 

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 6.0 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 6.0

Uninstalling ADE

To uninstall ADE, select Add/Remove Programs in the Windows Control Panel. Scroll through the list to find “Analytica Decision Engine 6.0.” Click the Remove button and proceed through the uninstall wizard

See Also

Introduction to ADE <- Installation of ADE -> The ADE Tutorial
Comments


You are not allowed to post comments.