Wiki source code of Installation

Version 23.4 by Outhman Moustaghfir on 2022/07/07 18:29
Hide last authors
Outhman Moustaghfir 16.2 1 (% class="box successmessage" %)
2 (((
3 Contents :
Outhman Moustaghfir 1.1 4
Outhman Moustaghfir 15.2 5 {{toc/}}
6
Outhman Moustaghfir 16.2 7
8 )))
9
10 = Introduction =
11
Outhman Moustaghfir 23.2 12 This current doc will guide you to install correctly iXPath and will give more details about each present configuration.
Outhman Moustaghfir 1.1 13
14 === Installation methods : ===
15
Outhman Moustaghfir 1.3 16 The installation can be done in 2 ways :
Outhman Moustaghfir 1.1 17
Outhman Moustaghfir 1.3 18 1. Online Installation: this installation requires downloading some resources online, so it's necessary to have an internet network, then complete the installation.
19 1. Offline Installation: this installation requires the existence of resources on a hard disk or any sources of storage (CD / USB ...), and does not require an internet network.
20
21 |(% style="width:205px" %) |(% style="width:843px" %)Installation elements
22 |(% style="width:205px" %)**Online**|(% style="width:843px" %)(((
23 * jar executable: ixpath.exe
24 * directory bin, that must be next to the jar executable.
25 )))
26 |(% style="width:205px" %)**Offline**|(% style="width:843px" %)(((
27 * jar executable: ixpath.exe
28 * directory bin, that must be next to the jar executable.
29 * the "Install.zip" archive which contains all necessary resources for the installation.
30 )))
31
Outhman Moustaghfir 20.2 32 = I - First Installation (Première installation) =
Outhman Moustaghfir 1.7 33
Outhman Moustaghfir 20.2 34 === 1) Online Installation ===
Outhman Moustaghfir 1.3 35
Outhman Moustaghfir 2.3 36 The online installation uses remote resources, which makes the internet connection mandatory.
Outhman Moustaghfir 2.2 37
Outhman Moustaghfir 2.3 38
Outhman Moustaghfir 2.2 39 [[image:1657192466936-778.png||height="491" width="796"]]
Outhman Moustaghfir 3.2 40
41 if no window displays, please make sure of the existence of the "bin" directory, that contains the java virtual machine to launch the iXPath installation.
42
43 Click on "Pemière installation", and it redirects you to the window below, which gives you the components needed to be installed.
44
45 [[image:1657197821929-405.png||height="441" width="693"]]
46
47 Installation components :
48
Outhman Moustaghfir 4.2 49 * Portail: frontend code of iXPath
50 * Moteur (Engine): backend package of iXPath code source. it will install two services: COM (running on port 8091) and Engine (running on port 8090), so please make sure to free these ports, or you can change both of them in the configuration that will be explained later in this document.
51 * Base de données: Script to install the database with all the newest updates.
52 * MySQL: Relational database management system installation.
53 * WebServer (Apache & PHP): Apache server and PHP installation for both "Moteur" and "Portail"
54 * RabbitMQ & Erlang.
Outhman Moustaghfir 3.2 55
Outhman Moustaghfir 6.2 56 if you already have the RabbitMQ component installed, uncheck it.
Outhman Moustaghfir 3.2 57
Outhman Moustaghfir 6.2 58 the installation begins with the broker RabbitMQ, and it uses Erlang OTP which is mandatory for its functioning.
59
60 uncheck "Erlang Documentation" as shown below : 
61
62 [[image:1657203367108-301.png||height="440" width="566"]]
63
64 After that, it comes the installation of RabbitMQ :
65
66 [[image:1657203596434-660.png||height="410" width="528"]]
67
Outhman Moustaghfir 7.2 68 Next, continue the installation of RabbitMQ, followed by the installation of the "Moteur"/Engine.
Outhman Moustaghfir 6.2 69
70
Outhman Moustaghfir 7.2 71 [[image:1657203808711-492.png||height="334" width="561"]]
Outhman Moustaghfir 6.2 72
Outhman Moustaghfir 14.2 73 **Congrats !!! **you have installed iXPath successfully, and you can log in to the app on the "http:~/~/localhost" URL and use "admin" as user and "admin" as password.
Outhman Moustaghfir 6.2 74
75
Outhman Moustaghfir 20.2 76 === 2) Offline installation ===
Outhman Moustaghfir 7.2 77
Outhman Moustaghfir 7.3 78 As mentioned before, the offline installation does not require an internet network.
Outhman Moustaghfir 7.2 79
Outhman Moustaghfir 10.2 80 Click on the executable "ixpath.exe"
Outhman Moustaghfir 7.2 81
Outhman Moustaghfir 10.2 82 [[image:1657205308850-727.png||height="375" width="608"]]
Outhman Moustaghfir 7.3 83
84
Outhman Moustaghfir 11.2 85 Then click on "Première installation", and will pop up this window indicating that no internet connection has been detected:
Outhman Moustaghfir 10.2 86
87 [[image:1657205397383-147.png||height="112" width="445"]]
88
Outhman Moustaghfir 11.2 89 Click on "Oui"/yes.
90
91 if the "Install.zip" does not exist in the same directory as "Ixpath.exe", mention the directory where it belongs:
92
93 [[image:1657205582948-948.png||height="112" width="540"]]
Outhman Moustaghfir 12.2 94
Outhman Moustaghfir 12.3 95 Eg: if the path is **"C:/InstallationIxpath/Install.zip"**, you will fill in the field with **"C:/InstallationIxpath/". **And the Installation begins...
Outhman Moustaghfir 12.2 96
97 [[image:1657205737602-896.png||height="344" width="578"]]
98
Outhman Moustaghfir 12.3 99 Accept the 3 Windows authorizations that will pop up during the installation. they are related to 3 components: "Database", "WebServer" and "Engine".
Outhman Moustaghfir 12.2 100
101
Outhman Moustaghfir 14.2 102 [[image:1657206588463-690.png||height="339" width="570"]]
103
104 **Congrats !!! **you have installed iXPath successfully, and you can log in to the app on the "http:~/~/localhost" URL and use "admin" as user and "admin" as password.
105
Outhman Moustaghfir 23.2 106 (% class="wikigeneratedid" %)
107 = II - Architecture of iXPath : =
Outhman Moustaghfir 17.1 108
Outhman Moustaghfir 23.2 109 here is a brief presentation of the roles of each component in the iXPath app.
110
111 [[image:2022-07-07_17h21_37.png||height="414" width="547"]]
112
113 = III - Update =
114
Outhman Moustaghfir 20.2 115 Updating the iXPath app or just some components g__oes exactly the same as the online installation__, which makes the internet network necessary to fetch any updates from the remote resources.
Outhman Moustaghfir 17.1 116
Outhman Moustaghfir 23.2 117 = IV - Configurations & Services =
Outhman Moustaghfir 17.1 118
Outhman Moustaghfir 20.2 119 there are configuration files that help to maintain all needed parameters for the functioning of iXPath.
120
Outhman Moustaghfir 20.3 121 * config.properties: configuration of the Engine. here we can configure ports, directories, hosts ...
Outhman Moustaghfir 22.2 122 * config.ini: Configuration of "Portail". here we configure all parameters to connect Engine to Portail.
Outhman Moustaghfir 20.2 123
124 === 1) Ports ===
125
126 * As mentioned before, iXPath takes 8090 (Engine) and 8091 (COM) automatically as ports.
127 if in any case, you want to change them, go to **./SERVER/engine/ixEngine.cmd **script and change them to wanted ports, then execute the script on administrator mode. 
128 For example, we want to change the Engine port to 9090 and the COM port to 9091 
129 [[image:1657208183258-245.png||height="48" width="712"]]
130 \\and make the changes on **./SERVER/engine/config.properties :** 
131 \\[[image:1657208426432-822.png||height="349" width="478"]]
132 \\and same for  **./SERVER/wwwroot/ ** : 
133 [[image:1657208646920-357.png||height="146" width="543"]]
Outhman Moustaghfir 17.1 134
Outhman Moustaghfir 22.2 135 * the Engine also uses ports 22920 and 22921 for FTP and FTPS respectively, and it can be changed in **./SERVER/engine/config.properties **
136 [[image:2022-07-07_17h03_53.png||height="337" width="501"]]
137
138 * SFTP port : 
139 [[image:2022-07-07_17h09_58.png||height="124" width="425"]]
140 \\
Outhman Moustaghfir 20.2 141
142
This wiki is hosted and managed by iXPath
Powered by XWiki 13.3 debian