Deploying Magic xpi Projects (Magic xpi 4.5)
When you are ready to deploy your projects, prepare the Server environment. To prepare the Server, you must:
-
Copy the project to the production environment: There are two options for doing this, as shown below:
-
Option 1: This is usually used for copying the project into the production environment for the first time:
-
-
Copy the project folder and all its content from the development environment to the production environment. It is important to keep the same project structure, or the project will not run correctly when deployed.
-
Modify the following project elements to fit the production environment settings (for example, license name, paths, and logical names):
-
-
The start.xml file
-
The ifs.ini file
-
The shortcuts' reference
-
If necessary, modify the Magic.ini file in the production environment to fit the Magic.ini file in the development environment (for example, license name, paths, and logical names, such as currentproject and DB_SERVER_NAME).
-
Option 2: This is usually used when the project already exists in the production environment, and you want to update it with changes that you made to the project while it was in the development environment:
-
If necessary, modify the Magic.ini file in the production environment to fit the Magic.ini file in the development environment (for example, license name, paths, and logical names).
|
Note:
|
-
It is recommended to turn off logging, since logging significantly slows down the execution of the program.
-
In all cases, parameters' names and values are case sensitive.
-
Because Unix, Linux, and IBM i operating systems are case sensitive, you should be careful when naming files or other components in your project. Otherwise, the project will not run correctly. If you only use lowercase letters when you name your files and other components, you can copy the contents of the projects folder directly into the Projects directory of the server without making any changes.
-
In the Magic.ini file, make sure that the Date Mode setting is set to the date mode used for expressions.
-
If you created a custom component in your development environment, you need to copy the resource_types.xml file from the <Magic xpi installation>\Runtime folder to the deployment environment. The resource_types.xml file supplied with the Magic xpi installation only includes Magic xpi's native components.
-
To prevent users from modifying the user-defined component by using the Connector Builder, send the users the connector's folder without the metadata.xml file.
|
-
Copy other files into the project directory: You should copy any other files that you created for use in your project. Make sure that they have the same name that you gave them and that they are in the same directory and or subdirectory as in the development environment.
-
Map external resources: Map all external resources, such as Java libraries or databases to the Magic xpi server in exactly the same way they are mapped to the development environment. For example, if you use a Java library called Java A on Computer A in the development environment, you must map the Magic xpi Server to Java A on Computer A. You must be sure to map to the same library or an exact copy in the same location. This is also true for databases or any other resources that reside on remote computers.
For information about deployment on a clustered environment, click here.
