Configurar o Essbase no Windows

É necessário configurar o Essbase no Windows usando a Ferramenta de Configuração após a instalação.

Pré-requisitos e Observações

O Fusion Middleware já deve estar instalado e o Oracle Essbase deve estar instalado no mesmo diretório do Oracle Home. Consulte Instalar Fusion Middleware.
O banco de dados relacional suportado deve ser instalado, conforme mencionado nos pré-requisitos de instalação. Consulte Instalar um Banco de Dados Relacional.
Se você estiver usando a autenticação do EPM Shared Services, já deverá ter uma versão suportada do EPM instalada, com os usuários do EPM Shared Services criados e configurados e conhecer os detalhes da instância do Oracle Home e do EPM.
- Se estiver usando a autenticação do EPM Shared Services, ela deverá estar em execução durante a configuração do Essbase. Se o EPM Shared Services não estiver em execução, alguns números de porta deverão ser configurados manualmente para evitar conflitos de porta. Ao configurar o Essbase, você deve ser cauteloso e estar ciente das portas que já estão em uso por qualquer serviço do EPM neste host, e escolher e usar apenas portas válidas que não são usadas por um serviço ou aplicativo neste host. Você também deve definir esses números de porta não utilizados de acordo na interface do usuário ou no arquivo de resposta.
Se você estiver usando o Microsoft SQL Server (MSSQL) como o banco de dados para esquemas do repositório do Essbase (RCU), execute o processo para alterar o banco de dados e aplicar o agrupamento correto e abordar considerações de esquema antes de executar a ferramenta de configuração do Essbase. Para obter mais informações, consulte Configurar o Microsoft SQL Server como Banco de Dados de Repositório para Esquemas do Essbase.
Pré-criar Esquemas RCU para Essbase explica o processo se você optar por pré-criar esquemas RCU antes da configuração, em vez de criar a Ferramenta de Configuração para você. Um caso de uso para pré-criar esquemas é se você estiver empregando uma conexão HTTPS segura usando uma wallet.
No Painel de Controle do Windows > Relógio e Região > Região, selecione guia Administrativo. Clique em Alterar Localidade do Sistema e marque as caixas de seleção Beta: Usar Unicode UTF-8 para suporte ao idioma mundial.
O Essbase no Windows não pode ter várias configurações ou instâncias no mesmo host.
Você deve aplicar os seguintes patches no Oracle Home antes de criar esquemas RCU, independentemente de usar ou não esquemas pré-criados. Verifique os patches mais recentes na seção Notas da Versão do Essbase para Implantação Independente ou entre em contato com o Suporte para verificar as versões de patch apropriadas.
- 28186730 - versão mais recente do OPatch 13.9.4.2.x para FMW/WLS
- 31676526 - patch 12.2.1.4.0 para aviso TNS_ADMIN RCU
- 30540494 - patch 12.2.1.4.0 para bug RAC RCU
- 30754186 - patch 12.2.1.4.0 para erro RAC RCU
Todas as portas não devem estar dentro da faixa de portas efêmeras, nem em uso por outro software em execução. Consulte Evitar Conflitos de Porta.
Cada servidor gerenciado deve ser atribuído a uma máquina, a representação lógica do computador que hospeda uma ou mais instâncias do servidor. O nome da máquina deve ser exclusivo em relação a outros recursos configuráveis no domínio.
Se você planeja instalar e configurar mais de uma instância On-Premise do Essbase, para suportar failover, você precisa de um balanceador de carga front-end, e as instâncias devem ser configuradas em diferentes hosts. Conforme mencionado, o Essbase no Windows não pode ter várias configurações ou instâncias no mesmo host. Consulte Configurar um Balanceador de Carga para Suportar Failover.
Se o serviço do Essbase precisar ser configurado ou estar disponível como serviço do Windows do Essbase, para iniciar e interromper o serviço do Essbase, o PowerShell deverá estar na variável CAMINHO do ambiente. Você também deve ativar o Serviço do Windows do Essbase durante a configuração para instalar o serviço do Windows.
Se você estiver se conectando por meio do Smart View, usando o URL /aps/SmartView, será necessário alterar o URL. Consulte Redirecionar para o Novo URL de Conexão do Essbase Smart View. Como alternativa, você pode configurar o redirecionamento para o novo URL no servidor Web. Se você estiver usando o Oracle HTTP Server (OHS) ou o HTTPD Server, redirecione o URL ao modificar a configuração do Oracle HTTP Server, conforme observado no marcador anterior.
Para acessar o arquivo de resposta e usá-lo, defina as variáveis de ambiente TEMP e TMP para o usuário da seguinte forma:
1. Na barra de tarefas do Windows, clique com o botão direito do mouse no ícone Windows e selecione Sistema.
2. Na página Definições, no cabeçalho Definições Relacionadas à direita, clique em Informações do Sistema e, em seguida, em Definições Avançadas do Sistema.
3. Selecione Variáveis de Ambiente.
4. Clique em Novo para criar novas variáveis de ambiente TEMP e TMP ou clique em Editar para modificar as variáveis de ambiente existentes TEMP e TMP, com os valores das variáveis de usuário. Você pode usar o mesmo valor para ambos.
5. Depois de definir, abra um novo cmd ou prompt de comando para refletir o novo conjunto de variáveis.

