GUIA DE INSTALAÇÃO DO SINGLE SERVER

INTRODUÇÃO

O objetivo deste guia é especificar as tarefas necessárias para que você possa realizar a instalação e configuração em seu ambiente, da versão Single Server da Plataforma Blazon. A versão Blazon Single Server é disponibilizada por meio de um processo de instalação otimizado, que pode ser instalado em uma configuração com um Banco de Dados H2 embarcado, ou com um Banco de Dados MySQL externo, e a Máquina de Busca Elasticsearch, que pode ser embarcada ou pode ser iniciada externamente.

Observação importante! No caso de se optar pela instalação da versão Blazon Single Server usando o banco de dados H2 e a máquina de busca Elasticsearch, ambos embarcados, o pacote de instalação do Blazon depende de um ambiente Java para sua execução, e das seguintes tarefas de instalação especificadas abaixo.

Considerando que as empresas têm nuances que as tornam únicas, este guia apresenta todas as possibilidades de instalações, incluindo as tecnologias das quais depende em cada caso, e, principalmente, as possíveis configurações do Blazon Single Server para cada cenário, sendo:

Tecnologias;
Pré-requisitos;
Tarefas de Instalação e Configuração;
Inicialização;
Criação do Domínio; e
Configuração de Jobs.

TECNOLOGIAS

De modo geral, o Blazon Single Server pode ser instalado em qualquer Sistema Operacional, sendo que é sugerida a utilização daqueles Sistemas Operacionais mais usados na atualidade tais como MS Windows, MacOS, Chrome OS, em particular, considerando que é uma aplicação server-side, são recomendados os Sistemas Operacionais Linux-like. Em adição à definição do Sistema Operacional, o Blazon Single Server depende das seguintes tecnologias:

Java Virtual Machine (obrigatória);
Banco de Dados MySQL (opcional);
Máquina de Busca Elasticsearch (opcional).

As atividades necessárias a instalação, configuração e inicialização da Plataforma Blazon versão Single Server são especificadas em fases, a fim de tornar mais gerenciável o processo de implantação, para posterior colocação da plataforma em operação. As fases são:

As fases estão enumeradas, representando a sequência temporal adequada, sendo que cada fase especifica as atividades para as instalações dos ambientes e dos sistemas descritos. Deste modo, basta seguir a sequência de fases e as respectivas especificações.

PRÉ-REQUISITOS

Como não poderia deixar de ser, a fase de levantamento de Pré-requisitos deve ser a primeira em qualquer instalação de sistemas. Os pré-requisitos para a instalação e configuração do Blazon Single Server são especificados na tabela a seguir:

Tarefa	Descrição
Instalação e configuração do ambiente JAVA	A Plataforma Blazon especifica o ambiente de execução Java, na versão 8, devidamente instalado e configurado. Basicamente o ambiente requerido contém uma JVM e a respectiva API necessárias à instalação e configuração, sendo que a especificação detalhada pode ser encontrada em nosso Manual de Instalação e Configuração do ambiente Java.
Instalação e configuração do Banco de Dados MySQL (opcional)	A instalação do *Blazon Single Server* requer a criação e configuração de um Sistema Gerenciador de Banco de Dados (DBMS). A versão Single Server é pré-configurada, por default, usando um Banco de Dados H2 embarcado, cuja configuração é recomendada para testes e demonstrações. Ou seja, se a opção for o H2, nenhuma instalação precisa ser feita, uma vez que é o padrão para esta versão. O *Blazon Single Server* possibilita, e recomenda fortemente, a instalação do DBMS MySQL e, se necessário, o nosso Manual de Instalação e Configuração do MySQL especifica os passos aplicáveis.
Instalação e configuração da Máquina de Busca Elasticsearch (opcional)	Para a otimização das buscas internas, o Blazon Single Server usa um esquema de indexação que agiliza as consultas da plataforma. É utilizada a Máquina de Busca Elasticsearch (ELK Stack), que é basicamente um sistema de armazenagem indexada de documentos. Esta versão do Blazon disponibiliza uma instalação padrão que possibilita uma inicialização de um Elasticsearch embarcado, por default. Se for desejável, é possível a instalação e configuração externa do ELK, sendo que o nosso Manual de Instalação e Configuração do Elasticsearch especifica os passos necessários para a instalação e configuração externamente.

TAREFAS DE INSTALAÇÃO E CONFIGURAÇÃO

