Installing new language to Oracle Apps R12.1 [Reference doc: 788053.

1]
By: Rahul Gupta ecengineer84@gmail.com

We are installing/adding Canadian French (FRC).Check the supported characterset before adding / installing new language. For supported characterset, Pls refer to doc 393861.1
SQL> select * from v$nls_parameters where PARAMETER like '%CHARACTERSET%'; PARAMETER -----------------------------NLS_CHARACTERSET NLS_NCHAR_CHARACTERSET VALUE -----------------------------AL32UTF8 AL16UTF16

Here Database characterset is AL32UTF8. AL32UTF8 is the recommended character set for instances providing multi-language support, as it can accommodate all the characters from the installed languages. Step to install the new language.

1. Apply US Patch 8576725 to your Release 12.1.1 system. This patch includes updates to NLS Installation and Admerge performance enhancements 2. From Oracle Applications Manager, go to License Manager and activate or change your base language to a new
3. 4. 5. 6. 7. one. From AD Administration, run Maintain Multi-lingual Tables (AD Administration Main Menu > Maintain Applications Database Entities Menu)

Apply 12.1.1 NLS Patch 6678700 for respective language.

Run the Translation Synchronization Patch utility (adgennls.pl). Upload Translation Synchronization file to SR support ( Refer document 252422.1, Requesting Translation Synchronization Patches) When you are notified that it is available, apply your Translation Synchronization Patch (TSP) for all languages you requested. Run the AD Administration utility to generate message files from the Generate Applications Files menu Install the Release 12 NLS Help, if available (optional). Patch 6746000

8. 9. 10. Restart the Apache Service. On the node that contains the Web server, restart the Apache service to enable the

new languages on the login page

$ cd $ADMIN_SCRIPTS_HOME $ adapcctl.sh stop $ adapcctl.sh start

Note: There may be temporary form failures during NLS patch application if the US code level is higher than the NLS patch level. These errors will be resolved when you run the Translation Synchronization Patch Utility to synchronize the NLS code level with the US level, or when you apply the latest NLS Release Update Pack to your system

Step 1: Take instance in maintenance mode

adadmin defaultsfile=$APPL_TOP/admin/$TWO_TASK/adalldefaults.txt logfile=language_add_maintb.log interactive=n \ menu_option=ENABLE_MAINT_MODE

Step 2: Apply patch 8576725 to fix nls performance issue. Pls. check and skip this step, if patch is already applied as this needs to be applied for the first time only, whenever we are adding new language to any instance.
adpatch defaultsfile=$APPL_TOP/admin/$TWO_TASK/adalldefaults.txt logfile=u8576725.log \ patchtop=/ORACLE/media/R12.1.1_Linux_x86_32/languages/8576725 driver=u8576725.drv workers=8

Step 3: Take instance/database out of maintenance mode

adadmin defaultsfile=$APPL_TOP/admin/$TWO_TASK/adalldefaults.txt logfile=mmode_`date "+%m%b%y:%H:%M"`.log interactive=n \ menu_option=DISABLE_MAINT_MODE

Step 4: Start application on primary node

Step 5: From Oracle Applications Manager, go to License Manager and activate or change your base language to a new one.

Note: OAM will not be appearing as a separate link in R12 Login as sysadmin/Sysadmin Choose System Administrator Click on Oracle Application Manager Go to License Manager -> Click on Language

Check the language that you have to install

Click Next. If you want to change the base language, then select appropriate language accordingly

Click submit and then OK

Run the following query to verify that language that you have added is showing as installed. Here we have installed CANADIAN FRENCH OR FRC

SQL > select language_code,NLS_LANGUAGE ,INSTALLED_FLAG from apps.FND_LANGUAGES L WHERE L.INSTALLED_FLAG IN ('I', 'B'); LANGUAGE_COD -----------US FRC NLS_LANGUAGE ---------------------------------------AMERICAN CANADIAN FRENCH INS --B I

Step 6: Run Maintain Multi-lingual Tables (AD Administration Main Menu > Maintain Applications Database Entities Menu (Itll take 10-20 mins)
adadmin defaultsfile=$APPL_TOP/admin/$TWO_TASK/adalldefaults.txt logfile=language_adding_FRC.log workers=8 menu_option=MAINTAIN_MLS

Run utlrp.sql to compile INVALID, if exists.

Step 7: Apply 12.1.1 NLS Patch 6678700 for respective language. This will take around 3 hours Shutdown application and enable maintenance mode OR you can apply this patch in hotpatch mode also.
adpatch defaultsfile=$APPL_TOP/admin/$TWO_TASK/adalldefaults.txt logfile=u6678700_FRC.log \ patchtop=/ORACLE/media/R12.1.1_Linux_x86_32/languages/6678700_FRC driver=u6678700.drv workers=8

Step 8: Run the Translation Synchronization Patch utility (adgennls.pl).

$ perl $AD_TOP/bin/adgennls.pl Please enter the APPS User [APPS]: apps Please enter the APPS password: Manifest file generation is in progress...

Manifest generated in: /opt/egaprt/apps/apps_st/appl/admin/$TWO_TASK/out/adgennls.txt

Step 9: Apply your Translation Synchronization Patch (TSP) as provided by Oracle SR support. Refer doc 252422.1 This will take around 30-40 mins
adpatch defaultsfile=$APPL_TOP/admin/$TWO_TASK/adalldefaults.txt logfile=u12823160_FRC.log \ patchtop=/ORACLE/media/R12.1.1_Linux_x86_32/languages/12823160_FRC driver=u12823160.drv workers=8

Step 10: Run the AD Administration utility to generate message files from the Generate Applications Files menu
adadmin defaultsfile=$APPL_TOP/admin/$TWO_TASK/adalldefaults.txt logfile=Genrate_message_FRC.log workers=8 \ menu_option=GEN_MESSAGES

Step 11: Apply online help patch (It took around 1-1.5 hours )
adpatch defaultsfile=$APPL_TOP/admin/$TWO_TASK/adalldefaults.txt logfile=u6746000_FRC.log \ patchtop=/ORACLE/media/R12.1.1_Linux_x86_32/languages/6746000_FRC driver=u6746000.drv workers=8

Step 12: Restart the Apache Service. On the node that contains the Web server, restart the Apache service to enable the

new languages on the login page

$ cd $ADMIN_SCRIPTS_HOME $ adapcctl.sh stop $ adapcctl.sh start

Step 13: Verify the new language Login to the application and it will show you Canadian French language as an option (Pls. see red marked portion in the screenshot below)