LAD CONSULTING LOCALIZATIONS

RECEBIMENTO INTEGRADO
INSTALLATION AND UPGRADE MANUAL
RELEASE 11i
VERSION 4

DISCLAIMER :
CURRENTLY, ORACLE OFFERS CERTAIN RESALABLE ASSETS OR OTHER DEFINED SERVICE
DELIVERABLES (COLLECTIVELY REFERRED TO AS "SERVICE DELIVERABLES") UNDER A LIMITED
USE LICENSE. THE SERVICE DELIVERABLES CURRENTLY INCLUDE, BUT ARE NOT LIMITED TO,
ORACLE INTEGRATION HUB. YOU AGREE THAT :
(i) SERVICE DELIVERABLES ARE NOT ORACLE STANDARD SOFTWARE PROGRAMS,
(ii) TECHNICAL SUPPORT FOR SERVICE DELIVERABLES IS NOT AVAILABLE FROM OR UNDER, OR
PROVIDED BY OR THROUGH, ORACLE'S SUPPORT SERVICES ORGANIZATION OR YOUR ORACLE
PROGRAM LICENSE AGREEMENT,
(iii) YOUR RIGHT TO USE AND RECEIVE SUPPORT SERVICES FOR SERVICE DELIVERABLES IS
SOLELY AS DESCRIBED IN YOUR CONTRACT FOR SUCH SERVICE DELIVERABLES, AND
(iv) A SERVICE REQUEST REGARDING SERVICE DELIVERABLES, REGARDLESS OF HOW
INITIATED OR LOGGED, WILL BE ADDRESSED IN ACCORDANCE WITH THE TERMS OF YOUR
CONTRACT FOR SUCH SERVICE DELIVERABLES.

Documents Control
Change Registration
3

Date

Author

Version

Change Reference

09-May-03
02-Apr-05

Jean Pacanaro
Alexandre Favero

3
4

Include warning section

Comments 11.5.10

Proofreaders

Name

Function

Distribution

LAD Consulting Localizations

Recebimento Integrado

Copy
Number

Name

Place

1
2
3
4

Responsible for the Documentation

Library of the Project

Project Manager

Installation and Upgrade Manual

ii

Contents

Documents Control...................................................................................................................ii
Installation/ Upgrade Components...................................................................................... 1
WARNING:........................................................................................................................ 2
Steps for Installation / Upgrade .......................................................................................... 3
AD Splice ........................................................................................................................... 4
Adsplice Post Steps........................................................................................................... 11
Upgrade 11.0 to 11i .......................................................................................................... 12
Adpatch............................................................................................................................. 13
Additional steps ................................................................................................................ 13

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

iii

CEB Installation

Installation/ Upgrade Components

Patch 4681056:
RI Recebimento Integrado

You need to run the topics Steps for Installation/Upgrade and Ad Splice just for the first installation/upgrade.

For the second and other installation/upgrade please go directly to topic Adpatch.

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

WARNING:

You should select US language to generate Brazilian Localization forms into adadmin utility;

CEB patches must be applied using adpatch utility. Other ad tools, for example, admerge, are not supported by
Brazilian Localization Team;

The environment variable NLS_LANG must be set to AMERICAN_AMERICA.<CHARACTERSET> before apply

CEB patches.

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

Steps for Installation / Upgrade

Login as applmgr user into Operating System.

Create the patches directory under APPL_TOP

$ cd $APPL_TOP
$ mkdir patches

Edit the file $APPL_TOP/APPLSYS.env and insert the environment variable PATCH_TOP
declaration
PATCH_TOP=$APPL_TOP/patches
export PATCH_TOP

Execute the environment file.

$ cd $APPL_TOP
$ . APPLSYS.env

Copy p4681056_GENERIC.zip to PATCH_TOP directory.

$ cd $PATCH_TOP
$ unzip p4681056_GENERIC.zip

Copy the files to the administration directory:

$ cd $PATCH_TOP
$ cd RECINST/admin
$ cp *.* $APPL_TOP/admin/.

Create tablespaces for Recebimento Integrado (Conditional):

- If the application use Locally Managed Tablespaces, ignore this step.

Start SQLPLUS as SYSTEM user