Executar Ferramenta de Configuração

Se não tiver continuado a configuração no final da instalação, inicie a Ferramenta de configuração.
1. No diretório do Oracle Home, onde o Essbase e o Fusion Middleware estão instalados, abra um terminal no \essbase\bin. Por exemplo, abra um terminal em <Oracle_Home>\essbase\bin.
2. Inicie a Ferramenta de configuração usando o script de comando config.cmd.
```
config.cmd
```
  O script pode ser executado com parâmetros (como -mode, -log, -log priority, -responseFile). Se você usar o parâmetro responseFile, todos os campos serão preenchidos com as entradas de configuração anteriores, exceto as senhas. Para saber mais sobre opções de script de configuração, execute: config.cmd -help.
Na página Bem-vindo, clique em Avançar.
Na página Detalhes do domínio, faça o seguinte.
1. Aceite o padrão (se correto) ou digite seu nome de domínio, por exemplo, essbase_domain.
2. Aceite o padrão (se correto) ou insira o caminho raiz do domínio, por exemplo,
```
C:\Oracle_home\dist\domains
```
3. Aceite o padrão ou insira seu diretório de aplicativos, por exemplo,
```
C:\Oracle_home\dist\applications\essbase
```
  Recomenda-se que o diretório de aplicativos seja separado dos arquivos de configuração.
4. Informe o nome e a senha de uma conta de administrador do WebLogic que você usará para gerenciar os servidores do Essbase e do middleware.
  - Se você usar LDAP Incorporado do WebLogic, esse administrador também receberá uma função de administrador de serviço do Essbase.
  - Se você usar o EPM Shared Services, esse administrador será apenas para a instância do domínio WebLogic do Essbase. O usuário admin do EPM Shared Services será provisionado com a função de usuário do Essbase: Administrador de Serviços.
5. Clique em Próximo.
Na página Conexão de banco de dados, faça o seguinte.
1. Aceite o padrão ou digite o tipo de banco de dados. Este é o banco de dados relacional suportado, por exemplo, Oracle Database.
2. Informe a string da conexão, por exemplo,
```
myhost.example.com:1521/orcl
```
  Consulte Formatos de String de Conexão.
