Running the Application on Another Computer (Magic xpa 3.x)

Running the application on the same computer that you developed the project, can be misleading.

The Runtime engine and the Studio engine share the same environment and the same configuration.

Therefore, you can create a cabinet file (.ecf) and execute the same project using the Runtime engine.

When running the application on another computer, all of the settings and configurations that you set during the development stage should be set now on the other computer.

The settings include the database connection definitions, logical names, the project's font file, the project's color file, and additional settings that you set during the project development. Some of these settings are saved in the Magic.ini file, which is an integral part of Magic xpa and some of these settings are external files that should be copied to a specific directory.

When you are about to install an application for deployment on another computer, you need to perform the following on the other computer:

1. Install the Magic xpa Runtime.

2. Paste the application file and all of its related files (such as the images directory) in the appropriate directory. Sometimes there are data sources that are part of the application (not user data). The content of these data sources should be loaded to the new database as part of the application deployment.

3. Set up the database in the Database repository on the new computer.

4. If you used logical names, they should be copied to the new computer.

5. Open the Magic.ini file using a text editor, such as Notepad. From the Magici.ini file, copy the Logical Name entries from the source computer to the destination computer. Make sure to change the translation section according to the new computer's directory locations.

6. If the Magic xpa Runtime is installed on a server, you need to make sure of the following:

• There is Read access to the directory where the Runtime resides.

• If the environment does not support the Universal Naming Convention (UNC) system, make sure that every workstation has the same drive/directory mapping to the Runtime directory.

• The shortcut to the MgxpaRuntime.exe file's Start in field points to the same directory where the Runtime resides.

• The Magic.ini file's [MAGIC_GATEWAYS] section should not have hard-coded paths to the directory where Magic xpa is installed.
  For example, change MGDB09=C:\Program Files (x86)\MSE\Magic xpa 2.5\Gateways\mgSQLite.dll to MGDB09= Gateways\mgSQLite.dll.

7. It is recommended to turn off logging, since logging significantly slows down the execution of the program.

8. Launch the Magic xpa Runtime and go to Options > Settings > Environment > System tab > Start application setting.

9. Zoom from this setting and select the application's .ecf file. This is application that will opened immediately when the Magic xpa Runtime is launched.