SQL> create tablespace RECD
datafile <data_directory>/recd01.dbf size 50M;
SQL> create tablespace RECX
datafile <index_directory>/recx01.dbf size 50M;
If you want to change the default tablespace, you need to edit the file $APPL_TOP/admin/newprods.txt, and change the
parameters main_tspace, index_tspace and default_tspace. OBS.: If the application use Locally Managed
Tablespaces, ignore this comment.

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

AD Splice
Execute the following procedures:
cd $APPL_TOP/admin
$ adsplice

Copyright (c) 1998 Oracle Corporation

Redwood Shores, California, USA
AD Splice
Version 11.5.0
NOTE: You may not use this utility for custom development
unless you have written permission from Oracle Corporation.
Your default directory is '/u5/applivis/visappl'.
Is this the correct APPL_TOP [Yes] ?
AD Splice records your AD Splice session in a text file
you specify. Enter your AD Splice log file name or press [Return]
to accept the default file name shown in brackets.
Filename [adsplice.log] : adsplice_rec.log

Please enter the name of the Oracle Applications Environment that this
APPL_TOP belongs to.
The Applications Environment name must be unique across all Oracle
Applications Environments at your site, must be from 1 to 8 characters
long, and may only contain alphanumeric characters.
Sample Applications Environment names are: "prod", "test", and "demo".
Applications Environment Name [VIS] : VIS *

NOTE: If you do not currently have certain types of files installed

in this APPL_TOP, you may not be able to perform certain tasks.
Example 1: If you don't have files used for installing or upgrading
the database installed in this area, you cannot install or upgrade
the database from this APPL_TOP.
Example 2: If you don't have forms files installed in this area, you cannot
generate them or run them from this APPL_TOP.
Example 3: If you don't have concurrent program files installed in this area,
you cannot relink concurrent programs or generate reports from this APPL_TOP.

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

Do you currently have or want to install files used for installing or upgrading
the database in this APPL_TOP [Yes] ? Yes *

Do you currently have or want to install Java and HTML files for HTML-based
functionality in this APPL_TOP [Yes] ? Yes *

Do you currently have or want to install Oracle Applications forms files

in this APPL_TOP [Yes] ? Yes *

Do you currently have or want to install concurrent program files

in this APPL_TOP [Yes] ? Yes *

Please enter the name Oracle Applications will use to identify this APPL_TOP.
The APPL_TOP name you select must be unique within an Oracle Applications
Environment, must be from 1 to 8 characters long, and may only contain
alphanumeric and underscore characters.
AD Splice has computed a default APPL_TOP name for you
based on the servers you have implemented in this APPL_TOP.

APPL_TOP Name [tafnw1] : tafnw1 *

You are about to install or upgrade Oracle Applications product tables

in your ORACLE database 'VIS'
using ORACLE executables in '/u5/oracle8ivis/visora/8.0.6'.
Is this the correct database [Yes] ?
AD Splice needs the password for your 'SYSTEM' ORACLE schema
in order to determine your installation configuration.
Enter the password for your 'SYSTEM' ORACLE schema: manager

Connecting to SYSTEM......Connected successfully.

The ORACLE username specified below for Application Object Library
uniquely identifies your existing product group: APPLSYS
Enter the ORACLE password of Application Object Library [APPS] :
AD Splice is verifying your username/password.
Connecting to APPLSYS......Connected successfully.
Connecting to SYSTEM......Connected successfully.
Connecting to APPLSYS......Connected successfully.
Reading product information from file...
LAD Consulting Localizations
Recebimento Integrado

Installation and Upgrade Manual

Reading language and territory information from file...

Reading language information from applUS.txt ...
Reading database to see what industry is currently installed.
Reading FND_LANGUAGES to see what is currently installed.
Currently, the following language is installed:
Code Language
Status
---- --------------------------------------- --------US American English
Base
Your base language will be AMERICAN.
Setting up module information.
Reading database for information about the modules.
Saving module information.
Reading database for information about the products.
Connecting to SYSTEM......Connected successfully.
Connecting to APPLSYS......Connected successfully.
Connecting to SYSTEM......Connected successfully.
Reading database for information about how products depend on each other.
Connecting to APPLSYS......Connected successfully.
Reading topfile.txt ...
Saving product information.
Connecting to SYSTEM......Connected successfully.
Connecting to APPLSYS......Connected successfully.

