How to install MedITEX WebPortal2.0

From MedITEX - Wiki

(Difference between revisions)
Jump to: navigation, search
 
(57 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
<h3 style="text-align: justify;">MedITEX Webportal Installation&nbsp;</h3>
+
<h2 style="text-align: justify;">MedITEX Webportal Installation&nbsp;</h2>
−
<h3 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></h3>
+
<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 style="text-align: justify;">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>
Line 368: Line 368:
 
</table>
 
</table>
 
<p>&nbsp;</p>
 
<p>&nbsp;</p>
−
<h3>MedITEX Webportal Integation</h3>
+
<h2>MedITEX Webportal Integration</h2>
−
<p>After the installation, MedITEX Webportal should be easy to integrate to your website.</p>
+
<p>After installation is completed, the embedding of MedITEX Webportal must be done on the website of the clinic.</p>
−
<p>It is thus important to know that we do not host the webportal. The Webportal must be linked and opened from the correspondant website.</p>
+
<p>It is possible to add a simple link to the Webportal, or a frame inside your website.</p>
−
<p>According to your needs and and specifications, it is possible to add a link to a specific section of your Website, from where the webportal should be accessed.</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><strong>E.g.</strong>: A Patient login section. When clicking on this link, a frame or a new tabsheet will open, redirecting you subsequently to the webportal interface.</p>
+
<p>&nbsp;</p>
−
<p>Below you can find a simple HTML example showing how this should practically done:&nbsp;</p>
+
 
<table style="margin-left: auto; margin-right: auto;" border="0">
 
<table style="margin-left: auto; margin-right: auto;" border="0">
 
<tbody>
 
<tbody>
 
<tr>
 
<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>
 
<td>
−
<p><strong><span style="color: #0000ff;">&lt;ul <span style="color: #ff0000;">class</span>="<span style="color: #800080;">global-nav__menu</span>"&gt;</span></strong></p>
+
<p>The accessibility of the server address must be configured by the clinic. The IP address should be static.</p>
−
<p><strong><span style="color: #0000ff;">&nbsp; &lt;li <span style="color: #ff0000;">class</span>="<span style="color: #800080;">global-nav__menu-item global-nav__menu-item--login</span>"&gt;</span></strong></p>
+
</td>
−
<p><strong><span style="color: #000000;">&nbsp;&nbsp;&nbsp; ::before</span></strong></p>
+
−
<p><strong><span style="color: #0000ff;">&nbsp;&nbsp;&nbsp; &lt;a <span style="color: #ff0000;">class</span>="<span style="color: #800080;">global-nav__menu-link</span>" <span style="color: #ff0000;">href</span>="<span style="color: #800080;">https://portal.democlinic.com:8443" <span style="color: #ff0000;">rel</span>="external</span>"&gt;<span style="color: #000000;">Patient Login</span>&lt;/a&gt; <span style="color: #000000;">==$0</span></span></strong></p>
+
−
<p><strong><span style="color: #0000ff;">&nbsp; &lt;/li&gt;</span></strong></p>
+
−
<p>...</p>
+
−
<strong><span style="color: #0000ff;">&lt;/ul&gt;</span></strong></td>
+
 
</tr>
 
</tr>
 
</tbody>
 
</tbody>
 
</table>
 
</table>
 
<p>&nbsp;</p>
 
<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>
 
<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>