OpenRIMS Wiki - User contributions [en]

Main Page

2022-06-17T23:46:06Z

Khoppenworth007: /* Main Links */

[[File:Logo OpenRIMS.png|thumb]]
We are currently uploading all system documentation to this platform.

The process is estimated to conclude by August 2022.

This will go hand in hand with rebranding to OpenRIMS which logo is seen to the right.

== Main Links ==
* User Guide for Pharmaceutical Manufacturers, Pharmacy Owners and other Clients of Regulatory Authorities
* User Guide for Regulatory Staff
* User Guide for System Administrators
*[Http://wiki.openrims.org/index.php/Installation%20Part%202 Installation Part 2]
*[Http://wiki.openrims.org/index.php/Installation%20Part1 Installation Part 1]

Main Page

2022-06-17T23:45:41Z

Khoppenworth007: /* Main Links */

[[File:Logo OpenRIMS.png|thumb]]
We are currently uploading all system documentation to this platform.

The process is estimated to conclude by August 2022.

This will go hand in hand with rebranding to OpenRIMS which logo is seen to the right.

== Main Links ==
* User Guide for Pharmaceutical Manufacturers, Pharmacy Owners and other Clients of Regulatory Authorities
* User Guide for Regulatory Staff
* User Guide for System Administrators
*[Http://wiki.openrims.org/index.php/Installation%20Part%202 Installation Part 2]
* [./Http://wiki.openrims.org/index.php/Installation%20Part1 Installation Part 1]

Main Page

2022-06-17T23:45:18Z

Khoppenworth007: /* Main Links */

[[File:Logo OpenRIMS.png|thumb]]
We are currently uploading all system documentation to this platform.

The process is estimated to conclude by August 2022.

This will go hand in hand with rebranding to OpenRIMS which logo is seen to the right.

== Main Links ==
* User Guide for Pharmaceutical Manufacturers, Pharmacy Owners and other Clients of Regulatory Authorities
* User Guide for Regulatory Staff
* User Guide for System Administrators
* [./[Http://wiki.openrims.org/index.php/Installation%20Part%202 Installation Part 2] Installation Part 2]
* [./Http://wiki.openrims.org/index.php/Installation%20Part1 Installation Part 1]

Main Page

2022-06-17T23:44:13Z

Khoppenworth007:

[[File:Logo OpenRIMS.png|thumb]]
We are currently uploading all system documentation to this platform.

The process is estimated to conclude by August 2022.

This will go hand in hand with rebranding to OpenRIMS which logo is seen to the right.

== Main Links ==
* User Guide for Pharmaceutical Manufacturers, Pharmacy Owners and other Clients of Regulatory Authorities
* User Guide for Regulatory Staff
* User Guide for System Administrators
* [./Http://wiki.openrims.org/index.php/Installation%20Part%202 Installation Part 2]
* [./Http://wiki.openrims.org/index.php/Installation%20Part1 Installation Part 1]

OpenRIMS-RPM - Installation Part 3

2022-06-17T23:39:34Z

Khoppenworth007: Installation Guide Part 2

=== Google Authentication ===
The Pharmadex 2 uses OATH2[1] to allow authenticate using Google login. For each deployment, the Google Authentication should be configured separately.

The original Google guide is here. The application type is Web Application

<nowiki>https://developers.google.com/adwords/api/docs/guides/authentication</nowiki>

The process is cumbersome, thus below screens from the current configuration

After configuration it will be necessary to copy Client ID and Client secret to the application.properties

<nowiki>##</nowiki> OATH2

spring.security.oauth2.client.registration.google.client-id=client_id

spring.security.oauth2.client.registration.google.client-secret=client_secret

== Install as a service ==
For Linux the official guide is here <nowiki>https://docs.spring.io/spring-boot/docs/current/reference/html/deployment.html#deployment.installing.nix-services.system-d</nowiki>

For Windows the official guide is here <nowiki>https://docs.spring.io/spring-boot/docs/current/reference/html/deployment.html#deployment.installing.windows-services</nowiki>

Examples of the configurations are in the binary distributive. The folders are “windows” and “Linux”.

== Provide access from the Internet ==
To provide access from the Internet it will be a good idea to establish a proxy gateway like Nginx or Apache2. The example of virtual server configuration for Apache 2 is in the binary distributive, folder “Linux”.

= IIS as a gateway for Spring Boot application =

== Redirect rules, URL rewrite module ==

== Special configurations ==
<nowiki>https://serverfault.com/questions/936922/setting-up-iis-reverse-proxy-to-preserve-host-headers</nowiki>

== Example of web.config for the default IIS site ==
<?xml version="1.0" encoding="UTF-8"?>

<configuration>

<system.webServer>

   <rewrite>

   <rules>

   <rule name="Reverse Proxy to www.pharmadexmz.org/mozambique" stopProcessing="true">

      <match url="mozambique/.*" />

   <conditions>

<add input="{HTTP_HOST}" pattern="^www.pharmadexmz.org$" />

   </conditions>

      <action type="Rewrite" url="<nowiki>http://localhost:8081/{R:0}</nowiki>" />

   </rule>

   <rule name="Reverse Proxy to www.pharmadexmz.org" stopProcessing="true">

      <match url=".*" />

   <conditions>

<add input="{HTTP_HOST}" pattern="^www.pharmadexmz.org$" />

   </conditions>

      <action type="Rewrite" url="<nowiki>http://localhost:8081/mozambique/{R:0}</nowiki>" />

   </rule>

   <rule name="Reverse Proxy to pharmadexmz.org/mozambique" stopProcessing="true">

      <match url="mozambique/.*" />

   <conditions>

<add input="{HTTP_HOST}" pattern="^pharmadexmz.org$" />

   </conditions>

      <action type="Rewrite" url="<nowiki>http://localhost:8081/{R:0}</nowiki>" />

   </rule>

   <rule name="Reverse Proxy to pharmadexmz.org" stopProcessing="true">

      <match url=".*" />

   <conditions>

<add input="{HTTP_HOST}" pattern="^pharmadexmz.org$" />

   </conditions>

      <action type="Rewrite" url="<nowiki>http://localhost:8081/mozambique/{R:0}</nowiki>" />

   </rule>

   <rule name="Reverse Proxy to eperm.pharmadexmz.org" stopProcessing="true">

      <match url=".*" />

   <conditions>

<add input="{HTTP_HOST}" pattern="^eperm.pharmadexmz.org$" />

   </conditions>

      <action type="Rewrite" url="<nowiki>http://localhost:8082/{R:0}</nowiki>" />

   </rule>

   <rule name="Reverse Proxy to anarme.pharmadexmz.org" stopProcessing="true">

      <match url=".*" />

   <conditions>

<add input="{HTTP_HOST}" pattern="^anarme.pharmadexmz.org$" />

   </conditions>

      <action type="Rewrite" url="<nowiki>http://localhost:8083/{R:0}</nowiki>" />

   </rule>

   <rule name="PViMS HTTP to HTTPS Redirect" stopProcessing="true">

      <match url=".*" />

      <conditions>

   <add input="{HTTPS}" pattern="^OFF$" />

      </conditions>

      <action type="Redirect" url="<nowiki>https://{HTTP_HOST}{REQUEST_URI}</nowiki>" appendQueryString="false" />

   </rule>

   </rules>

   </rewrite>

   <tracing>

   <traceFailedRequests>

   <add path="*">

   <traceAreas>

   <add provider="WWW Server" areas="Rewrite" verbosity="Verbose" />

   </traceAreas>

   <failureDefinitions timeTaken="00:00:00" statusCodes="404, 500" />

   </add>

   </traceFailedRequests>

   </tracing>

</system.webServer>

</configuration>
----[1] The theory is here <nowiki>https://developers.google.com/identity/protocols/oauth2</nowiki> The Pharmadex 2 uses the web-server applications scenario.

OpenRIMS-RPM - Installation Part 1

2022-06-17T23:35:28Z

Khoppenworth007: First version of deployment guide.

= Objective =
This document helps deploy Pharmadex 2 software first time, along with the demo database.

The audience of it is IT persons that are responsible to install and maintain the Pharmadex 2 software. Minimal qualification requirements are:

· Ability to install and configure programs and components in the selected Operation System.

· The MySQL knowledge.

== Pre-conditions ==
Regardless of deployment configuration selected, the following pre-conditions should be fulfilled:

· At least 2 GB of free RAM

· At least 10GB of free SDD/HDD

· Operation Systems:

o Windows Server 2016 and above

o Windows 10

o Linux, released after 2018. Tested on Ubuntu 18.04.4 LTS and above

· MySQL R 5.7

o Server

o Workbench

· Oracle Java JDK 1.8. OpenJDK 1.8 has been tested on Linux Ubuntu, but not Windows

· Internet connection. Properties of it should suit minimal requirements for Google Mail

· Binary Pharmadex 2 distribution (see below)

· Pharmadex 2 demo database (<nowiki>https://github.com/MSH/Pharmadex2/tree/main/database</nowiki>[1])

· The own, private Google Mail account

== Pharmadex 2 binary distribution ==
The possibility to build the Pharmadex 2 software directly from the source codes is possible, however is not covered by this document. However, this manual describes deployment from the binary distribution. For current, the MSH staff may get this distribution from the corporative GitHub, address is

The descriptions of binary components may be found in the respective file README.md

= Steps to deploy =

== Prepare to install ==
1. Install using the vendor’s deployment manual:

1.1. MySQL

1.2. Java JDK 1.8

2. Restore the demo database to MySQL using MySQL Workbench or the command line

3. Copy the binary application pharmadex2-0.0.1.jar and application.properties to the dedicated folder, e.g. applications/pharmadex2

== Configure ==

== Local TCP/IP port ==
In the application.properties file edit the values marked bold (if it will be necessary):

=== Database ===
In the application.properties file edit the values marked bold:

spring.datasource.url = jdbc:mysql://localhost/pdx2?useSSL=false&useUnicode=yes&characterEncoding=UTF-8&characterSetResults=UTF-8&'''serverTimezone=Europe/Kiev'''

spring.datasource.username = '''username'''

spring.datasource.password = '''password'''

=== Logs ===
In the application.properties file edit the values marked bold:

logging.file.path=/'''home/alexk/pharmadex/log'''

the good choice is:

'''logging.file.path= ./log/'''
----[1] This repository is not public yet.

Main Page

2022-06-16T02:51:44Z

Khoppenworth007:

[[File:Logo OpenRIMS.png|thumb]]
We are currently uploading all system documentation to this platform.

The process is estimated to conclude by August 2022.

This will go hand in hand with rebranding to OpenRIMS which logo is seen to the right.

== Tool Links ==
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]

File:Logo OpenRIMS.png

2022-06-16T02:48:27Z

Khoppenworth007: