License Manager

License Manager

License Manager is a utility that registers additional products, country-specific functionalities, and languages for your Oracle E-Business Suite system. Once you have contacted your Oracle sales representative, or set up your new license agreements online through the Oracle Store, you are ready to register your new products, country-specific functionalities or languages using License Manager. License Manager does not set up license agreements or determine pricing, but the registration procedure makes new components accessible to all Oracle E-Business Suite utilities.

Related to licensing is the subject of localizations, of which there are several types. This area is covered briefly at the end of the chapter.

License Manager also provides a set of reports that allows you to determine the products, country-specific functionalities and languages that are registered on your Oracle E-Business Suite system.

The main License Manager page contains three main licensing links and five report links. The licensing pages are:

Important: Before using License Manager to license products, create a complete backup of the Oracle E-Business Suite instance, that is, both the database and application tiers. Thus, if required, the instance can be restored back to the state prior to licensing the products.

Also, be careful when selecting the products to be licensed. Once the products are licensed there is no supported way to un-license those licensed by mistake. The only supported way to un-license a product or products is to restore the complete Oracle E-Business Suite instance from last valid backup.

The five report links that provide licensing details about your Oracle E-Business Suite system are:

See also: Applications Usage.

License Section

This section contains links to license products, country-specific functionalities, and languages.

License Products

Clicking the Products link in the License section of the License Manager main page opens the License Products page. This page displays two options and a link to show more options.

Select the desired option and click Continue.

License E-Business Suite

Selecting License E-Business Suite in the Product Licensing page opens the License E-Business Suite page. This page displays all products that will be registered when you choose to register the "E-Business Suite". Once the E-Business Suite is registered, individual products within the suite cannot be unregistered. This page displays all products that can be registered and contains three columns of information:

Click Next to move on to the License E-Business Suite Add-ons page.

License E-Business Suite Add-ons

The License E-Business Suite Add-ons page lists the products that are not included in the standard "E-Business Suite" list of products. Select the E-Business Suite Add-on products on this page. This page contains three columns of information:

To register all E-Business Suite add-ons, click the Select All link. To deselect all selected E-Business Suite add-ons, click the Select None link. Once an E-Business Suite add-on is registered, it has a check box that is disabled and cannot be unregistered.

Click Next to advance to the License E-Business Suite Review page.

License E-Business Suite Review

Navigation: Site Map (Administration) > License Manager > Products > License E-Business Suite

The License E-Business Suite Review page lists the products that you selected to register in the License E-Business Suite and License E-Business Suite Add-ons pages. This page contains two columns of information:

Click Submit to register the products.

License Component Application

Selecting License Component Application in the Product Licensing page opens the License Component Application page. This page displays all component applications that can be registered and contains three columns of information:

To register all component applications, click the Select All link. To deselect all selected component applications, click the Select None link. Once a component application is registered, the individual products within the component application have check boxes that are greyed out and cannot be unregistered.

Click Next to advance to the License Component Application Review page.

License Component Application Review

The License Component Application Review page lists the products that you selected to register in the License Component Application page. This page contains two columns of information:

Click Submit to register the products.

License Applications Products

Selecting License Applications Product in the Product Licensing page opens the License Applications Products page. This page displays all products in the Oracle E-Business Suite system and allows you to register them individually.

To register all products, click the Select All link. To deselect all selected products, click the Select None link. Once a product is registered, it has a check box that is grayed out and cannot be unregistered.

Click the check box of the products that you want to register and click Next. This takes you to the License Applications Products Review page.

License Applications Product Review

The License Applications Products Review page lists the products that you selected to register in the License Applications Products page. This page contains two columns of information:

Click Submit to register the products.

License Country-specific Functionalities

Selecting Country-specific Functionalities in the License section of the License Manager main page produces the License Country-specific Functionalities page. This page displays all country-specific functionalities in the Oracle E-Business Suite system and allows you to register them. This page contains three columns of information:

Once you select the country-specific functionalities that you want to register, click Next. This takes you to the License Country-specific Functionalities Review page.

License Country-specific Functionalities Review

The License Country-specific Functionalities Review page lists the country-specific functionalities that you selected to register in the License Country-specific Functionalities page. This page contains two columns of information:

Click Submit to register the country-specific functionality.

License Languages

Selecting Languages in the License section of the License Manager main page opens the License Languages page. This page displays all languages available for the Oracle E-Business Suite system and allows you to register them. This page contains these columns of information:

Click the check box of the languages that you want to register and click Next. This takes you to the Base Language page.

Base Language

The Base Language page shows the current base language and list of languages that you can select as a base language for your Oracle E-Business Suite system.

The Current Base Language section contains one row and two columns of information:

The Select New Base Language section contains a row for each registered language and three columns of information:

Click Next to continue to the License Languages Review page.

License Languages Review

The License Languages Review page lists the languages that you selected to register in the License Languages page and the base language that you selected in the Base Language page.

The Selected Languages section contains a row for each language you want to register and these columns of information:

The Base Language section contains one row and two columns of information:

The Translation Mode section lists the language(s) that will either remain or be installed with the associated translation mode.

Click the Submit button to register the languages and set the base language and territory.

Reports Section

This section contains links to reports.

Licensed Products Report

Clicking the Licensed Products link in the Reports section of the License Manager main page produces the Licensed Products report. The report has two sections. The first section, Summary, shows the Status information. Status is the number of products installed and the number of products shared. Clicking on one of these status groups refreshes the second section of this report, List of Products according to the status selected.

Depending upon which group (Licensed or Shared) you clicked in the Summary section, the List of Products changes to show all licensed products or all shared products in the system. The List of Products section has four columns:

A filter at the top of the List of Products section allows you to narrow the contents of the report. You can filter by Product Abbreviation, Product Name, or (license) Status. For Status, you can choose from Licensed, Shared, or Not Licensed.

From this report you can access the Patch Information page for a specific product by selecting the product and clicking the Patch Information button, or by clicking the Product Name.

Shared Products Report

Clicking the Shared Products link in the Reports section of the License Manager main page produces the Shared Products report. The report has two sections. The first section, Summary, shows the Status information. Status is the number of products installed and the number of products shared. Clicking on one of these status groups refreshes the second section of this report, List of Products according to the status selected.

The List of Products section has four columns:

A filter at the top of the List of Products section allows you to narrow the contents of the report. You can filter by Product Abbreviation, Product Name, or (license) Status. For Status, you can choose from Licensed, Shared, or Not Licensed.

From this report you can access the Patch Information page for a specific product by selecting the product and clicking the Patch Information button, or by clicking the Product Name.

Country-specific Functionalities Report

Clicking the Country-specific Functionalities link in the Reports section of the License Manager main page produces the Country-specific Functionalities report. This report displays all registered country-specific functionalities in the Oracle E-Business Suite system and contains two columns of information:

Clicking OK on the report returns you to the main License Manager page.

Clicking Edit takes you to the License Country-specific Functionalities page.

Languages Report

Clicking the Languages link in the Reports section of the License Manager main page produces the Languages report. This report displays the current database character set, the base language, and all registered languages.

The Licensed Languages section contains a row for each registered language and two columns of information:

The Base Language section contains one row and two columns of information:

The Current Lightweight Languages section contains languages that are licensed with the lightweight translation mode.

Clicking OK on the report returns you to the main License Manager page.

Clicking Edit takes you to the License Languages page.

License Summary Report

Clicking the Summary link in the Reports section of the License Manager main page produces the License Summary report. This report displays a summary of all registered products, country-specific functionalities, languages, and base language. There are five sections in this report.

The Licensed Products section contains a row for each fully licensed product registered in the system and two columns of information:

The Shared Products section contains a row for each shared product registered in the system and two columns of information:

The Country-specific Functionalities section contains a row for each registered country-specific functionality and two columns of information:

The Licensed Languages section contains a row for each registered language and two columns of information:

The Base Language section contains one row and two columns of information:

Localizations

Related to licensing, country-specific functionalities known as localizations provide the required business processes to meet the statutory, legal, and cultural practices of a given locality.

There are three types of localization:

These three types of localizations are activated differently in Oracle E-Business Suite. Only product localizations can be activated via Rapid Install or License Manager. Add-on localizations and partner localizations are installed via special procedures created by regional teams and partners.

For more information about localizations, refer to My Oracle Support Knowledge Document 973912.1, Oracle E-Business Suite Globalization Center.

Understanding and Managing Licensing Options in Oracle E-Business Suite

Oracle E-Business Suite applications products can be activated from Rapid Install or from License Manager within Oracle Applications Manager.

From Rapid Install, applications products can be activated for the following license models:

Licensing Selection Page

the picture is described in the document text

From Licensing Manager, applications products can be activated as follows:

Products Page

the picture is described in the document text

Licensing E-Business Suite

This option is used to register a predefined set of Oracle E-Business Suite applications products. This licensing model allows wide access to applications functionality and will automatically register all applications products included in Oracle E-Business Suite.

The applications products that are preselected are licensed automatically as a part of the suite. The ones that are not checked are usually not part of the Oracle E-Business Suite price bundle and must be registered separately as add-on products.

Licensing Page

the picture is described in the document text

License Component Applications

This option is used to register applications products by component applications. You should choose this option in your licensing agreement is for individual applications component products.

These products are licensed based on the number of authorized users or on the number of business transactions process. All individual applications products are listed on this screen.

Licensing Page for Component Applications

the picture is described in the document text

License Applications Products

This option is only available through License Manager in Oracle Applications Manager, and allows you to register individual Oracle E-Business Suite applications products. This option is generally used for off-cycle products (those that are released between release update packs) or for products not explicitly included in the product family groupings.

Applications Products Page

the picture is described in the document text

Licensing Manager does not set up license agreements or determine pricing, but performs the registration procedure that makes new components accessible to all Oracle E-Business Suite utilities. License Manager simply applies the logic defined by the Oracle Pricing guidelines.

Contact your sales representative if you have any questions about the most appropriate licensing options for your organization.

Activating Oracle E-Business Suite Products

Rapid Install lays down the files for all Oracle E-Business Suite applications products regardless of their license status. However, the products must be marked as licensed so they can be identified as active components of Oracle E-Business Suite. This information is stored in the STATUS column in the FND_PRODUCT_INSTALLATIONS table.

You can check the status by running the following query with the APPS account in SQL*

set pages 20000;
col application_id for 9999;
col application_name for A50;
col status for A1;
col application_short_name for A10;
select fa.application_id,
fa.application_short_name,
fpi.status,
fatl.application_name
from
fnd_product_installations fpi,
fnd_application fa,
fnd_application_tl fatl
where
(
fa.application_id = fpi.application_id and
fa.application_id = fatl.application_id and
fatl.language = 'US'
)
order by fa.application_short_name;

The possible values for STATUS are:

There is both a functional and technical impact in Oracle E-Business Suite when activating applications products in the FND_PRODUCTS_INSTALLATIONS table.

Note: As a best practice and to avoid any functional issues, always perform a full backup of your Oracle E-Business Suite database before activating any product.

Product Dependencies

When processing a product, Rapid Install and License Manager automatically calculate the dependencies with other products and set all dependent products to Shared or Fully Installed if needed.

The product dependencies are constructed by using the following files:

RapidWiz.ini and adlicmgr.ini

Used by Rapid Install, RapidWiz.ini is located under <Stage>/startCD/Disk1/rapidwiz.

The counterpart of RapidWiz.ini, adlicmgr.ini is used by the License Manager component of Oracle Applications Manager. This file is located under $AD_TOP/resource in Release 11i, and under $AD_TOP/admin/template in Release 12.x. The files differ only in that RapidWiz.ini contains additional information for the exclusive use of Rapid Install.

The [Product Groupings] section in these files includes the list of the application IDs for the products that will be activated when selecting each family.

For example:

Financials={101,140,200,222,240,260,600,8400,8401,8450,8901,231,673} 

The above application IDs correspond to the following Oracle E-Business Suite applications:

GL,OFA,AP,AR,PN,CE,AX,IGI,PSB,PSA,FV,BNE,IBY

Note: The application IDs and corresponding application short names can be obtained from the APPLICATION_ID and APPLICATION_SHORT_NAME columns in the FND_APPLICATION table.

applprod.txt

This file is located under $APPL_TOP/admin, and contains all the dependency information between Oracle E-Business Suite applications products. This file dictates which other dependent products will be set as Fully Installed or Shared when selecting a particular product.

The following example shows the dependencies for Oracle Payables in bold.


# ##################################################

# Payables

# ##################################################

#

# application id, abbreviation, shortname, prefix

200 ap SQLAP APP

# multiple product installations for msob, "controlled release", shared only

# optional fourth field is "stub product". default is No

Yes No No No

# multilingual, has NLADD.sql

Yes Yes

# install oracle id, default ORACLE username, default ORACLE password

200 AP AP

# concurrent conflict set id (logical database id)

0

# minimum version you can upgrade from, for shared and for fully-installed

8.0.57 8.0.57

# shared products; this lists fnd and some subset of:

fnd ax ak az gl inv po fa ar ont as per pay mfg bom eng wip pa dt xla ce qa crp mrp ff

# product libraries needed for "make -f <product>.mk all"

fnd alr inv bom crp eng mrp wip po gl ar pay ff dt ap fa

# when install this product, set these other products to install

ax ak az

# requires that these other products are fully installed or installing

ax ak az

#

Product Families and Product Activation

When you perform a new installation, you will first select a product family, which in turn will ultimately activate products that are included in that particular family.

When you choose the License E-Business Suite option, License Manager will look at the following entry in adlicmgr.ini:

[Suite Products]
Suite Families={Basic,Marketing & Sales Intelligence,Supply Chain & Order Management Intelligence,Procurement Intelligence,Service Intelligence,Projects intelligence,Financials Intelligence,Balanced Scorecard,Enterprise Planning and Budgeting,Profitability Manager,Marketing,TeleSales,Field Sales,Order Management,Inventory Management,Purchasing,Discrete Manufacturing,Process Manufacturing,TeleService,Service Contracts,Project Costing,Project Billing,Financials,Human Resources} 

When you choose the License Component Application option, License Manager will look at the following entry in adlicmgr.ini:

[Product Families]
All Families={All,Intelligence,Marketing & Sales,Channel Revenue Management,Order Management,Logistics,Supply Chain Planning,Procurement,Manufacturing,Asset Lifecycle Management,Service,Projects,Product Lifecycle Management,Financial,Human Resources,Learning Management,Master Data Management - Customer Hub for B2B,Master Data Management - Customer Hub for B2C,Master Data Management - Site Hub,Master Data Management - Administrative & Development,Master Data Management - Product Information Management,Master Data Management - Vertical Product Hub,Product Hub Options,Interaction Center Technology,Financial Services,Communications/Utilities,Public Sector/University,High Tech,Aerospace Defense and Transportation} 

When you select a product family, for example "Service Contracts", License Manager will search for the entry Service Contracts={515,870,542} to obtain the initial list of application IDs. With that list, License Manager will look at entries in applprod.txt that correspond to those application IDs and will create the dependency tree for the rest of the products that need to be activated. In other words, License Manager will fully activate the three products included in Service Contracts (515, 870 and 542), searching in applprod.txt for all their dependent products and setting them to Shared or Fully Installed accordingly. This will occur for each product that is fully activated.

From the dependent list, License Manager will set all the products from the Shared list to Shared and all the products from the Fully Installed list to Fully Installed. Shared products will not fully activate other products. Only fully activated products will cause License Manager to look at all the dependencies that need to be Shared or Fully Installed.

Unlicensing a Product

Unlicensing a product is not supported. Some applications will behave differently if some modules are fully activated or shared. Changing a product from Fully Installed to Shared or Not Installed may cause result in unpredictable behavior, especially if you continue to use Oracle E-Business Suite after the product was activated.

Note: Oracle strongly recommends that you never use SQL*Plus, database triggers, or any other tool to manually modify Oracle E-Business Suite data unless otherwise instructed by Oracle Development.

If you inadvertently activate a product, you have two options: