Changes for page Installation

Last modified by Achraf El Kari on 2022/09/02 08:04
<
From version < 67.1
edited by Achraf El Kari
on 2022/09/02 08:04
To version < 30.3 >
edited by Outhman Moustaghfir
on 2022/07/08 11:41
Change comment: (Autosaved)

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.aelkari
1 +XWiki.omoustaghfir
Content
... ... @@ -11,7 +11,7 @@
11 11  
12 12  This current doc will guide you to install correctly iXPath and will give more details about each present configuration.
13 13  
14 -== Installation methods : ==
14 +=== Installation methods : ===
15 15  
16 16  The installation can be done in 2 ways :
17 17  
... ... @@ -31,7 +31,7 @@
31 31  
32 32  = I - First Installation (Première installation) =
33 33  
34 -== A) Online Installation ==
34 +=== 1) Online Installation ===
35 35  
36 36  The online installation uses remote resources, which makes the internet connection mandatory.
37 37  
... ... @@ -73,7 +73,7 @@
73 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.
74 74  
75 75  
76 -== B) Offline installation ==
76 +=== 2) Offline installation ===
77 77  
78 78  As mentioned before, the offline installation does not require an internet network.
79 79  
... ... @@ -109,24 +109,18 @@
109 109  
110 110  [[image:2022-07-07_17h21_37.png||height="414" width="547"]]
111 111  
112 -In the COM server, the service "ixpathCom.jar" can run solo or with the rabbitMQ. for accessibility reasons (Firewall...), we can install the web server inside the com server (Apache, PHP, and iXPath web).
113 -
114 -in the engine server, the service "ixpath.jar" can run solo, we should specify in his configuration all those information: COM IP address, BDD IP address, broker IP address, and port.
115 -
116 -See **chapter VI**, for more details about the remote installation.
117 -
118 118  = III - Update =
119 119  
120 -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 remote resources.
114 +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.
121 121  
122 -= IV - Configurations & Monitoring =
116 += IV - Configurations & Services =
123 123  
124 124  there are configuration files that help to maintain all needed parameters for the functioning of iXPath.
125 125  
126 -* config.properties: configuration of the Engine. here we can configure ports, directories, hosts ... it's located in **/SERVER/engine/config.properties **path
127 -* config.ini: Configuration of "Portail". here we configure all parameters to connect Engine to Portail. it's located in **./SERVER/wwwroot/config/config.ini **path
120 +* config.properties: configuration of the Engine. here we can configure ports, directories, hosts ...
121 +* config.ini: Configuration of "Portail". here we configure all parameters to connect Engine to Portail.
128 128  
129 -== A) Ports ==
123 +=== 1) Ports ===
130 130  
131 131  * As mentioned before, iXPath takes 8090 (Engine) and 8091 (COM) automatically as ports.
132 132  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. 
... ... @@ -134,9 +134,8 @@
134 134  [[image:1657208183258-245.png||height="48" width="712"]]
135 135  \\and make the changes on **./SERVER/engine/config.properties :** 
136 136  \\[[image:1657208426432-822.png||height="349" width="478"]]
137 -\\and same for  **./SERVER/wwwroot/config/config.ini ** : 
131 +\\and same for  **./SERVER/wwwroot/ ** : 
138 138  [[image:1657208646920-357.png||height="146" width="543"]]
139 -\\NB: 'Rest' refers to Engine service, and 'COM' refers to COM service 
140 140  
141 141  * the Engine also uses ports 22920 and 22921 for FTP and FTPS respectively** **
142 142  [[image:2022-07-07_17h03_53.png||height="337" width="501"]]
... ... @@ -154,7 +154,7 @@
154 154  [[image:2022-07-07_17h45_14.png||height="163" width="724"]]
155 155  
156 156  
157 -== B) Services ==
150 +=== 2) services ===
158 158  
159 159  * To maintain services on your operating system, go to the search bar and type "services.msc" :
160 160  
... ... @@ -166,147 +166,12 @@
166 166  
167 167  [[image:2022-07-08_10h30_20.png||height="16" width="654"]]
168 168  
169 -here you can start, restart, pause, or stop the service target by right-clicking on it and choosing the option needed after accessing its properties:
162 +here you can start, restart or stop the service target by right-clicking on it and choosing the option needed :
170 170  
171 -[[image:manage-startup-type.png]] [[image:startup-type.png]]
164 +[[image:wyQuu5TvEPzRyr6wh3fXmJ-970-80.jpg]]
172 172  
173 -
174 -
175 175  {{{NB: all services must be running to run the iXPath app correctly.
176 176  }}}
177 177  
178 -* if the Apache service cannot be on running status because of the unavailability of port 80, please follow these steps :
179 -** open a command line and type :  **netstat -aon | findstr :80**
180 -[[image:1657273380453-615.png||height="308" width="512"]]
181 -
182 -** Next, you type the command: **tasklist /fi  "pid eq 4" **
183 -[[image:1657273433854-228.png||height="202" width="513"]]
184 -** stop and disable the following services :
185 -*** **world wide web publishing service (W3SVC)**
186 -*** **windows activation service (WAS)**
187 -*** **SQL Server Reporting Services (ReportServer)**
188 -*** **BranchCache (PeerDistSvc)**
189 -*** **Network Connection Broker (NcbService) **
190 -** start apache service  
191 -[[image:1657275791598-755.png||height="233" width="356"]]
192 -
193 -== C) Logs ==
194 -
195 -There are some log files to help you figure out what causes the dysfunctioning of the iXPath app, and here are all of them :
196 -
197 -|(% rowspan="8" %)(((
198 -(% class="wikigeneratedid" id="HCOM" %)
199 -//**COM**//
200 -)))|(% rowspan="2" %)(((
201 -(% class="wikigeneratedid" id="HPORTAL" %)
202 -//**PORTAL**//
203 -)))|iXPath Front Php:|.\SERVER\wwwroot\Logs
204 -|Portal Log:|.\SERVER\wwwroot\Logs
205 -|(% rowspan="6" %)(((
206 -(% class="wikigeneratedid" id="HCOM-1" %)
207 -//**COM**//
208 -)))
209 -|(% colspan="1" rowspan="2" %)Communication Protocol
210 -|.\SERVER\Data\config\COM
211 -|Communication Protocol (AS2) Log (Example)|.\SERVER\Data\config\COM\AS2\LOGS
212 -|(% colspan="1" rowspan="2" %)LogCom
213 -|.\SERVER\Engine\ (logRESTCOM.log)
214 -|(% rowspan="4" %)(((
215 -(% class="wikigeneratedid" id="HENGINE" %)
216 -//**ENGINE**//
217 -)))|(% rowspan="3" %)(((
218 -(% class="wikigeneratedid" id="HENGINE2019sLog" %)
219 -//**ENGINE’s Log**//
220 -)))|Source:|.\SERVER\Engine\ixpath.jar
221 -|LogRest:|.\SERVER\Data\LOGS\REST (logREST.log)
222 -|LogApp:|.\SERVER\Engine\ (ixpath.log ou ixpathErr.log)
223 -|(((
224 -(% class="wikigeneratedid" id="HProcessLOGS" %)
225 -//**Process LOGS**//
226 -)))|Process LOGS|.\SERVER\Data\LOGS\ENGINE
227 -|(((
228 -(% class="wikigeneratedid" id="HBDD" %)
229 -//**BDD**//
230 -)))|(((
231 -(% class="wikigeneratedid" id="HDataBase" %)
232 -//**DataBase**//
233 -)))|Query Log|.\SERVER\mysql\logs
234 -
235 -= V - FAQ =
236 -
237 -* During the installation, it might happen that the directory already exists, and that will block it.
238 -[[image:1657290152857-725.png||height="361" width="606"]]
239 -you should take action by following these steps below :
240 -** make a backup for the directory '**SERVER'.**
241 -** delete the directory '**SERVER'**
242 -** relaunch the installation.
243 -* if you can't start RabbitMQ service, 
244 -[[image:1657290453989-461.png||height="99" width="560"]]
245 -add new environment variable named RABBITMQ_SERVER with the RabbitMQ installation Path  :
246 -[[image:1657290504230-487.png||height="159" width="554"]]
247 -\\RABBITMQ_SERVER : C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.1C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.1
248 -\\And now restart the RabbiMQ service. 
249 -[[image:1657290585573-818.png||height="66" width="585"]]
250 -
251 -* (((
252 -= VI - Remote installation =
253 -
254 -In case you want to install each service on its own server, you only need to specify all these details inside the configuration files (config.ini & config.properties (COM and Engine))
255 -Eg: We need to implement this kind of installation.
256 -
257 -(((
258 -(% style="width:365px" %)
259 -|(% style="width:200px" %)**Service**|(% style="width:160px" %)**Host**
260 -|(% style="width:200px" %)COM|(% style="width:160px" %)10.0.0.1
261 -|(% style="width:200px" %)Engine|(% style="width:160px" %)10.0.0.2
262 -|(% style="width:200px" %)MySQL|(% style="width:160px" %)10.0.0.3
263 -|(% style="width:200px" %)RabbitMQ|(% style="width:160px" %)10.0.0.4
264 -|(% style="width:200px" %)Portal|(% style="width:160px" %)10.0.0.5
265 -
266 -That can be designed as architecture below :
267 -[[image:1662053701761-722.png]]
268 -
269 -**1 - Installation**
270 -On each server, install the service in question : 
271 -We start with the database
272 -[[image:2022-09-01_17h53_14.png||height="253" width="394"]]
273 -\\then the broker RabbitMQ: 
274 -[[image:2022-09-01_17h53_37.png||height="308" width="480"]]
275 -\\next, for each COM and Engine services, we do the same installation, it will install for both servers, and you disable the undesired service.
276 -\\[[image:2022-09-01_17h54_18.png||height="294" width="459"]]
277 -\\for example, if we're installing COM in 10.0.0.1, we disable the engine service 
278 -[[image:2022-07-08_10h29_02.png]]
279 -(Same for Engine)
280 -
281 -Finally, install the portal in 10.0.0.5
282 -[[image:2022-09-01_18h36_21.png||height="284" width="443"]]
283 -**2 - The next step will concern the configuration**
284 - __//On 10.0.0.1 (COM server)//__
285 - Inside config.properties, identify all hosts that COM can communicate with.
286 -[[image:2022-09-01_18h16_32.png||height="241" width="321"]]
287 -
288 -[[image:2022-09-01_18h17_14.png||height="50" width="463"]]
289 -\\ __//On 10.0.0.2 (Engine server)//__
290 -we make the same modifications, and we identify the COM host 
291 -[[image:2022-09-01_18h21_18.png||height="277" width="304"]]
292 -
293 - __//On 10.0.0.5 (Portal server)//__
294 -
295 -Set the config.ini file.
296 -[[image:2022-09-01_19h05_22.png||height="90" width="457"]]
297 -
298 -== **Note : ** ==
299 -
300 -We can install iXPath in just two or 3 servers, the combination of services that we recommend :
301 -
302 -- COM with the rabbitMQ and Portal
303 -
304 -- Engine
305 -
306 -- BDD
307 -
308 -
309 -
310 -
311 -)))
312 -)))
169 +* if the Apache service cannot be on running status, please follow these steps :
170 +** open a command line
1657273380453-615.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -286.0 KB
Content
1657273433854-228.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -110.1 KB
Content
1657275149853-325.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -215.2 KB
Content
1657275791598-755.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -175.4 KB
Content
1657290152857-725.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -221.7 KB
Content
1657290453989-461.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -93.2 KB
Content
1657290504230-487.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -53.7 KB
Content
1657290585573-818.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -57.0 KB
Content
1662050326672-140.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -73.6 KB
Content
1662050353963-994.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -80.7 KB
Content
1662050581994-703.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -80.7 KB
Content
1662050623172-491.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -72.4 KB
Content
1662053701761-722.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -76.1 KB
Content
2022-09-01_17h53_14.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -308.7 KB
Content
2022-09-01_17h53_37.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -308.2 KB
Content
2022-09-01_17h54_18.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -315.1 KB
Content
2022-09-01_18h16_32.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -16.7 KB
Content
2022-09-01_18h17_14.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -16.3 KB
Content
2022-09-01_18h21_18.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -18.9 KB
Content
2022-09-01_18h36_21.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -307.1 KB
Content
2022-09-01_19h05_22.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -10.2 KB
Content
manage-startup-type.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -9.1 KB
Content
startup-type.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.omoustaghfir
Size
... ... @@ -1,1 +1,0 @@
1 -9.3 KB
Content
This wiki is hosted and managed by iXPath
Powered by XWiki 13.3 debian