MASTERSAF DW

BASIC INFRASTRUCTURE
MASTERSAF DW BASIC INFRASTRUCTURE

TABLE OF CONTENTS

INTRODUCTION ................................................................................................................................................4
MASTERSAFDW FEATURES ............................................................................................................................4
MASTERSAFDW COMPONENTS .....................................................................................................................4
DATABASE SERVER (COMPULSORY) .........................................................................................................4
WORKSTATIONS (COMPULSORY) ..............................................................................................................4
APPLICATION SERVER (OPTIONAL) ...........................................................................................................5
APPLICATION SERVER (OPTIONAL) ...........................................................................................................5
ORACLE CLIENT (COMPULSORY) ...............................................................................................................5
MASTERSAF DW APPLICATION (COMPULSORY) ..........................................................................................5
HARDWARE AND SOFTWARE REQUIREMENTS ...........................................................................................6
DATABASE SERVER......................................................................................................................................6
OPERATIONAL SYSTEMS .........................................................................................................................6
ORACLE SERVER .......................................................................................................................................6
FILE SERVER ..............................................................................................................................................6
APPLICATION SERVER ................................................................................................................................. 7
OPERATIONAL SYSTEM ........................................................................................................................... 7
SOFTWARE FOR APPLICATION ADMINISTRATION ............................................................................... 7
ORACLE CLIENT ........................................................................................................................................ 7
WORKSTATIONS............................................................................................................................................... 7
OPERATIONAL SYSTEM ............................................................................................................................... 7
ORACLE CLIENT ............................................................................................................................................8
BASIC STRUCTURE ..........................................................................................................................................8
CONFIGURATION 1: CLIENT/SERVER OPTION ..........................................................................................9
CONFIGURATION 2: CLIENTE/SERVIDOR OPTION WITH FILE SERVER ................................................ 10
CONFIGURATION 3: USING AN APPLICATION SERVER ........................................................................... 11
MINIMUM RECOMMENDATION .................................................................................................................... 12
CONSIDERATIONS ...................................................................................................................................... 12
HARDWARE RECOMMENDATIONS .............................................................................................................. 13
WORKSTATION DESKTOP.......................................................................................................................... 13
APPLICATION SERVER ............................................................................................................................... 13
BASIC CONFIGURATION OF A DATABASE SERVER .................................................................................... 13
DATA VOLUME ............................................................................................................................................ 13

Version: 20 2
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

DATABASE SERVER.................................................................................................................................... 13
TECHNICAL SUPPORT ................................................................................................................................... 14

Version: 20 3
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

INTRODUCTION

This document describes the basic infrastructure for the operation of MASTERSAF DW application.

MASTERSAFDW FEATURES

MASTERSAF DW is a Data Warehouse which uses Oracle as a database administrator and programs
written in Power Builder, acting as client, therefore, being a client/server application. Due to these
features, the system requires a large capacity from the processor, communication line (network), in
addition to a continuous database tuning work.

MASTERSAFDW COMPONENTS

DATABASE SERVER (COMPULSORY)

Machine where the Oracle Database Administrator will be installed. This server must have enough disks
and processors to support MASTERSAF DW requirements.

Note: We recommend that the Database Server is unique to MASTERSAF DW.

WORKSTATIONS (COMPULSORY)

Machine with Windows 7 which will be used by the MASTERSAF DW application users to operate, process
and extract reports from the system.

Note: MASTERSAF DW is not compatible with Windows 2003 or lower.

Version: 20 4
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

APPLICATION SERVER (OPTIONAL)

Machine with Windows (2008 or 2012), which will be used as a File Server, thus centralizing the storage
of MASTERSAF DW application’s executable programs. The main benefit of this server is to prevent the
programs from being saved in each workstation, which will impair possible updates.

APPLICATION SERVER (OPTIONAL)

Machine with Windows (2008 or 2012), or TS (Terminal Service) and Citrix XenApp, which may be used
as an application server, centralizing application processing. In this case the workstations start
operating as terminal only. With this server, in addition to application and processing centralization,
the remote users will have the greater benefits, since the processing will be carried out locally.

ORACLE CLIENT (COMPULSORY)

Despite not being a MASTERSAF DW package component, the Oracle Client is essential for the operation
of the MASTERSAF DW application. It is through the same that there is communication between the
workstation and/or the application server and the Database Server.

Note: It is mandatory to use Oracle Client 32 bits, in version 11g Release 2 or higher, preferably
Oracle 12c. Any version less than 11.2 of the Oracle Client is no longer supported.

