All about DataInstaller & Hrglobal.drv in Oracle Applications R12

All about DataInstaller & Hrglobal.drv in Oracle Applications
All about DataInstaller & Hrglobal.drv in Oracle Applications

This posts covers what is datainstaller & hrglobal.drv and when do we need to run them.

DataInstaller and hrglobal.drv are used for installing legislative data into Oracle Applications,For example a company operates in multiple counntries and payroll and HR practices are different in each countires, So they need to have all the legislative regulations (Taxation and HR rules and regulations) of the all the countries they run their business.

To achive this Oracle provides a set of patches, which need to applied to the Oracle applications.

These patches are country specific, The patch matrix can be found from Latest Oracle HRMS Legislative Data Patch Available (HR Global / hrglobal) [ID 145837.1]

To Install the legislative data please follow the below 4 steps:

1) PER & PAY modules need to be licenced ( This is madantory requirement)

2) Identify the patches & apply them based on your requirement from the Note:  145837.1
(Check the countires you need legislations and versions of the Applications)

3)After applying the patches run the datainstaller

Datainstaller is java command which will launch a interface to choose the set of legislation you require.

Always Install Global along with the country legislation you install.

Ex: If you wish to install US  legislations , Install Global and US.

You can install either payroll or hr for the the specific country your require or you can choose both.

The command line for the Data Install program is as follows:

Always run the datainstaller command from Middle Tier (Not from DB node) command line (VNC not needed)

Syntax:
java oracle.apps.per.DataInstall apps <apps_pwd> thin <db Hostname>:<db port>:<Db SID>
Example:

java oracle.apps.per.DataInstall apps apps thin testdb.oracle.com:1521:TESTDB

You will see a screen like below:

DataInstall Main Menu

1. Select legislative data to install/upgrade
2. Select college data to install/upgrade
3. Select JIT/Geocode or OTL to install/upgrade
4. Exit to confirmation menu

Enter your choice : 1

For more details on how to run Data Installer and hrglobal.drv Please check NOTE ID 140511.1

4)The last step in this process is to apply the hrglobal.drv

hrglobal.drv is patch driver file located in $PER_TOP/patch/115/driver, Apply it using
adpatch to populate the legislative data into the required HR tables in the database.

hglobal.drv can be applied as hotpatch.

Syntax:
adpatch driver=$PER_TOP/patch/115/driver/hrglobal.drv logfile=hrglobal.drv.log options=hotpatch <optional>

FAQ

Q) Do we need to run the datainstaller and hrglobal.drv every time we apply a HRMS patch?

A) No, Not needed, You need to run datainstaller when ever you apply the HRMS RUP patches or Upgrade Oracle Apps or Upgrade HRMS module.

In the above cases you need re0check the patch matrix and apply the nessesaty paches and run datinstaller & hrglobal.drv.

If any patch explicitely says you to run the datainstaller & hrglobal.drv you need to run them

Basically for regular HRMS patching (one-offs and Mini) you no need to run the datainstaller.

Sometimes you may need to apply hrglobal.drv and you may not needed datainstaller (when there is no change in the legislative selection)





                                 Steps to apply hrglobal.drv

   DataInstall for hrglobal
>>>>   java oracle.apps.per.DataInstall apps <apps_password> thin proddb.prod.nec.com:1571:PROD
  
+-------------------------------------------------+
|             DataInstall Main Menu               |
+-------------------------------------------------+

1.    Select legislative data to install/upgrade

2.    Select college data to install/upgrade

3.    Select JIT or OTL to install/upgrade

4.    Exit to confirmation menu

Enter your choice : 1

 # Localisation         Product(s)               Leg. Data? Action
-- -------------------  ------------------------ ---------- -------------
 1 Global               Human Resources          Installed
 2 Australia            Human Resources
 3 Australia            Payroll
 4 Belgium              Human Resources
 5 Canada               Human Resources          Installed
 6 Canada               Payroll                  Installed
 7 China                Human Resources
 8 China                Payroll
 9 Denmark              Human Resources