3. Escolha se deseja criar novos esquemas agora ou usar esquemas pré-criados que você criou usando o utilitário RCU do Fusion Middleware em Pré-criar Esquemas RCU para Essbase, como uma tarefa de workflow de pré-configuração. Se estiver usando o Microsoft SQL Server (MSSQL) na configuração, consulte o pré-requisito relacionado acima.
4. Informe um prefixo de esquema, por exemplo, ESS26AI. Deve ser uma string nova e exclusiva, contendo de 1 a 12 caracteres alfanuméricos e começando com uma letra.
5. Informe uma senha de esquema que será compartilhada para todos os novos esquemas.
6. Para o nome de usuário e a senha do administrador, informe as credenciais de qualquer usuário que tenha recebido uma atribuição sysdba para o Oracle Database. Pode ser o usuário sys padrão ou o administrador de banco de dados da Microsoft. O nome de usuário deve começar com uma letra e conter entre 5 e 128 caracteres alfanuméricos. A palavra-passe deve começar com uma letra, conter entre 8 e 30 caracteres, pelo menos um número e, opcionalmente, qualquer número dos caracteres especiais ($ # _).
7. Clique em Próximo.
Na página Configuração do Gerenciador de Nós, faça o seguinte.
1. Aceite os padrões ou informe a string para o nome da máquina do Gerenciador de Nós, que trata clusters. Todas as portas não devem estar dentro da faixa de portas efêmeras, nem em uso por outro software em execução. Consulte Evitar Conflitos de Porta.
2. Para Endereço de Listening do Gerenciador de Nós, você pode informar ou selecionar o nome do host totalmente qualificado (em que o WebLogic está instalado junto com a instalação do Fusion Middleware). Também pode ser um endereço do sistema operacional. Para referência, consulte Configurar Endereços de Listening.
3. Clique em Próximo.
Na página Configuração de Portas do Servidor WebLogic, configure de acordo com as opções feitas durante a instalação.
Aceite os padrões ou insira valores. Os valores na tela acima são apenas exemplos. Especifique portas claras e seguras para cada um dos servidores. Consulte Opções de Configuração do Servidor. Todas as portas não devem estar dentro da faixa de portas efêmeras, nem em uso por outro software em execução. Consulte Evitar Conflitos de Porta.
1. Para proteger conexões usando o TLS Everywhere (Transport Layer Security), marque a caixa de seleção Secure Connection Mode; seu certificado autoassinado será reconhecido. Se você ainda não fez isso, revise este tópico: Sobre a proteção da comunicação e da rede. Se a segurança TLS for implantada, a porta padrão será a porta Segura do Servidor Gerenciado. O valor de porta padrão é 9000 para não seguro e 9001 para seguro. É recomendável usar o seguro (9001).
  
  Se você configurar o Essbase para usar um banco de dados relacional não Oracle como o banco de dados do repositório RCU, talvez seja necessário executar etapas adicionais, após a conclusão da implantação do Essbase, para configurar os drivers ODBC do sistema para suportar criptografia segura/TLS. Consulte as instruções de configuração do driver de banco de dados.
2. [Opcional] Para limitar o acesso a hosts específicos (para ambiente multi-home), especifique ou selecione um domínio, por exemplo, localhost, nos campos de endereço do listener. Se você não selecionar/inserir valores de endereços de listening, os endereços de listening se aplicarão a todas as interfaces e endereços, e todos os hosts mapeados estarão acessíveis.
3. Clique em Próximo.
Na página Configuração de Portas do Essbase, faça o seguinte.
1. Aceite os padrões ou informe valores para a Porta do Agente, a Porta Segura do Agente (usada para comunicação segura usando TLS) e as portas mínimas e máximas dos servidores de aplicativos do Essbase.
  - Porta do Agente especifica a porta para o Agente do Essbase - o padrão é 1423.
  - Porta Segura do Agente especifica a porta que o Agente do Essbase usa para comunicação segura quando no modo de conexão segura com o TLS (Transport Layer Security) - o padrão é 6423.
  - Quando várias instâncias do Essbase Server forem instaladas em um host, você deverá especificar um número exclusivo de porta para cada instância.
  - Todas as portas não devem estar dentro da faixa de portas efêmeras, nem em uso por outro software em execução. Consulte Evitar Conflitos de Porta.
  - O intervalo entre as portas Mín. e Máx. deve ser pelo menos 1000, dependendo do valor usado.
2. Clique em Próximo.
Na página de configuração do Provedor de Identidades, faça o seguinte.
1. Se você ainda não o fez, revise o tópico Selecionar Provedor de Autenticação.
2. WebLogic é o padrão. Se você estiver usando o EPM Shared Services e quiser continuar, marque a caixa de seleção Ativar Provedor de Identidades do EPM Shared Services. O exemplo da janela mostra o provedor do EPM selecionado. Quando habilitados, os campos do EPM estão disponíveis para você confirmar ou especificar os locais do EPM Oracle Home e da Instância Oracle. Para obter detalhes sobre isso, consulte Sobre Middleware Home, EPM Oracle Home e EPM Oracle Instance.
3. Para que o serviço do Windows do Essbase seja configurado ou esteja disponível, para iniciar e interromper o serviço do Essbase, o PowerShell deve estar na variável de ambiente PATH. Você também deve ativar o Serviço do Windows do Essbase durante a configuração para instalar o serviço do Windows. Para usar esse recurso, você deve selecionar Habilitar o Essbase Windows Service, nesta página, para instalar o serviço Windows. O início e a interrupção do Serviço do Windows do Essbase são feitos usando o Windows SCM.
4. Clique em Próximo.
Revise a página Resumo da Configuração. Observe o local do arquivo de log (se mostrado) e o local do arquivo de resposta. Este exemplo de janela pode variar em relação às entradas ou valores selecionados. Você pode usar o arquivo de resposta (.rsp) para salvar suas opções de configuração e preencher os mesmos valores de campo (excluindo senhas) em uma futura configuração de modo Silencioso ou baseada na IU. Se quiser executar uma configuração futura usando um arquivo .rsp, você também poderá executar a configuração até a página de resumo, clicar em Cancelar em vez de Configurar e reutilizar o arquivo de resposta posteriormente. O arquivo .rsp é salvo no local temporário listado no resumo como Local do arquivo de resposta. Se você planeja usá-lo para automatizar uma configuração futura, certifique-se de salvá-lo em algum lugar mais permanente, pois os diretórios tmp podem ser rotineiramente limpos. Consulte Parâmetros e Arquivo de Resposta de Amostra.
Clique em Configurar. Na página Andamento da Configuração, perto do final do processamento da Ferramenta de Configuração, os componentes da plataforma do Essbase são iniciados. Quando o andamento atingir 100%, clique em Próximo.
Na página Configuration Complete, revise os detalhes e clique em Finish. Observe que este exemplo de janela não reflete necessariamente as entradas ou valores selecionados. Agora você pode fazer login no Essbase. Para URLs de login, consulte Essbase, REST e URLs do Cliente do Smart View.
Observação:

Se você tiver configurado o Essbase com segurança com um banco de dados externo usando um alias TNS_ADMIN, por exemplo, adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS, deverá fazer o seguinte para que a conexão possa ser processada pelo servidor do Essbase:
1. Editar:
```
<DOMAIN_HOME>\bin\setStartupEnv.cmd
```
2. Adicione a seguinte linha ao script de inicialização, antes do uso do -DODBC_URL=:
```
set TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS
```
3. Altere a seguinte linha:
```
-DODBC_URL='OCI;SERVICE=adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS'
```
  para
```
-DODBC_URL='OCI;SERVICE='adwsql_low'
```

As opções e tarefas avançadas e pós-configuração podem ser revisadas em Tópicos de Configuração Avançada. Isso inclui tópicos sobre como excluir esquemas do RCU, configurar o Essbase e o servidor Oracle HTTP e muito mais.