Please enter the directory where your AD Splice control file is located.
The default directory is [/u5/applivis/visappl/admin] :
Please enter the name of your AD Splice control file [newprods.txt] :

Processing file /u5/applivis/visappl/admin/newprods.txt...

Loading information for product 'rec'...
Connecting to SYSTEM......Connected successfully.
Successfully read file /u5/applivis/visappl/admin/newprods.txt.

Verifying localizations...
Validating inter-product dependency information...
Re-organizing product information lists...

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

Adding new languages into FND_LANGUAGES...

Connecting to APPS......Connected successfully.

Connecting to SYSTEM......Connected successfully.

Creating ORACLE usernames for products...
AD Splice is creating or updating the ORACLE username REC
with password REC for REC ResselableSolutions tables.
Granting privileges for tablespaces...
Granting required system privileges and creating APPS*DDL packages...
sqlplus -s REC/REC @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaddls.pls MANAGER REC REC
Done running adaddls.pls for REC
sqlplus -s REC/REC @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaaddls.pls MANAGER REC REC
Done running adaaddls.pls for REC
sqlplus -s REC/REC @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaddlb.pls MANAGER REC REC
Done running adaddlb.pls for REC
sqlplus -s REC/REC @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaaddlb.pls MANAGER REC REC
Done running adaaddlb.pls for REC
Creating APPS account(s)...
AD Splice is creating or updating the ORACLE username APPS
with password APPS for APPS #1 tables.
sqlplus -s APPS/APPS @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaddls.pls MANAGER APPS APPS
Done running adaddls.pls for APPS
sqlplus -s APPS/APPS @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaaddls.pls MANAGER APPS APPS
Done running adaaddls.pls for APPS
sqlplus -s APPS/APPS @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaddlb.pls MANAGER APPS APPS
Done running adaddlb.pls for APPS
sqlplus -s APPS/APPS @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaaddlb.pls MANAGER APPS APPS
Done running adaaddlb.pls for APPS
sqlplus -s APPS/APPS @/u5/applivis/visappl/ad/11.5.0/admin/sql/adjvaprm.sql APPS MANAGER
Connecting to APPLSYS......Connected successfully.
Creating APPS*DDL packages in MRC/MLS schema(s)...
LAD Consulting Localizations
Recebimento Integrado

Installation and Upgrade Manual

sqlplus -s APPS_MRC/APPS @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaddls.pls MANAGER APPS_MRC APPS

Done running adaddls.pls for APPS_MRC
sqlplus -s APPS_MRC/APPS @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaaddls.pls MANAGER APPS_MRC APPS
Done running adaaddls.pls for APPS_MRC
sqlplus -s APPS_MRC/APPS @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaddlb.pls MANAGER APPS_MRC APPS
Done running adaddlb.pls for APPS_MRC
sqlplus -s APPS_MRC/APPS @/u5/applivis/visappl/ad/11.5.0/admin/sql/adaaddlb.pls MANAGER APPS_MRC APPS
Done running adaaddlb.pls for APPS_MRC
Registering ORACLE usernames/passwords.
**
**Updating product information for new products...
**

Populating INSTALL_GROUP_NUM column to FND_ORACLE_USERID table.

**
**Updating product dependency information...
**

**
**Inserting application information for new products...
**

Connecting to APPS......Connected successfully.

Running fnd_application_pkg.add_language ...
Recording modules in the database...
Connecting to APPLSYS......Connected successfully.
done.
**
**Updating Data Groups...
**

Reading existing data groups from database.

Registering any new data groups.

Registering any new data group units.

Updating Data Group "Standard" to point to

APPS #1 Account (ORACLE ID = 900)

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

Updating Data Group "Multiple Reporting Currencies" to point to

APPS #1 Account (ORACLE ID = 900)
Saving module actions...done.
Saving product actions...done.
Making product top directory for product "REC"...
Directory will be /u5/applivis/visappl/REC/11.5.0
Making directory "log" for product "REC"...
Making directory "out" for product "REC"...
Making directory "mesg" for product "REC"...
Making directory "admin/driver" for product "REC"...
Creating empty file "admin/driver/recfile.drv" for product "REC"...