10 Denmark              Payroll
11 Finland              Human Resources
12 France               Human Resources
13 Germany              Human Resources
14 Hong Kong            Human Resources
15 Hong Kong            Payroll
16 Hungary              Human Resources
17 India                Human Resources
18 India                Payroll
19 Ireland              Human Resources
20 Ireland              Payroll
21 Italy                Human Resources
22 Japan                Human Resources
23 Japan                Payroll
24 Korea, Republic of   Human Resources
25 Korea, Republic of   Payroll
26 Kuwait               Human Resources
27 Kuwait               Payroll
28 Mexico               Human Resources
29 Mexico               Payroll
30 Netherlands          Human Resources
31 Netherlands          Payroll
32 New Zealand          Human Resources
33 New Zealand          Payroll
34 Norway               Human Resources
35 Norway               Payroll
36 Poland               Human Resources
37 Romania              Human Resources
38 Romania              Payroll
39 Russian Federation   Human Resources
40 Saudi Arabia         Human Resources
41 Saudi Arabia         Payroll
42 Singapore            Human Resources
43 Singapore            Payroll
44 South Africa         Human Resources
45 South Africa         Payroll
46 Spain                Human Resources
47 Sweden               Human Resources
48 United Arab Emirates Human Resources
49 United Arab Emirates Payroll
50 United Kingdom       Human Resources
51 United Kingdom       Payroll
52 United States        Human Resources          Installed
53 United States        Payroll                  Installed
54 United States        US Federal Human Resources

 <Product #><Action> - Change Action
 where <Action> is [I : Install, C : Clear]

 [Return]     - To return to main menu.

Enter your choice (for example 2I) : 1I <Enter>

Enter your choice (for example 2I) : 5I <Enter>

Enter your choice (for example 2I) : 6I <Enter>

Enter your choice (for example 2I) : 52I <Enter>

Enter your choice (for example 2I) : 53I <Enter>



 # Localisation         Product(s)               Leg. Data? Action
-- -------------------  ------------------------ ---------- -------------
 1 Global               Human Resources          Installed  Install
 2 Australia            Human Resources
 3 Australia            Payroll
 4 Belgium              Human Resources
 5 Canada               Human Resources          Installed  Install
 6 Canada               Payroll                  Installed  Install
 7 China                Human Resources
 8 China                Payroll
 9 Denmark              Human Resources
10 Denmark              Payroll
11 Finland              Human Resources
12 France               Human Resources
13 Germany              Human Resources
14 Hong Kong            Human Resources
15 Hong Kong            Payroll
16 Hungary              Human Resources
17 India                Human Resources
18 India                Payroll
19 Ireland              Human Resources
20 Ireland              Payroll
21 Italy                Human Resources
22 Japan                Human Resources
23 Japan                Payroll
24 Korea, Republic of   Human Resources
25 Korea, Republic of   Payroll
26 Kuwait               Human Resources
27 Kuwait               Payroll
28 Mexico               Human Resources
29 Mexico               Payroll
30 Netherlands          Human Resources
31 Netherlands          Payroll
32 New Zealand          Human Resources
33 New Zealand          Payroll
34 Norway               Human Resources
35 Norway               Payroll
36 Poland               Human Resources
37 Romania              Human Resources
38 Romania              Payroll
39 Russian Federation   Human Resources
40 Saudi Arabia         Human Resources
41 Saudi Arabia         Payroll
42 Singapore            Human Resources
43 Singapore            Payroll
44 South Africa         Human Resources
45 South Africa         Payroll
46 Spain                Human Resources
47 Sweden               Human Resources
48 United Arab Emirates Human Resources
49 United Arab Emirates Payroll
50 United Kingdom       Human Resources
51 United Kingdom       Payroll
52 United States        Human Resources          Installed  Install
53 United States        Payroll                  Installed  Install
54 United States        US Federal Human Resources


+-------------------------------------------------+
|             DataInstall Main Menu               |
+-------------------------------------------------+

