Changes for page Installation

Last modified by Achraf El Kari on 2022/09/02 08:04
<
From version < 36.10 >
edited by Outhman Moustaghfir
on 2022/07/08 13:01
To version < 47.1 >
edited by Outhman Moustaghfir
on 2022/09/01 18:39
>
Change comment: Uploaded new attachment "1662050353963-994.png", version {1}

Summary

Details

Page properties
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 +== 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 -=== 2) Offline installation ===
76 +== 2) Offline installation ==
77 77  
78 78  As mentioned before, the offline installation does not require an internet network.
79 79  
... ... @@ -111,16 +111,16 @@
111 111  
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.
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 remote resources.
115 115  
116 116  = 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.
120 +* config.properties: configuration of the Engine. here we can configure ports, directories, hosts ... it's located in **/SERVER/engine/config.properties **path
121 +* 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 ===
123 +== 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/ ** : 
131 +\\and same for  **./SERVER/wwwroot/config/config.ini ** : 
132 132  [[image:1657208646920-357.png||height="146" width="543"]]
133 +\\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 ===
151 +== 2) Services ==
151 151  
152 152  * To maintain services on your operating system, go to the search bar and type "services.msc" :
153 153  
... ... @@ -183,42 +183,64 @@
183 183  ** start apache service  
184 184  [[image:1657275791598-755.png||height="233" width="356"]]
185 185  
187 +== 3) Logs ==
186 186  
187 -===
188 -3) Logs ===
189 -
190 190  There are some log files to help you figure out what causes the dysfunctioning of the iXPath app, and here are all of them :
191 191  
192 192  |(% rowspan="8" %)(((
193 -=== **COM** ===
192 +(% class="wikigeneratedid" id="HCOM" %)
193 +//**COM**//
194 194  )))|(% rowspan="2" %)(((
195 -===== **PORTAL** =====
196 -)))|iXPath Front Php:|/var/www/html
197 -|Portal Log:|/var/www/html/Logs
195 +(% class="wikigeneratedid" id="HPORTAL" %)
196 +//**PORTAL**//
197 +)))|iXPath Front Php:|.\SERVER\wwwroot\Logs
198 +|Portal Log:|.\SERVER\wwwroot\Logs
198 198  |(% rowspan="6" %)(((
199 -===== **COM** =====
200 +(% class="wikigeneratedid" id="HCOM-1" %)
201 +//**COM**//
200 200  )))
201 -|LogRest:|/ixServer/LOGS/REST (logREST.log)
202 -|Communication Protocol|/mnt/ixpath-data-sim/ixServer/CONFIG/COM/
203 -|Communication Protocol (AS2) Log|/mnt/ixpath-data-sim/ixServer/CONFIG/COM/AS2/LOGS
204 -|LogAppCOM:|/var/log/ixpathCom (logRESTCOM.log)
205 -|ENV|/mnt/ixpath-data-sim/ixServer/ENV
203 +|(% colspan="1" rowspan="2" %)Communication Protocol
204 +|.\SERVER\Data\config\COM
205 +|Communication Protocol (AS2) Log (Example)|.\SERVER\Data\config\COM\AS2\LOGS
206 +|(% colspan="1" rowspan="2" %)LogCom
207 +|.\SERVER\Engine\ (logRESTCOM.log)
206 206  |(% rowspan="4" %)(((
207 -=== **ENGINE** ===
209 +(% class="wikigeneratedid" id="HENGINE" %)
210 +//**ENGINE**//
208 208  )))|(% rowspan="3" %)(((
209 -===== **ENGINE’s Log** =====
210 -)))|Source:|/opt/ixpath/ixpath.jar
211 -|LogRest:|/ixServer/LOGS/REST (logREST.log)
212 -|LogApp:|/var/log/ixpath (ixpath.log ou ixpathErr.log)
212 +(% class="wikigeneratedid" id="HENGINE2019sLog" %)
213 +//**ENGINE’s Log**//
214 +)))|Source:|.\SERVER\Engine\ixpath.jar
215 +|LogRest:|.\SERVER\Data\LOGS\REST (logREST.log)
216 +|LogApp:|.\SERVER\Engine\ (ixpath.log ou ixpathErr.log)
213 213  |(((
214 -===== **Process LOGS** =====
215 -)))|Process LOGS|/ixServer/LOGS/ENGINE
218 +(% class="wikigeneratedid" id="HProcessLOGS" %)
219 +//**Process LOGS**//
220 +)))|Process LOGS|.\SERVER\Data\LOGS\ENGINE
216 216  |(((
217 -=== **BDD** ===
222 +(% class="wikigeneratedid" id="HBDD" %)
223 +//**BDD**//
218 218  )))|(((
219 -===== **DataBase** =====
220 -)))|Query Log|/var/log/mysql
225 +(% class="wikigeneratedid" id="HDataBase" %)
226 +//**DataBase**//
227 +)))|Query Log|.\SERVER\mysql\logs
221 221  
229 += V - FAQ =
222 222  
223 -
231 +* During the installation, it might happen that the directory already exists, and that will block it.
232 +[[image:1657290152857-725.png||height="361" width="606"]]
233 +you should take action by following these steps below :
234 +** make a backup for the directory '**SERVER'.**
235 +** delete the directory '**SERVER'**
236 +** relaunch the installation.
237 +* if you can't start RabbitMQ service, 
238 +[[image:1657290453989-461.png||height="99" width="560"]]
239 +add new environment variable named RABBITMQ_SERVER with the RabbitMQ installation Path  :
240 +[[image:1657290504230-487.png||height="159" width="554"]]
241 +\\RABBITMQ_SERVER : C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.1C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.1
242 +\\And now restart the RabbiMQ service. 
243 +[[image:1657290585573-818.png||height="66" width="585"]]
224 224  
245 +* In case you want to install each service on its own server, you must specify all these details inside the configuration files (config.ini & config.properties (COM and Engine))
246 +Eg : installing 
247 +
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
This wiki is hosted and managed by iXPath
Powered by XWiki 13.3 debian