Category:GXportal 4.5

How to request GXportal licenses

GXportal Methodology

Here is detailed the methodology to build websites using GXportal.

How to manage GXportal Linux Licenses

Before requesting the licenses, the permissions of the file /licmgr/sc and the directories and /licmgr must be changed. First, replace the owner group with the group of the user you use to run the servlet server. Next, assign the “rwx” permissions to the user and the group, and remove all permissions from the others.

For example:

chgrp licmgr/
chmod 770 licmgr/

where:
= Name of the group of the user you use to run the Web server.

Go to the login page of the GXportal backend to have the /licmgr/System directory generated. Once this is done, you need to confirm whether the System directory has been created.
Finally, start a session with the root user and request the licenses.

Requesting licenses

In order to request licenses, the license request file must be generated. Upon generating this file, it must be sent to the local distributor with the following information:

Name of the Company
Email address to receive the file containing the product keys
Number of licenses per product
Type of license (limited or unlimited)
Number of days

To generate the license request file, the following command must be used:

./licmgr.sh –r …

where:

= File name that will be generated “.gxa” extension.
= Products id list, separated by space. In order to see the products list use this command: ./licmgr.sh -d

Entering licenses

Upon receiving the file containing the activation keys, you must activate the products. In order to do this, the following command must be used:

./licmgr.sh –e

where:
= Name of the key files.

./licmgr.sh –u

where:

= ID of the product for which the licenses will be uninstalled.
= Number of licenses that will be uninstalled.

Next, the uninstall code is displayed; it must be sent to the local distributor.

Viewing installed licenses

To view the licenses currently installed, the following command must be used:

./licmgr.sh –d

Next, the following information is displayed about each product:

Product ID
Name
Version
Status
Start date
Copies
Type of license
Restrictions

Common mistakes when authorizing GXportal in Linux

Error (8) : The product is not registered

Cause: The license file was generated with a user other than the root user.

Solution: Generate the license request again with the root user.

Error (5) : The license limits are not the same as those already installed (Days)

Cause: Valid licenses are currently installed for a certain number of days and a request has been made for a different number of days. For example, 1 GXportal Standard license for 60 days is installed (the days it has been used are not considered) and another one is requested for 90 days.

Solution: Generate the license request again, indicating the same number of days as the licenses already installed. In this example, it should be requested for 60 days.

How to manage GXportal Linux Licenses

For example:

chgrp licmgr/
chmod 770 licmgr/

Name of the Company
Email address to receive the file containing the product keys
Number of licenses per product
Type of license (limited or unlimited)
Number of days

To generate the license request file, the following command must be used:

./licmgr.sh –r …

Donde:

= File name that will be generated “.gxa” extension.
= Products id list, separated by space. In order to see the products list use this command: ./licmgr.sh -d

Entering licenses

Upon receiving the file containing the activation keys, you must activate the products. In order to do this, the following command must be used:

./licmgr.sh –e

where:
= Name of the key files.

./licmgr.sh –u

where:

= ID of the product for which the licenses will be uninstalled.
= Number of licenses that will be uninstalled.

Next, the uninstall code is displayed; it must be sent to the local distributor.

Viewing installed licenses

To view the licenses currently installed, the following command must be used:

./licmgr.sh –d

Next, the following information is displayed about each product:

Product ID
Name
Version
Status
Start date
Copies
Type of license
Restrictions

GXportal Methodology

A continuación se detalla la metodolgía para construir sitios web con GXportal.

How to manage GXportal Linux Licenses

For example:

chgrp licmgr/
chmod 770 licmgr/

Name of the Company
Email address to receive the file containing the product keys
Number of licenses per product
Type of license (limited or unlimited)
Number of days

To generate the license request file, the following command must be used:

./licmgr.sh –r …

Donde:

= File name that will be generated “.gxa” extension.
= Lista de Id de productos separada por espacios.Para ver la lista de productos se debe utilizar el comando ./licmgr.sh -d

Entering licenses

Upon receiving the file containing the activation keys, you must activate the products. In order to do this, the following command must be used:

./licmgr.sh –e

donde:
= Name of the key files.

Next, a summary of the information contained in the file is displayed and the user is asked to confirm the license installation. To install it, press "y" and to cancel, press "n".

Uninstalling licenses

To uninstall a license, the following command must be used:

Next, the uninstall code is displayed; it must be sent to the local distributor.

Viewing installed licenses

To view the licenses currently installed, the following command must be used:

Next, the following information is displayed about each product:

Product ID
Name
Version
Status
Start date
Copies
Type of license
Restrictions

Migration of GXportal .NET SQL2000 to 2008

To migrate a GXportal .NET installation whose DBMS is SQL Server 2000 to SQL Server 2008, follow the steps below:

Download the corresponding setup for this environment from here.

Follow the instructions provided in this installation manual. Once it has been installed, upon accessing the backend you will not have any licenses because they will be transferred only after validating the migrated website.

