Wiki source code of Install Local Connector

Last modified by Erik Bakker on 2024/02/22 12:20
Show last authors
1 {{container}}
2 {{container layoutStyle="columns"}}
3 (((
4 In this microlearning, we will focus on installing the eMagiz environment locally
5 Should you have any questions, please contact academy@emagiz.com.
6
7 == 1. Prerequisites ==
8
9 To install a runtime, please be aware that eMagiz needs an environment that satisfies certain requirements. These requirements can be different depending on your architectural choices. Most common is the connector inside your network and a JMS and container running outside the network. In that case, if you are running only connectors in this environment, please keep the following requirements in mind:
10
11 * OS with support for Java
12 * OS user with granted security rights to run startup services (Windows services)
13 * The correct Java installation ([[Java 8 SE JRE>>https://adoptopenjdk.net||target="blank"]] for example) with NO automatic updates. OpenJDK 8 is currently the recommended version for eMagiz installations.
14 * NTP synchronization – all eMagiz service instances should use the same time and settings.
15 * Access to the internet
16 * Outbound JMS traffic - port 8443 (and 8444 in case of failover situation) - amqp.emagiz.com / cloudXXXX.emagizcloud.com
17 ** General monitoring data to eMagiz iPaaS
18 ** Specific JMS traffic to eMagiz JMS Server
19 * Outbound HTTPS traffic
20 ** port 443
21 ** Specific provisioning data
22 *** [[RTS>>https://rts.emagiz.com/ws/||target="blank"]]
23 *** [[eMagiz repository>>https://repository.emagiz.com||target="blank"]]
24 * Hardware requirements
25 ** Modern CPU
26 ** Enough Disk Space according to sizing calculations
27 * Enough Memory according to sizing calculations
28 * JAVA_HOME variable is properly set
29
30 == 2. Key concepts ==
31
32 eMagiz uses a runtime component as a container where flow components can be deployed in. There are infrastructure components that act as flows, and there are functional flow components. Furthermore, there are routing and error flows. By deploying these runtimes across various locations across the integration architecture, you can make these flows work as a chain to realize a complete integration. In the platform training, you need to use the JMS runtime and container runtime and make this run on your local machine.
33
34 == 3. Run eMagiz on a local laptop ==
35
36 === 3.1 Run eMagiz on a local laptop ===
37
38 Download the eMagiz runtime of your connector, JMS, or container via the eMagiz Deploy phase in the Containers tab on the server where it needs to be installed. Please note the environment you want the runtime of. If you download the runtime of the wrong environment you will send to or receive data from the wrong environment. For example, you want to test a flow but by downloading the runtime from the incorrect environment you end up sending data to the Production environment. In the case below, we see that we are downloading a connector runtime ordsys for the Test environment.
39
40 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-deploy-install-local-connector--download-runtime.png]]
41
42 === 3.2 Unzip the runtime ===
43
44 Now that we have downloaded the zip it is time to unzip your download package into a directory that is not too deep into the directory structure.
45 A directory structure that is too deep will cause issues when extracting the runtime.
46 You could for example use: C://eMagiz/test but it is best to not use: C://Programs/eMagiz/test/connector/appeee/installation
47
48 After you have unpackaged the zip you need to open the folder to access its contents.
49
50 === 3.3 Run the runtime ===
51
52 In the Bin folder, you can validate if the service can make a connection via karaf.bat. To check the connection of the service, use the right mouse button then execute the file as Administrator. Please make sure that before you try this you verify that your JMS is running.
53
54 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-deploy-install-local-connector--run-karaf-as-admin.png]]
55
56 A screen will pop up and will show you the following.
57
58 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-deploy-install-local-connector--karaf-pop-up.png]]
59
60 Use the command ‘log:tail’ to see the full log. You will see the full stack trace. If the installation is successful, you should see something like this as a result:
61
62 org.eclipse.gemini.blueprint.extender - 2.1.0.RELEASE | Application context successfully refreshed ApplicationContext(bundle=nl.capesystemsintegration.demo.bus.commupd.ordsys.connector-infra.spring, config=nl.capesystemsintegration.demo.bus.commupd.ordsys.connector-infra.spring_1.0.0.52.xml))
63
64 If you see the expected logging, verify in eMagiz if:
65
66 * You can reach the runtime via the runtime dashboard.
67 * You see runtime statistics in Manage.
68
69 {{warning}}
70 If you see an error or the popup closes itself immediately, please check the above steps and requirements. If the popup closes this is probably due to a mismatch between the Java version and runtime version. Please look back at the section explaining how to set JAVA_HOME for more information. If all the above steps are correct and you are not able to identify the issue, please contact your implementation partner.
71 {{/warning}}
72
73 == 4. Key takeaways ==
74
75 * eMagiz has a runtime software component that allows running flows inside. It is generic for all types of flows that exist in eMagiz
76 * Using the JMS and the Container runtimes created by the eMagiz Portal, you can test your work properly during the microlearning training sessions
77 * Above instructions are also valid for making the installation on a server where a runtime needs to be deployed locally.
78
79 == 5. Suggested additional readings ==
80
81 If you are interested in this topic and want more information on it you can read the following microlearnings:
82
83 * [[Release information>>Main.Release Information.Runtime.WebHome||target="blank"]]
84 * [[Runtime Security>>Main.eMagiz Academy.Microlearnings.Intermediate Level.Portal Security.intermediate-portal-security-runtime-security||target="blank"]]
85 * [[Edit Runtime Memory Windows>>Main.eMagiz Academy.Microlearnings.Intermediate Level.Solution Architecture.intermediate-solution-architecture-edit-memory-on-premise-runtime-windows||target="blank"]]
86 * [[Architecture runtime decisions>>Main.eMagiz Academy.Microlearnings.Advanced Level.Solution Architecture.advanced-solution-architecture-runtime-decision.WebHome||target="blank"]]
87 * [[Edit Runtime Memory Linux>>Main.eMagiz Academy.Microlearnings.Legacy Functionality.advanced-solution-architecture-change-memory-runtime-linux.WebHome||target="blank"]]
88 * [[Install runtime on Linux>>Main.eMagiz Academy.Microlearnings.Expert Level.Solution Architecture.expert-platform-deploy-install-local-connector-linux||target="blank"]]
89 * [[Install runtime on Windows>>Main.eMagiz Academy.Microlearnings.Expert Level.Solution Architecture.expert-platform-deploy-install-local-connector-windows||target="blank"]]
90 )))
91
92 (((
93 {{toc/}}
94 )))
95 {{/container}}
96 {{/container}}