Any version less than 11.2 Oracle is no longer supported.

MASTERSAF DW APPLICATION (COMPULSORY)

The MASTERSAF DW application is the component installed in the workstations/application server,

being comprised by programs written in Power Builder, which provide the visual interface of the products.

The entire processing and report generation actions are commanded by these programs.

Version: 20 5
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

HARDWARE AND SOFTWARE REQUIREMENTS

DATABASE SERVER

OPERATIONAL SYSTEMS

All 64-bit operating systems supported and homologated by Oracle Server 12c Release 1 (12.1.0.2) or
Release 2 (12.2.0.1), preferably UNIX-Like, are accepted. No version less than 12c Release 1, will be
supported.

For further information refer to Oracle at www.oracle.com.br

Note: When using Windows, use Server instead of Desktop versions.

ORACLE SERVER

• Oracle Server 12c Release 1 (12.1.0.2) or Release 2 (12.2.0.1) 64 bits.

The Oracle Database versions supported by the MASTERSAF DW application are Oracle Database 12c
Release 1 (12.1.0.2) or Oracle Database 12c Release 2 (12.2.0.1). The latter is recommended for the product
due to the numerous bugs in Release 1. No lower version of the 12.1.0.2 will be supported.

ORACLE JVM

It is mandatory the installation of the "JServer JAVA Virtual Machine" (JVM) component is mandatory for
the database.

FILE SERVER

• Windows 2008 or Windows 2012 as operational system.

Version: 20 6
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

APPLICATION SERVER

OPERATIONAL SYSTEM

• Windows 2008 or Windows 2012.

SOFTWARE FOR APPLICATION ADMINISTRATION

• Terminal Service

• Citrix XenApp 6.5 or higher.

ORACLE CLIENT

• Oracle Client 11g Release 2 or 12c Release 2 (mandatory 32-bit).

• If operating system is Windows 7, Windows 8, Windows 2008 or Windows 2012, it is mandatory

to use Oracle 11g Release 2 or Oracle 12C Release 2.

WORKSTATIONS

OPERATIONAL SYSTEM

The following operational systems are accepted:

• Windows 7
• Windows 8
• Windows 2008
• Windows 2012.

Note: MASTERSAF DW is not compatible with Windows 2003 or lower.

Version: 20 7
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

ORACLE CLIENT

• Oracle Client 11g Release 2 or 12c Release 2 (32 bits compulsory)

• If operating system is Windows 7, Windows 8 and Windows 10 it is mandatory to use Oracle 11g
Release 2 or 12c Release 2 of Oracle Client.

Note: In case an application server is used, the installation of Oracle Client at the workstations will not
be necessary.

BASIC STRUCTURE

Transaction Systems (ERP)

Local Users

Server (optional)

Application Server

Interface

MasterSAF

Database Server Remote Users

Version: 20 8
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

CONFIGURATION 1: CLIENT/SERVER OPTION

Local Users
MasterSAF

Database Server

Remote Users

BENEFITS

• Good performance at program loading when both layers are hosted in the same LAN
• Simple structure
• Low investment.

What is installed in the Database Server:

• Oracle Server
• MASTERSAF DW Database Objects
• Memory_target = 10G
• CHARACTERSET = WE8MSWIN1252
• NLS_LENGTH_SEMANTICS = BYTE (Default).

Note: Both the database server and the Oracle instance must serve only the MASTERSAF DW
application, ONESOURCE ECF/eSOCIAL and MASTERSAF TAX ANALYSER. Do not use
MASTERSAF DFE application at the same instance or the same server as MASTERSAF DW.

What is installed in the workstations

• Oracle Client compatible with operational system

• MASTERSAF DW Application

Version: 20 9
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

CONFIGURATION 2: CLIENTE/SERVIDOR OPTION WITH FILE

SERVER
Local Users

File Server

MasterSAF DW

Remote Users

BENEFITS

• Program centralization;
• Maintenance in a single place.

What is installed in the Database Server:

• Oracle Server;
• MASTERSAF DW Database Objects;
• Memory_target = 10G;
• CHARACTERSET = WE8MSWIN1252;
• NLS_LENGTH_SEMANTICS = BYTE (Default).

Note: Both the database server and the Oracle instance must serve only the MASTERSAF DW
application, ONESOURCE ECF/eSOCIAL and MASTERSAF TAX ANALYSER. Do not use
MASTERSAF DFE application at the same instance or the same server as MASTERSAF DW.

