Install Guide - Gemini .NET Core For Windows

image20.png

TABLE OF CONTENTS

GEMINI FOR WINDOWS 

GEMINI FOR WINDOWS

The following steps will determine how Gemini .NET Core can be installed on the Windows Server environment.

Install IIS

Steps to install IIS:

1. Launch the Server Manager application by searching for ‘Server Manager’ and selecting it.

      image5.png

Figure 2: Launching the Server Manager application.

 

2. Within Server Manager click Manage > Add Roles and Features.

image11.png

Figure 3: Selecting Add Roles and Features from the Server Manager application.

 

3. Click Next at the “Before you begin” page of the wizard.

image18.png

Figure 4: Add Roles and Features Wizard: Before you begin

 

4.  Select ‘Role-based or feature-based installation’ and click Next.

image19.png

Figure 5: Add Roles and Features Wizard: Select installation type

 

5. Select the appropriate server. The local server is selected by default. Click Next.

image3.png

Figure 6: Add Roles and Features Wizard: Select destination server

 

6. From the Server Roles page select Web Server (IIS) and then click Next.

image4.png

Figure 7: Add Roles and Features Wizard: Select server roles

 

7. Click the Add Features button on the Add Roles and Features Wizard pop-up window.   Then click Next.

image16.png

Figure 8: Add Roles and Features Wizard dialog box

 

8. From the Features page, expand the .NET Framework 4.6 Features option and enable the ASP.NET 4.6 option. Click Next.

image13.png

 Figure 9: Add Roles and Features Wizard: Select features

 

9. From the Web Server Role (IIS) page, click Next.

image14.png

Figure 10: Add Roles and Features Wizard: Web Server Role (IIS)

 

10.  From the Role Services page verify that the following options are enabled and then click Next.

  • HTTP Errors
  • Static Content
  • .NET Extensibility 3.5
  • .NET Extensibility 4.6
  • ASP
  • ASP.NET 3.5
  • ASP.NET 4.6
  • CGI
  • ISAPI Extensions

image17.png

image8.png

Figure 11: Add Roles and Features Wizard: Web Server Role (IIS)

 

11. From the Confirmation page click Install.

image7.png

Figure 12: Add Roles and Features Wizard: Confirm installation selections

 

12. At the Installation progress page, confirm a successful installation, and then click Close.

image12.png

Figure 13: Add Roles and Features Wizard: Installation progress

 

Install .NET 3.1.0

In order to run Gemini on a Windows Server, either Dotnet Core version 3.1.0, which can be found here or the SDK version needs to be installed.

 

Copy the provided files to the Windows server

During this step, the provided files will need to be copied to the Windows server to the following directory: C:\GeminiCore.

 

Adding The Connection Strings

The connection strings need to be added for GeminiCoreOfflineWebUI, GeminiCoreWeb, and Services.

Gemini Service Connection Settings

  1. Access the Gemini Service directory, by navigating to C:\GeminiCore\Service
  2. Open the file “appsettings.json” in a text editor.
  3. Update the Connection String information to point to the appropriate Oracle Database:
"AppDBConnectionStringName":  "test100"

"connectionStrings": {

"test100": "Data Source=test100.database.com/test100;pooling=false;User ID=username;password=password"}

 

Gemini Core Online Web Connection Settings

  1. Access the Gemini Online Web directory, by navigating toC:\GeminiCore\GeminiCoreWeb
  2. Open the file “appsettings.json” in a text editor.
  3. Update the Connection String information to point to the appropriate Oracle Database:
"AppDBConnectionStringName":  "test100"

"connectionStrings": {

"test100": "Data Source=test100.database.com/test100;pooling=false;User ID=username;password=password"}

 

Gemini Offline Web Connection Settings

  1. Access the Gemini Service directory, by navigating to C:\GeminiCore\GeminiCoreOfflineWebUI
  2. Open the file “appsettings.json” in a text editor.
  3. Update the Connection String information to point to the appropriate Oracle Database:
"AppDBConnectionStringName":  "test100"

"connectionStrings": {

"test100": "Data Source=test100.database.com/test100;pooling=false;User ID=username;password=password"}

 

Set License

IMPORTANT: In order to receive a license key, be sure to forward the name of your Windows computer to the Aclate team.

The computer name can be easily determined from the command prompt. To locate the computer name:

1.      Open a command prompt and type Set and press Enter. Look for COMPUTERNAME= (it should be one of the top 5 or 6 entries). The text following the equal to (=) character will be the computer name.

After you forward the name of your Windows computer to the Aclate team, we will send you two pieces of data: (1) The license key and (2) The service GUID.

The license key will consist of a long string of characters, such as the one below:

gKoQNtVDm2DXomSSo4iF5gNRw9jAiFSQpbpHvG0C3OxKMTfR5h9u693Wi pF3ijk56mIS2iixxbamHlqByLa47BM5vQFDncg/ eGz9Ky4ct0wW3h1IE6jT9uWwlfvAQQB1aYfOWxTrlIOaQLPTe13qc8Ocr 7kb2y8XtQWvwJO+gnpK1gMZxSoWw8Yi55GBEMCcA4f07EJVlh2WeGB- jlXV1pTi+vDSHo/yYLSByLw==

The service GUID will be a 36-character length string like the following:

D245983C-67FC-4923-AA19-3F048C495E8B

2.       Start Notepad++ as an administrator and open the “RadrLicense.json” file from the C:\GeminiCore\Service folder.

3.       Replace the current value {LicenseKey} with the complete license key received. NOTE: Be sure to remove the braces {} when replacing value.

4.       Save and close the file.

5.       Start Notepad++ as an administrator and open the “appsettings.json” file.

6.       Replace the current value {ServiceGUID} with the Service GUID received. NOTE: Be sure to remove the braces {} when replacing value.

7.       Save and close the file.

 

Create Gemini Service

Create the new service file by opening the command manager in Windows and running the following command:

\> sc create GeminiCoreService BinPath=C:\GeminiCore\Service\TAKE.GemRadr.Service.exe

After the Gemini Service has been created, the Service Manager will need to be opened as an administrator.

The next step would be to check the Log On properties of the GeminiCoreService, to make sure that the credentials are correct.

Lastly, the GeminiCoreService will need to be started.

 

Create Web Sites

To create websites IIS Manager will need to be opened first.

Each web site will need to have its own application pool created. For this, you will need to go to Application Pools in IIS Manager and create separate application pools for each web site.

After the application pools have been added, you will need to create the web sites for each service, under the Default Web Site. 

Please make sure that the correct name, application pool, and physical path are set when creating a new website.

 

GeminiCoreWeb

The following settings will need to be made for the GeminiCoreWeb application:

image6.png

 

GeminiCoreWebUI

The following settings will need to be made for the GeminiCoreWebUI application:

image2.png

 

GeminiCoreOfflineWeb

The following settings will need to be made for the GeminiCoreOfflineWeb application:

image9.png

 

Gemini WebUI: <Windows Server IP>/GeminiCoreWebUI

Gemini Web:     <Windows Server IP>/GeminiCoreWeb/Pages/Login.html

Gemini Offline:  <Windows Server IP>/GeminiCoreOfflineWebUI

 

Gemini Service URL for Mobile Devices:

For the .Net core version, the Windows Server IP followed by the name of the service is the URL that needs to be entered on a mobile device for the service to work:

Both Gemini Online and Offline use the same URL for the mobile application.

E.g. http://<Windows Server IP>/GeminiCoreWeb

Comments

0 comments

Please sign in to leave a comment.