Changes for page Installation

Last modified by Achraf El Kari on 2022/09/02 08:04
<
From version < 34.1 >
edited by Outhman Moustaghfir
on 2022/07/08 12:15
To version < 66.2 >
edited by Achraf El Kari
on 2022/09/02 07:57
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.omoustaghfir
1 +XWiki.aelkari
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 -=== 1) Online Installation ===
34 +== A) 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 -=== 2) Offline installation ===
76 +== B) Offline installation ==
77 77  
78 78  As mentioned before, the offline installation does not require an internet network.
79 79  
... ... @@ -109,18 +109,24 @@
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 Adress, broker IP address and port.
115 +
116 +See **chapter IV**, for more details about the remote installation.
117 +
112 112  = III - Update =
113 113  
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.
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.
115 115  
116 -= IV - Configurations & Services =
122 += IV - Configurations & Monitoring =
117 117  
118 118  there are configuration files that help to maintain all needed parameters for the functioning of iXPath.
119 119  
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.
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
122 122  
123 -=== 1) Ports ===
129 +== 1) Ports ==
124 124  
125 125  * As mentioned before, iXPath takes 8090 (Engine) and 8091 (COM) automatically as ports.
126 126  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,8 +128,9 @@
128 128  [[image:1657208183258-245.png||height="48" width="712"]]
129 129  \\and make the changes on **./SERVER/engine/config.properties :** 
130 130  \\[[image:1657208426432-822.png||height="349" width="478"]]
131 -\\and same for  **./SERVER/wwwroot/ ** : 
137 +\\and same for  **./SERVER/wwwroot/config/config.ini ** : 
132 132  [[image:1657208646920-357.png||height="146" width="543"]]
139 +\\NB: 'Rest' refers to Engine service, and 'COM' refers to COM service 
133 133  
134 134  * the Engine also uses ports 22920 and 22921 for FTP and FTPS respectively** **
135 135  [[image:2022-07-07_17h03_53.png||height="337" width="501"]]
... ... @@ -147,7 +147,7 @@
147 147  [[image:2022-07-07_17h45_14.png||height="163" width="724"]]
148 148  
149 149  
150 -=== 2) services ===
157 +== 2) Services ==
151 151  
152 152  * To maintain services on your operating system, go to the search bar and type "services.msc" :
153 153  
... ... @@ -159,14 +159,16 @@
159 159  
160 160  [[image:2022-07-08_10h30_20.png||height="16" width="654"]]
161 161  
162 -here you can start, restart, pause, or stop the service target by right-clicking on it and choosing the option needed :
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:
163 163  
164 -[[image:wyQuu5TvEPzRyr6wh3fXmJ-970-80.jpg]]
171 +[[image:manage-startup-type.png]] [[image:startup-type.png]]
165 165  
173 +
174 +
166 166  {{{NB: all services must be running to run the iXPath app correctly.
167 167  }}}
168 168  
169 -* if the Apache service cannot be on running status because of unavailability of port 80, please follow these steps :
178 +* if the Apache service cannot be on running status because of the unavailability of port 80, please follow these steps :
170 170  ** open a command line and type :  **netstat -aon | findstr :80**
171 171  [[image:1657273380453-615.png||height="308" width="512"]]
172 172  
... ... @@ -178,11 +178,112 @@
178 178  *** **SQL Server Reporting Services (ReportServer)**
179 179  *** **BranchCache (PeerDistSvc)**
180 180  *** **Network Connection Broker (NcbService) **
181 -**
182 -***
190 +** start apache service  
191 +[[image:1657275791598-755.png||height="233" width="356"]]
183 183  
184 -* stop and disable the following services : 
185 -** **world wide web publishing service (W3SVC)**
193 +== 3) Logs ==
186 186  
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 :
187 187  
188 -\\
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 service undesired.
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 +)))
1657275791598-755.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +175.4 KB
Content
1657290152857-725.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +221.7 KB
Content
1657290453989-461.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +93.2 KB
Content
1657290504230-487.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +53.7 KB
Content
1657290585573-818.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +57.0 KB
Content
1662050326672-140.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +73.6 KB
Content
1662050353963-994.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +80.7 KB
Content
1662050581994-703.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +80.7 KB
Content
1662050623172-491.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +72.4 KB
Content
1662053701761-722.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +76.1 KB
Content
2022-09-01_17h53_14.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +308.7 KB
Content
2022-09-01_17h53_37.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +308.2 KB
Content
2022-09-01_17h54_18.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +315.1 KB
Content
2022-09-01_18h16_32.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +16.7 KB
Content
2022-09-01_18h17_14.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +16.3 KB
Content
2022-09-01_18h21_18.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +18.9 KB
Content
2022-09-01_18h36_21.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +307.1 KB
Content
2022-09-01_19h05_22.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +10.2 KB
Content
startup-type.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.omoustaghfir
Size
... ... @@ -1,0 +1,1 @@
1 +9.3 KB
Content
This wiki is hosted and managed by iXPath
Powered by XWiki 13.3 debian