MASTERSAF DW

PROCEDURES FOR APPLICATION

OF PATCH
MASTERSAF DW PROCEDURES FOR APPLICATION OF PATCH

TABLE OF CONTENTS

REQUIREMENTS FOR DATABASE .................................................................................................................. 3

PREREQUISITE FOR A SUCCESSFUL APPLICATION OF THE CUMULATIVE PATCH ..................................5
PROCEDURES TO UPDATE THE DATABASE ......................................................................................6
PROCEDURES TO UPDATE THE EXECUTABLES AND HELP ON LINE ...........................................8
PROCEDURES TO UPDATE THE MANUALS .......................................................................................9
PROCEDURES TO UPDATE THE FIXED/ACCESSORY TABLES .......................................................9
TECHNICAL SUPPORT .................................................................................................................................... 11

Version: 23 2
Lasted update: 05/01/2018
MASTERSAF DW PROCEDURES FOR APPLICATION OF PATCH

REQUIREMENTS FOR DATABASE

Dear users, before making a service call for the Contact Center related to application of patch,
please read this manual carefully. If, eventually, to the end of the reading remains a question, click
the link at the end of the file to access detailed information of the patch.

The releases of Oracle databases supported by MASTERSAF DW application are 11G Release 2 (11.2.0.4 -
64 bits), Oracle Database 12c Release 1 (12.1.0.2) or Oracle Database 12c Release 2 (12.2.0.1), the last
one homologated for the product.

Oracle Premier Support for 11.2.0.3 Release (or lower) of Oracle Database 11g ended August, 2014. For
this reason, it is necessary to update the database that host the MASTERSAF DW application with patch
11.2.0.4 set or, preferably, migrate to Oracle Database 12c Release 2 (12.2.0.1). Since, the Extended
Support for 11.2.0.4 release is offered by Oracle without extra charges up to December, 2018.

IMPORTANT: It is mandatory to keep the database up to date on both 11g and 12c with the latest
PSU - Patch Set Updates (Unix/Linux) or Bundle Patch (Windows) for bug fixes and other
enhancements implemented by Oracle.

It is mandatory to install the component "JServer JAVA Virtual Machine" (JVM) for database because
for example, the application uses the DBMS_JAVA package. The JVM is available in the Oracle installation
directory (ORACLE_HOME) just follow the steps in the Oracle manual to add it to the database. Please be
advised that this requirement is mandatory since 2013.
Note: Consult you DBA if you have any questions about this component.

Please, provide your IT Team with this information. Reading this document before patch
application is essential.

To resolve any doubts about the discontinuation of support for lower versions than Oracle 11g
contact us at Technical Support.

So that the Cumulative Patch update process is carried out successfully you must include in the
schema the following privileges were granted to the owner MASTERSAF:

Version: 23 3
Lasted update: 05/01/2018
MASTERSAF DW PROCEDURES FOR APPLICATION OF PATCH

ATTENTION: The schema in which the MASTERSAF DW objects will be stored must have the
following privileges:

1. GRANT EXECUTE ON SYS.DBMS_PIPE TO <MSAF>

2. GRANT SELECT ON SYS.V_$INSTANCE TO <MSAF>
3. GRANT SELECT ON SYS.V_$VERSION TO <MSAF>
4. GRANT CONNECT TO <MSAF>
5. GRANT RESOURCE TO <MSAF>
6. GRANT CREATE SESSION TO <MSAF>
7. GRANT CREATE TRIGGER TO <MSAF>
8. GRANT CREATE PROCEDURE TO <MSAF>
9. GRANT CREATE TABLE TO <MSAF>
10. GRANT CREATE VIEW TO <MSAF>
11. GRANT CREATE SEQUENCE TO <MSAF>
12. GRANT CREATE TYPE TO <MSAF>
13. GRANT SELECT ON SYS.V_$DATABASE TO <MSAF>
14. GRANT SELECT ON SYS.NLS_DATABASE_PARAMETERS TO <MSAF>
15. GRANT SELECT ON SYS.V_$PROCESS TO <MSAF>
16. GRANT ALTER SESSION TO <MSAF>
17. GRANT EXECUTE ON SYS.DBMS_SCHEDULER TO <MSAF>
18. GRANT CREATE JOB TO <MSAF>
19. GRANT EXECUTE ON SYS.DBMS_LOCK TO <MSAF>

Note 1: Items 4 and 5 are optional and may be replaced by items 6, 7 and 8. The replacement, the
applications will continue to function properly.

Note 2: Due to the dynamic execution, via procedure, the Oracle database requires the GRANTs of
items 9, 10 and 11 to be made explicitly, the GRANT in item 5 not being.

• During installation of cumulative Patch 141, of April 19, 2016, aiming to attend Tributes Monitor
Module, we have created an object in Database referring to a “DIRECTORY” named
“MSAFGEMT”. Whether such object does not exist, or the database user (Patch applicator) does
not have permission to using it (read only), the object must be created and/or permission must be
run BEFORE application of Cumulative Patch 141.

Version: 23 4
Lasted update: 05/01/2018
MASTERSAF DW PROCEDURES FOR APPLICATION OF PATCH

GRANT READ ON DIRECTORY MSAFGEMT TO <MSAF>

EXEC DBMS_JAVA.GRANT_PERMISSION
('<MSAF>','SYS:java.io.FilePermission','path_do_directory_MSAFGEMT','read');

We recommend that this activity is performed by a DBA. To resolve any questions on the above
permissions, a technical professional can contact Thomson Reuters at Technical Support.

PREREQUISITE FOR A SUCCESSFUL

APPLICATION OF THE CUMULATIVE PATCH