IMPORTANT: The server in which SQL Server 2008 is installed must have Sun JVM 1.6 or higher installed. To verify this requirement you can run the following command on Windows: java -version.

Next, you have two options –either to open a backup of the entire database or make an import/export of the portal.

To make an import/export, download the corresponding applications for SQL2000 (export) and 2008 (import) from here.
To open the entire database, follow the steps below:
1. We assume that you have a backup file called "dbdummybackup.bak" created with SQL 2000. Open SQL Server Management Studio 2008.
2. Right-click on the gxportal database and select the option labeled Tasks – Restore Database.
3. In the dialog box that is displayed, select the "From Device" option and look for the "dbdummybackup.bak" file in your disk.
4. Select the check box of the backup file to be opened.
5. From the menu on the left, choose the "Options" option, select the option labeled "Overwrite the existing database," and where it says "Restore As" make sure that both paths at the end read gxportal_Data.MDF and gxportal_Log.LDF.
6. Confirm.
7. After opening the database, run the following SQL query so that the gxportal user defined for that database takes the gxportal login defined in that SQL Server: Exec sp_change_users_login 'update_one', 'gxportal', 'gxportal'
8. Lastly, copy the website’s image directory (C:\Inetpub\wwwroot\gxportal\gxpfiles\), and in the new server where they will be hosted, set up the new multimedia paths in the backend.

To validate the website, you need to change the domain so that it points to the new server. Once it has been validated, transfer the licenses to the new server following the manual downloaded in step 2.

How to manage Windows GXportal licenses

GXportal Authorization with GXProtection 2000

GXportal requires licenses to be used with its full functionality. The keys activation is based on a protection mechanism called ‘GXProtection 2000’.

GXportal uses protection per portal: this means that for each portal that you want to build you must contract a license. This license will allow you defining one user to access the Backend, which will be enabled to administrate the portal.

Besides, GXportal uses protection per additional users with roles to access the Backend: that is to say, if you want to define more users with roles concerning the portal building or maintenance, you will have to contract additional licenses, which will be assigned by the GXportal administrator user for each portal.

IMPORTANT: Regardless of whether you are a new GXportal user or not, you must authorize your GXportal product.

Once you have finished GXportal installation, you will have to run the GXPORTAL License Manager to obtain the rights to use the products.

Note: Licenses are not lost when uninstalling the product. They remain active in the PC where they were authorized. Before removing the product, it may be useful to backup the GXLmgr.exe to be able to uninstall, transfer, etc. the licenses afterwards.

To authorize GXportal you must run the GENEXUS License Manager program located in Gxportal programs menu, or the GxLMgr.exe located in the directory where Gxportal was installed (by default: C:\Program Files\ARTech\GXportal\LicMgr)

The following dialog will be displayed on running it:

At the top you must indicate the place where the licenses are being taken from (this is setup in Select Computer).

All components requiring authorization corresponding to the product from which License Manager is being run are displayed in the box (the previous box corresponds to all GXportal components).

The current license status is shown for each component or product. It may have the following values:

If it is authorized, you can also visualize the starting date, the number of copies, the level of execution and constraints.

Authorize

Three types of authorizations can be granted:

Full Authorization (initial authorization)
Increase the number of users
Change constraints (e.g.: increase due date)

To execute any of these functions you must follow the steps below:

You may ask for the keys in 3 different ways. There follows the detail of each one of these possibilities and the steps required from the wizard:

Option 1. Request through the Web:

Step 1. Press Authorize.

Step 2. Select Request Licenses.

Step 3. Select Authorize by web.

Step 4. Select all the products to be authorized and Press Finish.

Step 5. A form will be displayed (in the web) to complete the request.

This is the recommended option if you have an Internet connection available.

Option 2. Send .gxa file:

Step 1. Press Authorize.

Step 2. Select Request License.

Step 3. Select Generate Authorization File.

Step 4. Select all the products to be authorized and Press Finish.

Step 5. You must send this file to your local distributor.

Option 3. Obtain site codes manually:

Step 1. Press Authorize.

Step 2. Select Enter License.

Step 3. Select Manual Authorization.

Step 4. The Site Code corresponding to each selected product will be displayed.

Once you have received the activation keys, you must proceed with the products activation. You have three options to activate the keys. If you receive the .gxa file with the keys, you can use any of the first two options. If you receive the codes directly (site keys), you must use the 3rd option.

Option 1. Automatic activation

Copy the file to a directory of the PC where the keys were requested and double click on it from that PC. After a while, a screen will be displayed indicating the operation status.

Option 2. Activation from License Manager

Step 1. Press Authorize.

Step 2. Select Enter Licenses.

Step 3. Select Authorize from file.

Step 4. Select the file and Press Finish. A screen will be displayed showing the operation result.

Option 3. Manual Authorization

If instead of receiving the .gxa file with the keys, you have received the site Key directly:

Step 1. Press Authorize.

Step 2. Select Enter License.

Step 3. Select Manual Authorization.

Step 4. Select one of the products to be authorized, enter the Site Key and Press Confirm.