1.    Select legislative data to install/upgrade

2.    Select college data to install/upgrade

3.    Select JIT or OTL to install/upgrade

4.    Exit to confirmation menu


Enter your choice : 4

          DataInstall - Actions confirmation

Do you really wish to exit and save your changes?

      [Y]      - Yes, save then exit
      [N]      - No, don't save but exit
      [Return] - To return to the DataInstall Main Menu

Enter your choice (for example Y) : Y


          DataInstall - Actions summary
          -----------------------------

The following actions will be performed:


Localisation         Product(s)               Leg. Data? Action
-------------------- ------------------------ ---------- -------------
Global               Human Resources          Installed  Install
Canada               Human Resources          Installed  Install
Canada               Payroll                  Installed  Install
United States        Human Resources          Installed  Install
United States        Payroll                  Installed  Install

Localisation   College Data? Action
-------------- ------------- -------------
United Kingdom
United States

Option                         Data?         Action
------------------------------ ------------- -------------
JIT/Geocode                    Installed     Install
Oracle Time and Labor (OTL)

Then apply hrglobal.drv







java oracle.apps.per.DataInstall [apps_un] [apps_pw] thin [connection]
    with [connection] in form: hostname:dbport:oraclesid
               
               
                uatdb.qa.nec.com
               
                java oracle.apps.per.DataInstall apps fr3shcr0p thin uatdb.qa.nec.com:1552:UAT
               
               
               
               
                apps/fr3shcr0p
               
                db21.qa.nec.com:1552:UAT
               
                Example:
                                 Steps to apply hrglobal.drv

   DataInstall for hrglobal
>>>>   java oracle.apps.per.DataInstall apps <apps_password> thin proddb.prod.nec.com:1571:PROD
  
+-------------------------------------------------+
|             DataInstall Main Menu               |
+-------------------------------------------------+

1.    Select legislative data to install/upgrade

2.    Select college data to install/upgrade

3.    Select JIT or OTL to install/upgrade

4.    Exit to confirmation menu

Enter your choice : 1

 # Localisation         Product(s)               Leg. Data? Action
-- -------------------  ------------------------ ---------- -------------
 1 Global               Human Resources          Installed
 2 Australia            Human Resources
 3 Australia            Payroll
 4 Belgium              Human Resources
 5 Canada               Human Resources          Installed
 6 Canada               Payroll                  Installed
 7 China                Human Resources
 8 China                Payroll
 9 Denmark              Human Resources
10 Denmark              Payroll
11 Finland              Human Resources
12 France               Human Resources
13 Germany              Human Resources
14 Hong Kong            Human Resources
15 Hong Kong            Payroll
16 Hungary              Human Resources
17 India                Human Resources
18 India                Payroll
19 Ireland              Human Resources
20 Ireland              Payroll
21 Italy                Human Resources
22 Japan                Human Resources
23 Japan                Payroll
24 Korea, Republic of   Human Resources
25 Korea, Republic of   Payroll
26 Kuwait               Human Resources
27 Kuwait               Payroll
28 Mexico               Human Resources
29 Mexico               Payroll
30 Netherlands          Human Resources
31 Netherlands          Payroll
32 New Zealand          Human Resources
33 New Zealand          Payroll
34 Norway               Human Resources
35 Norway               Payroll
36 Poland               Human Resources
37 Romania              Human Resources
38 Romania              Payroll
39 Russian Federation   Human Resources
40 Saudi Arabia         Human Resources
41 Saudi Arabia         Payroll
42 Singapore            Human Resources
43 Singapore            Payroll
44 South Africa         Human Resources
45 South Africa         Payroll
46 Spain                Human Resources
47 Sweden               Human Resources
48 United Arab Emirates Human Resources
49 United Arab Emirates Payroll
50 United Kingdom       Human Resources
51 United Kingdom       Payroll
52 United States        Human Resources          Installed
53 United States        Payroll                  Installed
54 United States        US Federal Human Resources

 <Product #><Action> - Change Action
 where <Action> is [I : Install, C : Clear]

 [Return]     - To return to main menu.

