GeneXus Cloud Unit Setup on Windows Server

The following is a list of requirements and steps required to Setup a GeneXus Cloud Unit in order to deploy .NET / SQL Server apps using GeneXus Cloud Deployment Services

 

Follow this steps:

For SQL Server configuration:

• If the SQL Server is on the same machine as the webapp server:
  • Install latest version if not installed
  • Enable Port 1433 (How to..)
  • Enable SQL Server Authentication (How to...)
  • Create an SQL Server login with roles 'public' and 'sysadmin'
  • Grant Roles 'sysadmin' and 'public' to NT AUTHORITY\SYSTEM
  • Give Read and Execute permission to "Everyone" on the folder C:\windows\temp\Gxcloud (if the folder doesn't exist, create it)
  • Ensure that Default SQL Collation is the correct one, or change it following these steps https://msdn.microsoft.com/en-us/library/ms179254(v=sql.120).aspx
    To store double byte (Unicode), use in GeneXus Enable national language support property
• If it's not:
  • On the SQL Server:
    • Ensure the SQL Server user that it was provided has this roles 'public' and 'sysadmin'
    • Ensure that Default SQL Collation is the correct one, or change it following these steps https://msdn.microsoft.com/en-us/library/ms179254(v=sql.120).aspx
      To store double byte (Unicode), use in GeneXus Enable national language support property
  • On the WebApp Server:
    • Give Read and Execute permission to "Everyone" on the folder C:\windows\temp\Gxcloud (if the folder doesn't exist, create it)

For the WebApp Server configuration:

• Go to: Server Manager, and click on Add roles and features
  • On Server Roles, select Application Server (If you are not working on Windows Server 2016 and higher) and Web Server        
  • On Features, select HTTP Activation under .Net 3.5 and 4.5
  • On Role Services (Application Server), select HTTP Activation
  • On Role Services (IIS), Select: HTTP Redirection, ASP, ASP 3.5 and 4.5, and IIS 6 Management Compatibility
  • Install:
    • URL Rewrite Module (How to...)
    • AWS SDK and tools for .NET https://aws.amazon.com/es/sdk-for-net/ (e.g. AWSToolsAndSDKForNet_sdk-2.3.34.0-ps-2.3.34.0-tk-1.9.2.2.msi)
    • SQL SMO (from: http://www.microsoft.com/en-us/download/details.aspx?id=42295) Install on this order :
      • ENU\x64\SQLSysClrTypes.msi
      • ENU\x64\SharedManagementObjects.msi
    • GeneXus Cloud Unit:
      • Download GeneXus Cloud Unit from https://marketplace.genexus.com/product.aspx?genexuscloudunit
      • Create the folder C:\GXcloudUnit
      • Unzip GeneXus Cloud Unit .zip file to that folder
      • Create a new site on IIS Server:
        • Go to IIS Manager
          • Create Application Pool 'gxcloud'
            • Enable 32 bits
            • RunTime: .Net 4.0
            • CPU.Limit: 8000
            • CPU.Action: KillW3wp
            • CPU.resetInterval:00:03:00
            • ProcessModel.identityType: LocalSystem
          • Create site
            • Port: 3532
            • Name: GXcloudUnit
            •  App pool: gxcloud
            • Pysical Path: C:\GXcloudUnit
      • Verify Installation
        • Execute on the same host:  http://localhost:3532/status

For the Firewall configuration:

• SQL Server Rules:
  • 1433 port to be accessed from Cloud Manager: IP 52.7.95.37
  • 1433 port to be accessed from the WebApp Server (if it's not on the same machine)
• WebApp Server Rules:
  • 3532 port to be accessed from Cloud Manager: IP 52.7.95.37
  • 80 port on the outbound rules, for the upload of backups to the AWS S3. 
  • 80 port open to all
  • 443 port open to all (if https is used)

 

Now you are able to add this unit to your cloud or send this information to GeneXus team:

• Public URL of the instance (e.g.: http://myapps.company.com )
• Public IP
• DBMS instance name.
• DBMS User and Password created in step 2.
• GeneXus Accounts that are allowed to deploy