It is necessary that Java 1.6 application is installed on the machine where the Cumulative Patch will
be executed. The Java 1.6 is available for download from MASTERSAF site, whose link is in the
‘Utilities’ (‘Utilitários’) folder.

Cumulative Patch will be available to users every fifteen days, and supplemented as the patches
are implemented.

1. First you must create the folder patch ( ) in C:\mastersaf\patch ( ).

2. Another important procedure, before unpacking the Annex, is that one should clean the
folder ( ) created in C:\mastersaf\patch ( ).

3. Then you must unzip the attached file ‘XXXXXX.zip’ in folder patch ( ), in

Version: 23 5
Lasted update: 05/01/2018
MASTERSAF DW PROCEDURES FOR APPLICATION OF PATCH

C:\mastersaf\patch ( ).

4. Procedures:

PROCEDURES TO UPDATE THE DATABASE

Firstly, you must click on ApplyPatchAcumulativo.exe that will open the main menu screen to start
applying the Cumulative Patch.

• When you click on the menu “Atualiza Banco de Dados” (Database Update), you should see
the screen below:

Version: 23 6
Lasted update: 05/01/2018
MASTERSAF DW PROCEDURES FOR APPLICATION OF PATCH

User (Usuário): Inform the user defined for the application.

Password (Senha): Inform the user password.
‘Server’ (Servidor), ‘Port’ (Porta) and ‘SID’ fields can be obtained with the help of your
DBA and/or using, for example, the following command:

• In the example shown above ‘msafreqc’ is the name of Database.

HOST: Server; PORT: Port; SERVICE_NAME: SID.

Version: 23 7
Lasted update: 05/01/2018
MASTERSAF DW PROCEDURES FOR APPLICATION OF PATCH

PROCEDURES TO UPDATE THE EXECUTABLES AND HELP ON LINE

• In the main menu, when you click “Atualiza Executáveis” (Executables Update), will appear
the screen below:

User (Usuário): Inform the user defined for the application.

Password (Senha): Inform the user password.
‘Server’ (Servidor), ‘Port’ (Porta) and ‘SID’ fields can be obtained with the help of your
DBA.

• When you click the ‘Aplicar’ (Apply) button, you should see the screen below for you to select
the destination directory:

Version: 23 8
Lasted update: 05/01/2018
MASTERSAF DW PROCEDURES FOR APPLICATION OF PATCH

PROCEDURES TO UPDATE THE MANUALS

If there is a ‘Manuais’ (Manuals) folder, follow the procedures below:

• Copy the unzipped ‘Manuais’ directory – e.g.: c:\mastersaf\patch\ – to the Executable

(Executáveis) directory of the MASTERSAF DW application in use.

PROCEDURES TO UPDATE THE FIXED/ACCESSORY TABLES

Procedures to update the fixed/accessory tables (TACES and TFIX).

If there is the folder \Atualização\txt, follow the procedure below:

• Import the tables found in this folder for the MASTERSAF DW application, browsing through
the menu Básicos > Ferramentas > Tabelas Internas > Importar > Tabelas Fixas/Acessórias
(Basic > Tools > Internal Tables > Import > Fixed/Accessory Tables):

Version: 23 9
Lasted update: 05/01/2018
MASTERSAF DW PROCEDURES FOR APPLICATION OF PATCH

ATTENTION: It is not necessary to import all the Fixed/Accessory tables (TACES and TFIX), in each
patch.

To optimize the patch update, avoiding long-standing environments and import only tables that
have changed since the last update, we advise you to check the SAFX change sheet table
“Alteracoes_Tabelas_SAFX_MastersafDW.xls” > “Tab. Fixas, Acess. e Básicas” (Fixed/Accessory and
basic tables) tab, which contains all the updates made to the basic, fixed and accessory tables (even
the changes made in the Layout Manual), and in which patch this change was made. Also, in the
Release Notes of the biweekly patches we mention which table TACES/TFIX has been updated.

This change sheet is available at:

• Contact Center > Base de Conhecimento > MASTERSAF DW > Manuais Técnicos > Manual de
Layout SAFX > Alterações de Tabelas SAFX;

• Release Notes > in the technical Points of Caution page > ‘Alterações de Tabelas e SAFXs’’
(Update Tables and SAFXs) session.

• Patch update file: Manuais (manuals file) > Layout SAFX >
Alteracoes_Tabelas_SAFX_MastersafDW.xls.

PROCEDURES TO UPDATE THE BASIC TABLES

To update the basic SAFX’s tables.

If there is the folder \Atualização\txt\Tbasicas, follow the procedure below:

• Import the tables found in this folder for the MASTERSAF DW application, browsing through the
menu Básicos (Basics) > Job Servidor.

ATTENTION: It is not necessary to import all the Basic tables each patch. We advise you to check
the SAFX change sheet table “Alteracoes_Tabelas_SAFX_MastersafDW.xls” > “Tab. Fixas, Acess. e
Básicas” (Fixed/Accessory and basic tables) tab, which contains all the basic tables that have
changed since the last update.

Version: 23 10
Lasted update: 05/01/2018
MASTERSAF DW PROCEDURES FOR APPLICATION OF PATCH

If at the end of reading this document remains a question, click this link to view the file step by
step Procedures for Implementing the Cumulative Patch.

TECHNICAL SUPPORT

For questions or problems, open a call in the Contact Center or contact our MASTERSAF Technical
Support team at:

(11) 2159-0600 option 1 (Service of Tax Solutions).

Our office hours are Monday to Friday at 9 a.m to 6 p.m.

Version: 23 11
Lasted update: 05/01/2018