Repeat the operation for each product to be authorized.

Note: Incrementing the number of users and changing constraints at the same time is not possible (with the same Site Code).

Direct Transfer

This option provides the possibility of transferring one or several options from a PC or protection server to another server located in the same network. The target server must be a protection server; i.e.: it must have the ‘ProtSrvService’ installed and started.

Steps to perform the transfer:

Get connected to the source PC; i.e.: through Select Computer, get connected to the location of the license to be transferred. If the license to be transferred is in a PC, the Direct Transfer must be performed from this PC. If the license is in a server, the transfer may be performed either from the target server or the source server.
Press the Transfer button in the License Manager, select the “Direct Transfer” option, enter the name of the target Server and the number of copies to be transferred and press OK.
If everything goes normal, a message will be displayed indicating so.

Remote Transfer

This method is used to transfer one or several licenses between any two machines. It may be between two servers, two PCs, a Server and a PC or vice versa.

Below you will find the 3 Steps to be followed to perform this type of transfer. They must be executed in the order they appear below.

a. Run GXPORTAL License Manager in the target PC (where you want to install the license).

b. Select the product and press Transfer.

c. Then select the Register Transfer option, enter the path and file name (with .trf extension) requested in the dialog; e.g.: A:\develop.trf, and press OK. Bear in mind that you can put registration files of several products in the same directory or diskette, indicating a different name for each of them.

Transfer Out

a. Run GXPORTAL License Manager in the source PC (where the license is currently).

b. Select the product (it must coincide with the one selected in the first Step) and press Transfer.

c. Then select the Transfer Out option, select the number of licenses to be transferred, select the transfer file corresponding to the selected product and press OK. If everything goes normal a message will be displayed indicating so.

Transfer In

a. Run GXPORTAL License Manager in the target PC.

b. Select the product (it must coincide with the one selected in the first Step) and press Transfer.

c. Then select the Transfer In option, select the transfer file corresponding to the selected product and press OK. If everything goes normal a message will be displayed indicating so.

Uninstall

You can uninstall any of the products that were previously installed.

For this, you must run GXPORTAL License Manager, select the product and press Uninstall. A dialog will be displayed that will allow you selecting the number of licenses you want to uninstall.

Once the action has been confirmed, the uninstall code is displayed. It must be sent to your Distributor.

Log Settings

The “log” is used to keep a trace of each operation performed, which will allow performing a diagnosis in case of failure.

In the setup you have the option of saving the trace or not. If you decide to save the Trace, the Log File will be used, and you can determine the log file path and name.

License expiration date reminder

If the product is authorized with temporary licenses, when there are 10 days left for the expiration date a screen reminding so will be displayed when running the application.

This may be useful to renew the license before its expiration.

On that screen you may choose the action you want to execute as from that moment. The possible values are:

Leave the reminder as-is

If you select this option, the message will continue appearing each time you use the product until the license expires or is renewed.

Dismiss the reminder

If you select this option the reminder will no longer appear.

Remind me again in n days

If you select this option the reminder will not appear until the selected day.

Constraints

Performing a Direct Transfer to a PC is not possible. In this case, you must use Remote Transfer. You can only perform a Direct Transfer to the server (from a PC or another server) with GENEXUS Protection Server installed.

Setting out the content details page

The details page used in the “see more” contents function can be automatically generated by GXportal. You can also use a customized page created to be used as
such.

The automatic details page inherits the header of the page from which “see more” was clicked and shows the content details in the rest of the page taking the format to display this detail from the properties of the content GXportlet where the content is located.

The customized detail page can be created and designed the way you need it. To use it, you can associate it to the GXportlet where the contents are being published, at page level or at a channel template level. If you associate it to the pages, when you click on “see more” on any of the page contents, the customized detail page will be displayed to show the content details. If you associate it to the template, the pages that are inheriting from the template will inherit this detail page and all the contents of these pages will be shown on the detail page in the same way. Lastly, if you associate it to a specific GXportlet, only the contents published there will be shown in the selected detail page.

Steps to create a content details page:

Create a Content Details Page: To create a new Content Details Page you must click on the + button farthest to the left (Create New Page) on the “Pages Design” screen. Then, you must select the “Content Details” option and assign a name to the page.
Design a content details page: like with any other page, you must work editing the regions and sectors you want to visualize on this page according to the design you want. Specifically, when creating this page, it is initialized with a GXportlet that will be used to show the content detail.
Associate the content details page: Once the content details page has been created you must decide if you want to associate it at GXportlet, page or template level.
1. To associate it to a template you must click on the template Update option from the “Pages Design” screen. Then, in the advanced options you must select the Content Details page you created in the previous step. Make sure both pages are in the same channel.
2. To associate the content details page to a specific page you must follow the same steps described in the previous paragraph to associate it to a template.
3. To associate the Contents Details page to a specific content GXportlet you must go to the properties of this GXportlet and from the “See more” properties group you select the link to the “Page” property details page.