How to install MedITEX WebPortal2.0

From MedITEX - Wiki

(Difference between revisions)
Jump to: navigation, search
 
(78 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
<h3>MedITEX WebPortal2.0 instructions for clinical IT administrators</h3>
+
<h2 style="text-align: justify;">MedITEX Webportal Installation&nbsp;</h2>
−
<p>&nbsp;</p>
+
<p style="text-align: justify;"><strong>1.</strong> Right-click on the ZIP-file with WebPortal installation, choose <strong>&ldquo;Extract All&rdquo;</strong>, and save everything into a folder called<strong> &ldquo;MediTEXWebPortal2.0&rdquo;</strong><em>. </em></p>
−
<p><strong>1.</strong> Right-click on the ZIP-file with WebPortal installation, choose <strong>&ldquo;Extract All&rdquo;</strong>, and save everything into a folder called <strong>&ldquo;MediTEXWebPortal2.0&rdquo;</strong><em>. </em>In this manual, WebPortal will be created in CRITEX folder.</p>
+
<p style="text-align: justify;">In this manual, WebPortal will be created in CRITEX folder.</p>
 
<p>&nbsp;</p>
 
<p>&nbsp;</p>
 
<ol> </ol>
 
<ol> </ol>
−
<p><strong>2.</strong> After extraction, right click on <strong>&ldquo;FMsoft_uniGUI_Complete_runtime_*.exe&rdquo; </strong>and choose <strong>&ldquo;Run as administrator&rdquo;</strong> to launch the installation.</p>
+
<p style="text-align: justify;"><strong>2.</strong> After extraction, right click on <strong>&ldquo;FMsoft_uniGUI_Complete_runtime_*.exe&rdquo; </strong>and choose <strong>&ldquo;Run as administrator&rdquo;</strong> to launch the installation.</p>
 
<table style="margin-left: auto; margin-right: auto;" border="0">
 
<table style="margin-left: auto; margin-right: auto;" border="0">
 
<tbody>
 
<tbody>
Line 67: Line 67:
 
<p>&nbsp;</p>
 
<p>&nbsp;</p>
 
<p><em>Hint: the port number defined in parameter <strong>Port</strong>,<strong> </strong>must be open on the firewall. If <strong>WebPortal </strong>is not installed directly in the same server as <strong>MedITEX</strong>,<strong> </strong>this port must be opened on both servers.</em></p>
 
<p><em>Hint: the port number defined in parameter <strong>Port</strong>,<strong> </strong>must be open on the firewall. If <strong>WebPortal </strong>is not installed directly in the same server as <strong>MedITEX</strong>,<strong> </strong>this port must be opened on both servers.</em></p>
 +
<p><em><a href="/images/MedITEX_Webportal_Security_ver.2.pdf" target="_blank">Please visit this link for more information</a>.<br /></em></p>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 101: Line 102:
 
<p style="text-align: center;"><strong>[SMTP]</strong></p>
 
<p style="text-align: center;"><strong>[SMTP]</strong></p>
 
</td>
 
</td>
−
</tr>
 
−
<tr>
 
−
<td><img style="display: block; margin-left: auto; margin-right: auto;" src="/images/WebPortalSMTP.PNG" alt="" /></td>
 
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
<td>
 
<td>
−
<p>This portion of the configuration corresponds to the email services provided by the portal.</p>
+
<p>This portion of the configuration is supplied by MedITEX IVF. It corresponds to the email services provided by the portal.</p>
−
<ul>
+
<p><a href="/index.php?title=MedITEX_IVF_Settings#Web_portal" target="_blank">Click here</a> to read more about the clinic email settings.</p>
−
<li>Host: host name of the web client.</li>
+
−
</ul>
+
−
<ul>
+
−
<li>Port: number of the port defined in the web client.</li>
+
−
</ul>
+
−
<ul>
+
−
<li>FromName: name that will be displayed when receiving an email from the portal.</li>
+
−
</ul>
+
−
<ul>
+
−
<li>FromAddress: address that will be displayed when receiving an email from the portal.</li>
+
−
</ul>
+
−
<ul>
+
−
<li>Username: login for connection to the webclient.</li>
+
−
</ul>
+
−
<ul>
+
−
<li>Password: password for connection to the webclient.</li>
+
−
</ul>
+
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 181: Line 162:
 
<p>This portion of the configuration is used for inserting the certificates of the secure portal.</p>
 
<p>This portion of the configuration is used for inserting the certificates of the secure portal.</p>
 
<p>If the SSL is being used, the portion below has to be uncommented. To uncomment the lines, remove the semi-colon from the beginning of the text.</p>
 
<p>If the SSL is being used, the portion below has to be uncommented. To uncomment the lines, remove the semi-colon from the beginning of the text.</p>
 +
<p>It is favorable to have the latest OpenSSL version for the installation. It can be downloaded from the link below:</p>
 +
<p style="text-align: center;">https://www.openssl.org/</p>
 
<p>Create a folder called SSL under MedITEXWebPortal2.0 and put the SSL files under this folder.</p>
 
<p>Create a folder called SSL under MedITEXWebPortal2.0 and put the SSL files under this folder.</p>
−
<p>To know how to create a .pem file for SSL Certificate Installations, follow the instructions on the link below:</p>
+
<p>To know how to create a .pem file for SSL Certificate Installations, follow the instructions described <a href="/index.php?title=How_to_create_a_.pem_File_for_SSL_Certificate_Installations">here</a>.</p>
−
<p style="text-align: center;"><a href="/index.php?title=How_to_create_a_.pem_File_for_SSL_Certificate_Installations" target="_blank">http://wiki.meditex-software.com/index.php?title=How_to_create_a_.pem_File_for_SSL_Certificate_Installations</a></p>
+
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 225: Line 207:
 
<ol> </ol>
 
<ol> </ol>
 
<p><strong>7.</strong> Open the &ldquo;<strong>Control Panel -&gt; Windows Firewall -&gt; Advanced settings&rdquo;</strong></p>
 
<p><strong>7.</strong> Open the &ldquo;<strong>Control Panel -&gt; Windows Firewall -&gt; Advanced settings&rdquo;</strong></p>
−
<p>Click on <strong>&ldquo;Inbound Rules&rdquo;</strong> and choose &ldquo;<strong>New Rule&hellip;&rdquo;</strong></p>
+
<ul>
 +
<li>Click on <strong>&ldquo;Inbound Rules&rdquo;</strong> and choose &ldquo;<strong>New Rule&hellip;&rdquo;</strong></li>
 +
</ul>
 
<table style="margin-left: auto; margin-right: auto;" border="0" width="10" height="24">
 
<table style="margin-left: auto; margin-right: auto;" border="0" width="10" height="24">
 
<tbody>
 
<tbody>
Line 234: Line 218:
 
</table>
 
</table>
 
<p>&nbsp;</p>
 
<p>&nbsp;</p>
−
<p>Select <strong>&ldquo;Port&rdquo;</strong> and click <strong>&ldquo;Next&rdquo;</strong></p>
+
<ul>
 +
<li>Select <strong>&ldquo;Port&rdquo;</strong> and click <strong>&ldquo;Next&rdquo;</strong></li>
 +
</ul>
 
<table style="margin-left: auto; margin-right: auto;" border="0" width="10" height="24">
 
<table style="margin-left: auto; margin-right: auto;" border="0" width="10" height="24">
 
<tbody>
 
<tbody>
Line 243: Line 229:
 
</table>
 
</table>
 
<p>&nbsp;</p>
 
<p>&nbsp;</p>
−
<p>Choose &ldquo;<strong>TCP</strong>&rdquo; and &ldquo;<strong>Specific local ports</strong>&rdquo; and set the port to <strong>8077</strong> or <strong>8443</strong>, depending on the port configured in the <strong>INI</strong> file.</p>
+
<ul>
 +
<li>Choose &ldquo;<strong>TCP</strong>&rdquo; and &ldquo;<strong>Specific local ports</strong>&rdquo; and set the port to <strong>8077</strong> or <strong>8443</strong>, depending on the port configured in the <strong>INI</strong> file.</li>
 +
</ul>
 
<table style="margin-left: auto; margin-right: auto;" border="0">
 
<table style="margin-left: auto; margin-right: auto;" border="0">
 
<tbody>
 
<tbody>
Line 252: Line 240:
 
</table>
 
</table>
 
<p>&nbsp;</p>
 
<p>&nbsp;</p>
−
<p>Click <strong>&ldquo;Next&rdquo;</strong>.</p>
+
<ul>
−
<p>Specify the name and click <strong>&ldquo;Finish&rdquo;.</strong></p>
+
<li>Click <strong>&ldquo;Next&rdquo;</strong>.</li>
 +
</ul>
 +
<ul>
 +
<li>Specify the name and click <strong>&ldquo;Finish&rdquo;.</strong></li>
 +
</ul>
 
<table style="margin-left: auto; margin-right: auto;" border="0">
 
<table style="margin-left: auto; margin-right: auto;" border="0">
 
<tbody>
 
<tbody>
Line 262: Line 254:
 
</table>
 
</table>
 
<p>&nbsp;</p>
 
<p>&nbsp;</p>
−
<p>Repeat step 7 with <strong>&ldquo;Outbound Rules&rdquo;:</strong></p>
+
<ul>
 +
<li>Repeat step 7 with <strong>&ldquo;Outbound Rules&rdquo;:</strong></li>
 +
</ul>
 
<table style="margin-left: auto; margin-right: auto;" border="0">
 
<table style="margin-left: auto; margin-right: auto;" border="0">
 
<tbody>
 
<tbody>
Line 368: Line 362:
 
<tr>
 
<tr>
 
<td>
 
<td>
−
<p>The logo of the WebPortal can be changed by substituting the file called &ldquo;<strong>Logo&rdquo;</strong> which is located in &ldquo;<strong>C: \CRITEX\MedITEXWebportal2.0\img\desktop</strong>&rdquo; for the Desktop version or in &ldquo;<strong>C: \CRITEX\MedITEXWebportal2.0\img\mobile&rdquo; </strong>for the mobile version with a file of the same name.</p>
+
<p>The logo of the WebPortal can be changed by substituting the file called &ldquo;<strong>Logo&rdquo;</strong> which is located in &ldquo;<strong>C: \CRITEX\MedITEXWebportal2.0\img\desktop</strong>&rdquo; for the desktop version or in &ldquo;<strong>C: \CRITEX\MedITEXWebportal2.0\img\mobile&rdquo; </strong>for the mobile version with a file of the same name.</p>
−
Please make sure that the new logo dimensions are the same as the old one.</td>
+
<em> For the desktop version, the logo dimensions should be (246x105), and for the mobile version, the dimensions should be (738x315).<br /></em></td>
 
</tr>
 
</tr>
 
</tbody>
 
</tbody>
 
</table>
 
</table>
 
<p>&nbsp;</p>
 
<p>&nbsp;</p>
 +
<h2>MedITEX Webportal Integration</h2>
 +
<p>After installation is completed, the embedding of MedITEX Webportal must be done on the website of the clinic.</p>
 +
<p>It is possible to add a simple link to the Webportal, or a frame inside your website.</p>
 +
<p><strong>E.g.</strong>: a <strong>Patient Login</strong> section. When clicking on this link, a frame or a new window will open, redirecting the patient to Webportal.</p>
 
<p>&nbsp;</p>
 
<p>&nbsp;</p>
 +
<table style="margin-left: auto; margin-right: auto;" border="0">
 +
<tbody>
 +
<tr>
 +
<td style="text-align: left;">
 +
<p style="text-align: left;">It is the responsibility of the clinic to provide a public IP address for the server where MedITEX Webportal is installed.</p>
 +
<p style="text-align: left;">Once this is performed, Webportal will be accessed over this configured IP, such as:</p>
 +
<p><a href="https://100.200.300.400:443">https://100.200.300.400:443</a></p>
 +
<p>&nbsp;</p>
 +
<p>Alternatively, it is possible to create a Subdomain in your top-level domain (TLD) that is linked with the IP address configured above:</p>
 +
<p><a href="https://domain.clinic.com:443">https://portal.clinic.com:443</a></p>
 +
</td>
 +
</tr>
 +
</tbody>
 +
</table>
 +
<p>&nbsp;</p>
 +
<table style="margin-left: auto; margin-right: auto;" border="0">
 +
<tbody>
 +
<tr>
 +
<td><img src="/images/hint48.png" alt="" width="48" height="48" /></td>
 +
<td>
 +
<p>The accessibility of the server address must be configured by the clinic. The IP address should be static.</p>
 +
</td>
 +
</tr>
 +
</tbody>
 +
</table>
 +
<p>&nbsp;</p>
 +
<p>Once the address is configured, you can simply add a link to your website that will point to MedITEX Webportal. Below you can find a simple HTML example showing how this could be achieved:</p>
 +
<p>&nbsp;</p>
 +
<table style="margin-left: auto; margin-right: auto;" border="0">
 +
<tbody>
 +
<tr>
 +
<td>
 +
<p><span style="color: #0000ff;">&lt;<span style="color: #ff0000;"><span style="color: #800000;">!doctype </span>html</span>&gt;</span></p>
 +
<p><span style="color: #0000ff;">&nbsp;&nbsp;&lt;<span style="color: #800000;">html</span>&gt;</span></p>
 +
<p><span style="color: #0000ff;">&nbsp;&nbsp;&nbsp;&nbsp;&lt;<span style="color: #800000;">head</span>&gt;</span></p>
 +
<p><span style="color: #0000ff;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;<span style="color: #800000;">title</span>&gt;<span style="color: #000000;">Demo IVF Clinic</span>&lt;<span style="color: #800000;">/title</span>&gt;</span></p>
 +
<p><span style="color: #0000ff;">&nbsp;&nbsp;&nbsp;&nbsp;&lt;<span style="color: #800000;">/head</span>&gt;</span></p>
 +
<p><span style="color: #0000ff;">&nbsp;&nbsp;&nbsp;&nbsp;&lt;<span style="color: #800000;">body</span>&gt;</span></p>
 +
<p><span style="color: #0000ff;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;<span style="color: #800000;">p</span>&gt;&lt;<span style="color: #800000;">a&nbsp;</span><span style="color: #ff0000;">href</span>="<a href="https://domain.clinic.com:443">https://portal.clinic.com:443</a>"&gt;<span style="color: #000000;">Patient Login</span>&lt;<span style="color: #800000;">/a</span>&gt;&lt;<span style="color: #800000;">/p</span>&gt;</span></p>
 +
<p><span style="color: #0000ff;">&nbsp;&nbsp;&nbsp;&nbsp;&lt;<span style="color: #800000;">/body</span>&gt;</span></p>
 +
<p><span style="color: #0000ff;">&nbsp;&nbsp;&lt;<span style="color: #800000;">/html</span>&gt;</span></p>
 +
</td>
 +
</tr>
 +
</tbody>
 +
</table>
 
<table style="float: right;" border="0">
 
<table style="float: right;" border="0">
 
<tbody>
 
<tbody>

Latest revision as of 14:16, 28 September 2017

MedITEX Webportal Installation 

1. Right-click on the ZIP-file with WebPortal installation, choose “Extract All”, and save everything into a folder called “MediTEXWebPortal2.0”.

In this manual, WebPortal will be created in CRITEX folder.

 

2. After extraction, right click on “FMsoft_uniGUI_Complete_runtime_*.exe” and choose “Run as administrator” to launch the installation.

<tbody> </tbody>
<img src="/images/WebPortal2.0Setup.jpg" alt="" />

 

3. Right-click on “mexWebPortal_Install.bat” -> Edit.

If necessary, change the highlighted path, to the current path of the newly created WebPortal folder and save it.

<tbody> </tbody>
<img src="/images/InstallPath.png" alt="" />

 

4. Right-click on “mexWebPortal_Uninstall.bat” -> Edit.

If necessary, change the highlighted path to the current path of the WebPortal folder and save it.

<tbody> </tbody>
<img src="/images/UninstallPath.png" alt="" />

 

5. Right-click on “MedITEX_Webportal.ini” -> Edit.

Adjust the configuration according to the instructions below:

 

<tbody> </tbody>
[DBConnection]
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/WebPortalDBConnection.PNG" alt="" />
  • Database: alias or path to the database.
  • Fbclient: path to the Fbclient which is located in the MedITEXWebportal2.0 folder.
  • Server: the server where the Database is located.
  • Port: port open on Firebird where the database is installed.
  • CharacterSet: character set of the database. This information can be found in the “Recdate.ini” file inside the “MedITEX IVF” folder.

 

Hint: the port number defined in parameter Port, must be open on the firewall. If WebPortal is not installed directly in the same server as MedITEX, this port must be opened on both servers.

<a href="/images/MedITEX_Webportal_Security_ver.2.pdf" target="_blank">Please visit this link for more information</a>.

 

<tbody> </tbody>
[Server]
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/WebPortalServer.png" alt="" />
  • Port: the port number can be set to 8077 for the normal connection or to 8443 for the secure connection.
  • URL: is the address used for the WebPortal (http:// or https://).

 

Please, do not modify the other fields in this section.

 

<tbody> </tbody>

[SMTP]

This portion of the configuration is supplied by MedITEX IVF. It corresponds to the email services provided by the portal.

<a href="/index.php?title=MedITEX_IVF_Settings#Web_portal" target="_blank">Click here</a> to read more about the clinic email settings.

 

<tbody> </tbody>

[Logout]
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/WebPortalLogout.PNG" alt="" />
  • MintoLogout: if the session is inactive, the system will automatically logout the patient after the amount of minutes in this parameter.

 

<tbody> </tbody>

[CustomMeta]
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/WebPortalCustomMeta.PNG" alt="" />

Meta tags (<meta>) used for authenticating the portal. This field is optional.

If more than one tag is being used, insert them after each other. For example:

<meta name:”Key1”…/><meta name:”Key2”…/>

 

<tbody> </tbody>

[SSLManager]

This portion of the configuration is used for inserting the certificates of the secure portal.

If the SSL is being used, the portion below has to be uncommented. To uncomment the lines, remove the semi-colon from the beginning of the text.

It is favorable to have the latest OpenSSL version for the installation. It can be downloaded from the link below:

https://www.openssl.org/

Create a folder called SSL under MedITEXWebPortal2.0 and put the SSL files under this folder.

To know how to create a .pem file for SSL Certificate Installations, follow the instructions described <a href="/index.php?title=How_to_create_a_.pem_File_for_SSL_Certificate_Installations">here</a>.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/WebPortalSSL.PNG" alt="" width="763" height="109" />
  • Enabled: if Enabled = 1, then SSL is activated. Otherwise, SSL will be disabled.
  • CertFile: path to the CertFile.
  • KeyFile: path to the KeyFile.
  • RootCertFile: path to the RootCertFile.
  • SSLPort: is the port used for the secure connection. This port has to be open in the firewall.

 

 

6. Right-click on “mexWebPortal_Install.bat”  -> Run as administrator

The Window below should be seen.

<tbody> </tbody>
<img src="/images/WebPortalInstallRun.jpg" alt="" />

 

7. Open the “Control Panel -> Windows Firewall -> Advanced settings”

  • Click on “Inbound Rules” and choose “New Rule…”
<tbody> </tbody>
<img src="/images/WebPortalInboundRules.png" alt="" />

 

  • Select “Port” and click “Next”
<tbody> </tbody>
<img src="/images/WebPortalNewRule.jpg" alt="" />

 

  • Choose “TCP” and “Specific local ports” and set the port to 8077 or 8443, depending on the port configured in the INI file.
<tbody> </tbody>
<img src="/images/WebPortalProtocolAndPorts.jpg" alt="" />

 

  • Click “Next”.
  • Specify the name and click “Finish”.
<tbody> </tbody>
<img src="/images/WebPortalRuleName.jpg" alt="" />

 

  • Repeat step 7 with “Outbound Rules”:
<tbody> </tbody>
<img src="/images/WebPortalOutboundRules.png" alt="" />

 

8. Now it is possible to access the MedITEX WebPortal in a browser with the following URL:

http://server-id:8077 or https://server-id:8443

 

9. After finishing the installation, there is a possibility to adjust the WebPortal settings.

Right-click on “MedITEX_Webportal.ini” -> Edit.

 

<tbody> </tbody>

[Areas]
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/WebPortalAreas.PNG" alt="" />

Areas set to 1 are visible. To make it invisible, set it to 0.

 

<tbody> </tbody>

[Design]

The design of the WebPortal can be readjusted.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/WebPortalDesign.PNG" alt="" />
  • ActiveDesign should not be changed.
  • Theme, TouchTheme can be modified according to the parameters below.
<tbody> </tbody>
Theme Options

Touch Theme Options
Theme = default  
Theme = blue  
Theme = gray
Theme = access  
Theme = neptune
Theme = bootstrap

TouchTheme = sencha-touch
TouchTheme = cupertino
TouchTheme = cupertino-classic
TouchTheme = mountainview
TouchTheme = tizen
TouchTheme = wp
TouchTheme = bb10


  • Header: header set to 1 is visible. To make it invisible, set it to 0.
  • MainBGColor: is the main color, used for the header, the navigator, the buttons, etc.
  • FontColor: is the main font color used in the navigator, buttons, but just if nothing is selected.
  • SelectedBGColor: is the background color which is shown when something is selected (button, tab sheet).
  • SelectedFontColor: is the font color which is shown when something is selected (button, tab sheet).

 

<tbody> </tbody>

[Logo]

The logo of the WebPortal can be changed by substituting the file called “Logo” which is located in “C: \CRITEX\MedITEXWebportal2.0\img\desktop” for the desktop version or in “C: \CRITEX\MedITEXWebportal2.0\img\mobile” for the mobile version with a file of the same name.

For the desktop version, the logo dimensions should be (246x105), and for the mobile version, the dimensions should be (738x315).

 

MedITEX Webportal Integration

After installation is completed, the embedding of MedITEX Webportal must be done on the website of the clinic.

It is possible to add a simple link to the Webportal, or a frame inside your website.

E.g.: a Patient Login section. When clicking on this link, a frame or a new window will open, redirecting the patient to Webportal.

 

<tbody> </tbody>

It is the responsibility of the clinic to provide a public IP address for the server where MedITEX Webportal is installed.

Once this is performed, Webportal will be accessed over this configured IP, such as:

<a href="https://100.200.300.400:443">https://100.200.300.400:443</a>

 

Alternatively, it is possible to create a Subdomain in your top-level domain (TLD) that is linked with the IP address configured above:

<a href="https://domain.clinic.com:443">https://portal.clinic.com:443</a>

 

<tbody> </tbody>
<img src="/images/hint48.png" alt="" width="48" height="48" />

The accessibility of the server address must be configured by the clinic. The IP address should be static.

 

Once the address is configured, you can simply add a link to your website that will point to MedITEX Webportal. Below you can find a simple HTML example showing how this could be achieved:

 

<tbody> </tbody>

<!doctype html>

  <html>

    <head>

        <title>Demo IVF Clinic</title>

    </head>

    <body>

        <p><a href="<a href="https://domain.clinic.com:443">https://portal.clinic.com:443</a>">Patient Login</a></p>

    </body>

  </html>
<tbody> </tbody>
<a href="/index.php?title=Administrators_Support">Back to Administrators support
</a>		 <a href="#top">Back to top</a>