Do you wish to regenerate your environment file [Yes] ?

Creating the Oracle Applications environment file ...
Enter the name of your Oracle Applications environment file below.
File name [SPLICER.env] :

How do you wish to enable Parallel Concurrent Processing:

1. Not enabled
2. Enable generic parallel concurrent processing
3. Enable parallel concurrent processing with operating system queue
The default choice is 1 - Not enabled.
Enter your choice [1] :
The concurrent managers can create output files which
use a name that is no longer than 8 characters and
an extension which is no longer than 3 characters.

Do you wish to use the 8.3 file name convention [No] :

The concurrent managers can put all the log and report files in a common area
where the client machines can view them.
Enter the name of this common area below, or press [Return]
if you want log and report files for each application to go
in that application's log and output subdirectories.
Enter the name of the common area: /u5/common/viscomn/admin
You have entered '/u5/common/viscomn/admin'. Is this correct [Y] ?

Enter the log subdirectory name for this product group [log] :
Enter the output subdirectory name for this product group [out] :

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

Enter the directory for Applications temporary files [/var/tmp] :

Enter the directory for Oracle Reports temporary files [/tmp] :
Some PL/SQL programs produce temporary log/output files. The directories
used for this must be listed in the init.ora parameter "utl_file_dir".
The value of utl_file_dir for this database is:
"*"
Enter the directory for temporary log/output files from PL/SQL programs.
Directory: *

The Oracle Applications forms are accessed via a web server. Oracle
Applications needs to know the name of the machine on which the
web server is running.

What is the name of the machine, including domain name, hosting the
web server that will be used for accessing Applications forms?
Applications forms web server host machine [ ] ? app11.br.oracle.com
What port is the Applications forms web server running on [80] ? 8002
Reading topfile.txt ...
Computing APPLFULL and APPLSHAR values...
Creating environment file...
Done.
AD Splice is complete.
You should check the file
/u5/applivis/visappl/admin/VIS/log/asplice_REC.log
for errors.

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

10

Adsplice Post Steps

Edit file $APPL_TOP/APPLSYS.env and check if there are the following lines:
REC_TOP=$APPL_TOP/rec/11.5.0
export REC_TOP

Execute the environment file:

$ cd $APPL_TOP
$ . APPLSYS.env

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

11

Upgrade 11.0 to 11i

If you are doing an upgrade from RI 11.0 to RI 11i, execute the following steps before run adpatch utility (see next
chapter).

$ sqlplus APPS/APPS @$PATCH_TOP/RECINST/fixes/UPDVER.sql

$ sqlplus APPS/APPS @$PATCH_TOP/RECINST/fixes/DROPOBJ.sql
$ sqlplus APPS/APPS @$PATCH_TOP/RECINST/fixes/BSINSTALL.pkg
$ sqlplus APPS/APPS @$PATCH_TOP/RECINST/fixes/DELCCR.sql

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

12

Adpatch
IMPORTANT BEFORE APPLY THE DRIVERS (CONDITIONAL):
Alter JL_BR_PO_FISC_CLASSIF_U1 index

- If the application use Locally Managed Tablespaces, ignore this step.

Run $PATCH_TOP/RECINST/fixes/JLFISC.sql file

$ sqlplus JL/JL @$PATCH_TOP/RECINST/fixes/JLFISC.sql

Check if the variable NLS_LANG is defined correctly:

$ echo $NLS_LANG
it should be AMERICAN_AMERICA.<CHARACTERSET>
Start the adpatch session:
$ cd $APPL_TOP/patches/RECINST
$ adpatch options=noprereq

IMPORTANT: This patch should be applied using adpatch option "noprereq"

Execute the drivers:

crecinst.drv
drecinst.drv,
grecinst.drv, in this order. Before apply the driver grecinst.drv execute the following steps:
AD Administration (adadmin):
1. Generate message files
2. Compile APPS schema(s)
3. Compile flexfield data in AOL tables

Additional steps
After the end of all installations, associate the users to Recebimento Integrado responsibility
Associate the Report Group REC_ALL_REPORTS to Recebimento Integrado responsibility

LAD Consulting Localizations

Recebimento Integrado

Installation and Upgrade Manual

13