Deploymnent

Windows Desktop Applications

Apollo is VERY easy to deploy. The process involves copying several DLL files to either a sub-folder in Windows or simply include the DLLs with your EXE.

Apollo 9 can be deployed to work on 3 different types of Windows configurations:

64-bit Only (i.e. Apollo64)

Option 1: If you have 1 or 2 applications that use Apollo, then this is recommended:
copy C:\Apollo\[majorversion.minorversion]\x64\Engine\*.* to C:\YourApp\[with your EXE]

Option 2: If you have many applications that use Apollo, then this may be ideal:
copy C:\Apollo\[majorversion.minorversion]\x64\Engine\*.* to C:\Windows\System32

Note that Windows may require additional permissions to access to this folder. If you are not able to make this work, we suggest Option 1.

32-bit Only on 64-bit Windows (i.e. Apollo3264)

Option 1: If you have 1 or 2 applications that use Apollo, then this is recommended:
copy C:\Apollo\[majorversion.minorversion]\x86\Engine\*.* to C:\YourApp\[with your EXE]

Option 2: If you have many applications that use Apollo, then this may be ideal:
copy C:\Apollo\[majorversion.minorversion]\x86\Engine\*.* to C:\Windows\SysWOW64

Note that Windows may require additional permissions to access to this folder. If you are not able to make this work, we suggest Option 1.

32-bit Only on 32-bit Windows (i.e. Apollo32)

Option 1: If you have 1 or 2 applications that use Apollo, then this is recommended:
copy C:\Apollo\[majorversion.minorversion]\x86\Engine\*.* to C:\YourApp\[with your EXE]

Option 2: If you have many applications that use Apollo, then this may be ideal:
copy C:\Apollo\[majorversion.minorversion]\x86\Engine\*.* to C:\Windows\System32

Note that Windows may require additional permissions to access to this folder. If you are not able to make this work, we suggest Option 1.

.NET Deployment

In addition to copying the appropriate Apollo DLL files to the corresponding deployment folders, .NET developers must include the Apollo ADO.NET Provider DLL with their .NET applications. The Apollo ADO.NET Provider can be found here:

64-bit

C:\Apollo\[majorversion.minorversion]\x64\NET\Provider

32-bit

C:\Apollo\[majorversion.minorversion]\x86\NET\Provider

Windows Server/Web Applications

Deploying to IIS Web Server

Applies to:

  • Apollo ADO.NET Provider

This process reqires that you FTP the installed Apollo files from your desktop to your web server. This requires that you have some type of Remote Desktop access to your web server.

  1. You must have Apollo installed on your desktop computer
  2. Using your FTP program, create an "apollo" sub-folder in your website folder
    (e.g. C:\inetpub\wwwroot\mysite\apollo):
  3. FTP the following files to this apollo sub-folder on your web server:

    64-bit Windows Server with 64-bit .NET, upload as follows:

    1. C:\Apollo\[majorversion.minorversion]\x64\Engine\*.DLL to .\Apollo\Engine
    2. C:\Apollo\[majorversion.minorversion]\x64\NET\Provider\Apollo.Provider.DLL to .\Apollo\Provider

    64-bit Windows Server -or- 32-bit Windows Server with 32-bit .NET (SysWOW), upload:

    1. C:\Apollo\[majorversion.minorversion]\x86\Engine\*.DLL to .\Apollo\Engine
    2. C:\Apollo\[majorversion.minorversion]\x86\NET\Provider\Apollo.Provider.DLL to .\apollo

  4. Remote Desktop onto your web server if working remotely
  5. Copy Apollo engine files to the appropriate Windows folder:
    1. 64-bit Windows Server using 64-bit .NET, copy .\Apollo\Engine\*.* to C:\Windows\System32
    2. 64-bit Windows Server using 32-bit .NET, copy .\Apollo\Engine\*.* to C:\Windows\SysWOW64
    3. 32-bit Windows Server using 32-bit .NET, copy .\Apollo\Engine\*.* to C:\Windows\System32
  6. Make sure that your ASP.NET app refers to the Apollo Provider DLL located in .\apollo

*IMPORTANT* - Configuring IIS Web Server (Permissions and 0x8000FFFF errors)

Note: This section will resolve issues related to 0x8000FFFF errors

Apollo files should now be copied or installed to your IIS web server. The folder permissions need to be configured before Apollo can access the data files.

  1. Assuming you have the following directory structure:
    C:\inetpub\wwwroot\mysite -OR- C:\inetpub\wwwroot\MySite\bin    
    C:\inetpub\wwwroot\mysite\data
  2. Add the user EVERYONE with full permissions to the \mysite\data directory:
    1. Right click the "data" sub-folder where the DBF files are located
    2. select Properties
    3. select Security
    4. click Edit
    5. click Add
    6. enter "Everyone"
    7. click OK
    8. select Everyone and click "Full Control" checkbox
    9. click OK

Important Note: Your application should be configured/developed so that it looks for the data files in this \data folder. Simply creating the sub-folder does not change your application, you must explicitely develop your application(s) to access this \data subfolder.


Using Specific Components

Knowledge Base Articles

Support Ticket