Enter your choice (for example 2I) : 1I <Enter>

Enter your choice (for example 2I) : 5I <Enter>

Enter your choice (for example 2I) : 6I <Enter>

Enter your choice (for example 2I) : 52I <Enter>

Enter your choice (for example 2I) : 53I <Enter>



 # Localisation         Product(s)               Leg. Data? Action
-- -------------------  ------------------------ ---------- -------------
 1 Global               Human Resources          Installed  Install
 2 Australia            Human Resources
 3 Australia            Payroll
 4 Belgium              Human Resources
 5 Canada               Human Resources          Installed  Install
 6 Canada               Payroll                  Installed  Install
 7 China                Human Resources
 8 China                Payroll
 9 Denmark              Human Resources
10 Denmark              Payroll
11 Finland              Human Resources
12 France               Human Resources
13 Germany              Human Resources
14 Hong Kong            Human Resources
15 Hong Kong            Payroll
16 Hungary              Human Resources
17 India                Human Resources
18 India                Payroll
19 Ireland              Human Resources
20 Ireland              Payroll
21 Italy                Human Resources
22 Japan                Human Resources
23 Japan                Payroll
24 Korea, Republic of   Human Resources
25 Korea, Republic of   Payroll
26 Kuwait               Human Resources
27 Kuwait               Payroll
28 Mexico               Human Resources
29 Mexico               Payroll
30 Netherlands          Human Resources
31 Netherlands          Payroll
32 New Zealand          Human Resources
33 New Zealand          Payroll
34 Norway               Human Resources
35 Norway               Payroll
36 Poland               Human Resources
37 Romania              Human Resources
38 Romania              Payroll
39 Russian Federation   Human Resources
40 Saudi Arabia         Human Resources
41 Saudi Arabia         Payroll
42 Singapore            Human Resources
43 Singapore            Payroll
44 South Africa         Human Resources
45 South Africa         Payroll
46 Spain                Human Resources
47 Sweden               Human Resources
48 United Arab Emirates Human Resources
49 United Arab Emirates Payroll
50 United Kingdom       Human Resources
51 United Kingdom       Payroll
52 United States        Human Resources          Installed  Install
53 United States        Payroll                  Installed  Install
54 United States        US Federal Human Resources


+-------------------------------------------------+
|             DataInstall Main Menu               |
+-------------------------------------------------+

1.    Select legislative data to install/upgrade

2.    Select college data to install/upgrade

3.    Select JIT or OTL to install/upgrade

4.    Exit to confirmation menu


Enter your choice : 4

          DataInstall - Actions confirmation

Do you really wish to exit and save your changes?

      [Y]      - Yes, save then exit
      [N]      - No, don't save but exit
      [Return] - To return to the DataInstall Main Menu

Enter your choice (for example Y) : Y


          DataInstall - Actions summary
          -----------------------------

The following actions will be performed:


Localisation         Product(s)               Leg. Data? Action
-------------------- ------------------------ ---------- -------------
Global               Human Resources          Installed  Install
Canada               Human Resources          Installed  Install
Canada               Payroll                  Installed  Install
United States        Human Resources          Installed  Install
United States        Payroll                  Installed  Install

Localisation   College Data? Action
-------------- ------------- -------------
United Kingdom
United States

Option                         Data?         Action
------------------------------ ------------- -------------
JIT/Geocode                    Installed     Install
Oracle Time and Labor (OTL)

Then apply hrglobal.drv

Cd $PER_TOP/patch/115/driver
Adpatch driver=hrglobal.drv logfile=adpatch_hrglobal.log


Latest Oracle HRMS Legislative Data Patch Available (HR Global / hrglobal) (Doc ID 145837.1)



Comments

Popular posts from this blog

EBS Oracle Database 11.1.0.7 upgrade to 11.2.0.4 steps .

PSU Patching step by step on RAC