Atendidos os Pré-requisitos, entende-se que as instalações e configurações da JVM, do DBMS e da ELK estão devidamente feitas. Estamos prontos para executar as tarefas especificadas para o downloading, instalação e configuração do Blazon Single Server, incluindo seus utilitários (Blazon Utilities – que são aplicações especialmente desenvolvidas para inserir dados de inicialização na plataforma).

Tarefa	Descrição
Instalação de Utilitários da Plataforma Blazon	O processo de configuração da Plataforma Blazon requer injeções de conjuntos de dados de inicialização, que são feitas (injeções) por utilitários (Blazon Utilities). A instalação dos Blazon Utilities é especificada no nosso Manual de Instalação de Utilitários da Plataforma Blazon.
Baixando o *Blazon Single Server*	A Plataforma Blazon versão Single Server compreende uma versão completa da plataforma de Gestão de Identidade, embarcada em um único servidor Web Java. O processo de downloading está especificado no nosso Manual de Download do Blazon Single Server.
Instalação do Blazon Single Server	O processo de instalação da Plataforma Blazon na versão Single Server compreende a instalação do Blazon Identity Manager e do Blazon Workspace Application e está especificado em nosso Manual de Instalação da Plataforma Blazon.
Configuração do Banco de Dados MySQL	Após instalar o *Blazon Single Server, é necessário configurar as estruturas de dados do MySQL, lembrando que este passo somente é necessário* no caso da instalação do Blazon utilizando a base de dados no MySQL. Esse procedimento está especificado em nosso Manual de Instalação e Configuração do Banco de Dados.
Configuração do *Blazon Single Server*	O processo de configuração da Plataforma Blazon na versão Single Server compreende na verdade diversas configurações como Datasources, Portas de acesso HTTP entre módulos, Sistema de Mensageria etc. Todas as configurações estão especificadas no nosso Manual de Configurações da Plataforma Blazon.
Configuração de Permissões Internas	A configuração inicial, injeção das permissões internas da Plataforma Blazon, é realizada com o auxílio do utilitário de permissões internas denominado Blazon Internal Permissions Utility. Além do manual do utilitário, o nosso Manual de Configuração de Permissões Internas oferece uma descrição detalhada do processo de Configuração das Permissões Internas.

INICIALIZAÇÃO

Neste ponto se depreende que a Plataforma Blazon foi instalada e configurada, incluindo a injeções de configurações internas, é chegado o momento de inicializar o Blazon Single Server, antes da entrada em operação propriamente dita. O procedimento de inicialização foi projetado para ser simples, conforme pode ser visto na tabela a seguir:

Tarefa	Descrição
Inicialização do *Blazon Single Server*	O processo de inicialização da Plataforma Blazon na versão Single Server compreende a inicialização do servidor Web Java, que conta com um shell script passível de algumas possibilidades de parametrização. O processo está está especificado no nosso Manual de Inicialização da Plataforma Blazon.

CRIAÇÃO DO DOMÍNIO

Neste ponto, podemos dizer que a Plataforma Blazon versão Single Server foi inicializada, todos os módulos planejados na implantação estão ‘no ar’ e falta o procedimento de criação do domínio do Blazon Single Server de Gestão de Identidade da corporação, conforme é descrito na tabela a seguir:

Tarefa	Descrição
Criação do Domínio Corporativo	Por fim, após todas as tarefas descritas nas fases anteriores, a definição do domínio corporativo e a criação do usuário administrativo do Blazon Single Server é a última fase da configuração final. A Plataforma Blazon está operacional. Essa configuração é interativa e é especificada no nosso Manual de Criação de Domínio.

CONFIGURAÇÃO DE JOBS

A fase anterior configurou e inicializou a Plataforma Blazon versão Single Server. Para atingir seu estado operacional, falta apenas a injeção de dados com definições e invocação de instâncias de Jobs corporativos. Esta injeção de dados contextuais da empresa é feita por um dos utilitários da Blazon Identity Management Utility, cuja atividade é especificada na tabela a seguir:

Configuração dos Jobs

A configuração inicial, inserção de Jobs na Plataforma Blazon, é realizada com o auxílio do utilitário de jobs cujo manual de utilização pode ser encontrada em Blazon Jobs Utility. O processo de configuração de Jobs é especificado no nosso Manual de Instalação e Configuração de Jobs.