Version: 20 10
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

What is installed in the workstations

• Oracle Client compatible with operational system;

• Shortcuts for MASTERSAF DW Application.

What is installed in the file server

• MASTERSAF DW Application.

CONFIGURATION 3: USING AN APPLICATION SERVER

Local Users

Application Server

Remote Users

MasterSAF DW

BENEFITS

• Program centralization;
• Maintenance in one single place;
• Good performance for remote users;
• Low investment in workstations.

What is installed in the Database Server:

• Oracle Server;
• MASTERSAF DW Database Objects;
• Memory_target = 10G;
• CHARACTERSET = WE8MSWIN1252
• NLS_LENGTH_SEMANTICS = BYTE (Default).

Version: 20 11
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

Note: Both the database server and the Oracle instance must serve only the MASTERSAF DW
application, ONESOURCE ECF/eSOCIAL and MASTERSAF TAX ANALYSER. Do not use
MASTERSAF DFE application at the same instance or the same server as MASTERSAF DW.

What is installed in the workstations:

• Client Citrix XenApp;

• Client Terminal Service.

What is installed in the application server:

• MASTERSAF DW Application;
• Oracle Client 32 bits on version 11g Release 2 or 12c Release 2
• Citrix XenApp (optional, IF using application administration tool);
• Terminal Service Server.

MINIMUM RECOMMENDATION

CONSIDERATIONS

The recommendations contained in this document are minimum configurations for the MASTERSAF
DW system processing, not taking into consideration the level of service desired by the client and
separating all further technical components of the infrastructure used.

MASTERSAF - Thomson Reuters is not held responsible for performance or configuration difficulties in
the equipment acquired by client, even if, it has somehow suggested a certain configuration.

We warn that the equipment or configurations contained in this document have to be revised on a
yearly basis, and, if necessary, equipment upgrades or replacement have to be carried out. It is
extremely important that the equipment chosen for the solution installation is scalable.

We also remind that these recommendations are for equipment used solely by the MASTERSAF DW
application, with the software versions contained in this document.

Version: 20 12
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

HARDWARE RECOMMENDATIONS

WORKSTATION DESKTOP

• Intel Core 2 Duo Processor or Higher

• 8 GB RAM
• 50 GB free space in disk
• Windows 7, Windows 8 and Windows 10
• Clearance of SMTP Protocol in the Workstation to send wage and tax statement.

APPLICATION SERVER

• 1 Xenon Dual Core 2.0 Ghz or Higher

• Minimum 16 GB RAM
• 100 GB of free space in disk
• Windows 2008 or Windows 2012
• Terminal Service and/or Citrix XenApp 6.5 or higher.

BASIC CONFIGURATION OF A DATABASE

SERVER

DATA VOLUME

• We recommend an analysis of the data volume to enable base sizing.

• The recommendations below are for the following data volume (e.g., 40 GB per year).

DATABASE SERVER

• Intel Platform:

Version: 20 13
Lasted update: 01/08/2019
MASTERSAF DW BASIC INFRASTRUCTURE

⋅ Oracle 11.2.0.4 or 12c Release 2 (64 bits, Homologated for 12.2.0.1 version);
⋅ 2 Xenon Dual Core 2.0 GHz processors or AMD Opteron Dual Core 2.0 GHz or higher;
⋅ 16 GB RAM;
⋅ 2 73 Gb SAS/RAID 1 Disks;
⋅ Operational system compatible with Oracle 11.2.0.4. We do not provide support to any version
under oracle 11.2.0.4.

• Risc Platform

⋅ Oracle 11.2.0.4 or 12c Release 2 (64 bits, Homologated for 12.2.0.1 version);
⋅ 16 GB RAM;
⋅ 4 Processors/Core;
⋅ 2 73 Gb Raid 1 Disks;
⋅ Operational system compatible with Oracle 11.2.0.4. We do not provide support to any version
under oracle 11.2.0.4.

SUGGESTION FOR CONFIGURATION

If applicable, TSL may suggest a minimum Database server configuration for MASTERSAF DW. In this
case, please send a request to your Business Representative or Account Manager.

To calculate the disk space and the Database server configuration, it is necessary to fill in a questionnaire
in which the company’s monthly flow volume will be informed.

TECHNICAL SUPPORT

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

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

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

Version: 20 14
Lasted update: 01/08/2019