Documentation

Why migrate to GXportal 6.0?

Table of content

Installation on Windows (.NET/SQLServer)

Requirements

Below are the minimum requirements to install and run the GXportal backend and frontend.

Basic software requirements for GXportal

  • Windows
    • Functional minimum: Windows Server 2008
    • Recommended minimum: Windows Server 2012
    • Recommended: Windows Server 2016
  • SQLServer
    • Functional minimum: SQL Server 2008 R2
    • Recommended minimum: SQL Server 2012
    • Recommended: SQL Server 2016

Architecture

  • Functional minimum: A single server with IIS, SQL Server and GXportal (backend and frontend)
  • Recommended minimum: Two servers, one for SQL Server and the other for IIS and GXportal (backend and frontend)

Hardware

  • Processor
    • Minimum: Intel Core i7
    • Recommended: Intel Xeon
  • Memory
    • Single-server architecture
      • Minimum: 16GB
      • Recommended: 32GB
    • Two-server architecture
      • Minimum: 8GB
      • Recommended: 16GB
  • Disk
    • GXportal programs take up 2GB
    • GXportal database
      • Small websites: 1GB average
      • Medium websites: 5GB average
      • Large websites: 10GB average
    • Website static resources: reserve a minimum of 2GB.

Installation

To install it, the file "gxportal_60_NET_SQLServer.zip" is used. Click here to download it.

Note: in these steps, the website domain used as an example is www.example.com and it must be changed to the corresponding website domain. The same happens with the passwords to be configured. The database name used is "gxportal60" and the username used is "gxportal60;" they can be changed.

Uncompress the GXportal zip file at "c:\gxportal60"

Configure the database connection:
gxportal.bat -connection -server <database server name> -instance <sqlserver instance> -database gxportal60  -user gxportal60 -password <password>
 
Create the database:
gxportal.bat -createDatabase -dbaUser sa -dbaPassword <sa_password> -dbPassword <user password gxportal60>

Create the tables:
gxportal.bat -createTables -dbPassword <user gxportal60 password>

Initialize the metadata:
gxportal.bat -import metadata -dbPassword <user gxportal60 password>

Deploy ASP.Net programs
gxportal.bat -deploy aspnet 

Install the license administrator:
gxportal.bat -deploy licmgr

Configure the IIS to access the backend:
gxportal.bat -deploy iis -backend 

Configure the protection:
gxportal.bat -protection -registerDB -dbPassword <user password gxportal60>

Install the most recent version of GeneXus Protection Server in the same server as GXportal. It can be obtained from here.

Request licenses with the license administrator located at c:\gxportal60\licmgr

Check the backend access by accessing to http://localhost/backend60 

Enter with the user gxpadmin and password gxp123 without specifying the website.

Change the user password gxpadmin from the menu option Security ´╝×Change password.

Create a new website, and create the website administrator user.

Configure the file URL as http://www.example.com/ and confirm that the multimedia file path is correct. It should be as follows: C:\inetpub\wwwroot\gxportal60\resources\<website>\ where <website> is the name given to the website when it was created.

Enable the ID column in the website grid to view the identifier assigned to the website created that will be required to deploy the frontend later on.

Close the gxpadmin user session and log in with the website administrator user to configure the website domain to the corresponding value. In this example: www.example.com. To this end, select the menu option Design´╝×Domains.

Return to the command line where the previous installation steps were executed to run the command that configures the IIS to access the website frontend: gxportal.bat -deploy iis -frontend -siteId <id. of the website created> 

If you selected some of the templates to initialize the website, you can publish it and try to access the configured domain to confirm that you can do so.