Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Tempo aproximado para leitura: 2 min

CONTEÚDO

Índice
exclude.*CONTEÚDO
stylenone
separatornone

01. OBJETIVO

Auxiliar no processo de instalação e configuração ou atualização do serviço SARA | RESTServer.

02. ARQUIVOS PARA INSTALAÇÃO

Informações
iconfalse
titleATENÇÃO
O pacote do RESTServer é incremental, desta forma é aconselhável aplicar o último pacote de expedição liberado onde contempla todas as atualizações. 

Os arquivos para a instalação do serviço podem ser encontrados dentro do pacote de expedição oficial do sistema SARA, ou por meio de pacotes incrementais destinados ao RESTServer publicados na Central de Downloads, da página de suporte da TOTVS.

Como exemplo, abaixo segue a pasta com os arquivos localizados dentro do pacote de expedição da versão/release 12.01.44. 

Image Modified

Dentro da


Na pasta RESTServer

, terá

haverá um arquivo com a versão/build do RESTServer

, normalmente

.

Normalmente será o mesmo número da versão do pacote oficial e durante a release poderão ser gerados

build´s

builds contendo manutenções ou melhorias.

Image Modified

Dentro da


Na pasta da versão

, conterão

existirão os seguintes arquivos:

Image Modified

03.

Instalando o

INSTALAÇÃO DO SARA |

RESTServer

RESTSERVER

3.1

)

O serviço RESTServer possui incompatibilidade com servidores que possuem

sistema operacional

Sistema Operacional:

  
    • Windows Server 2008 R2
    • Windows Server 2008, Windows
8 e 
    • 8
    • Windows 8.1
.

Recomendamos a instalação do serviço RESTServer em servidores Windows Server 2012 R2 ou superior.

 

Não é necessário estar no mesmo servidor de

banco

Banco de

dados

Dados ou no

servidor

Servidor utilizado para repositório dos executáveis dos módulos e arquivos INI do

sistema

Sistema SARA.

 

A Instalação

poderá

pode ser

feita

efetuada sem nenhuma dependência do legado.

 

Por recomendação e organização, o serviço poderá estar instalado no

servidor

Servidor de repositório dos executáveis, criando uma pasta chamada SERVICES e uma subpasta chamada RESTServer (sugestão).

Exemplo

:


Veja nesta

Observe neste exemplo, que

dentro da

na pasta

Service,

SERVICES

tem

existe o serviço do EAIService instalado, que também não possui nenhuma dependência com o RESTServer atualmente.

Na pasta RESTServer,

criar

crie uma nova pasta chamada

"Bin", e copiar

Bin.

Copie os arquivos de instalação mencionados no

item 2

tópico 02 - Arquivos Para Instalação para dentro desta pasta.

Image Modified

NOTA:


Informações
iconfalse
titleImportante
A instalação do RESTServer ocorre de forma incremental, ou seja, ao instalar a última versão, todas as dependências e versões anteriores serão automaticamente instaladas.


3.2

)

Para a instalação do serviço, deverá ser executado o arquivo AppServerM.exe como Administrador.

3.3

)

Ao executar o instalador

,

serão solicitados os parâmetros iniciais para conexão com o

banco

Banco de

dados

Dados.

Image Removed

Informe

         Informe o driver de

banco

Banco, o nome e instância do banco de dados, o nome da base de dados, o usuário (operador do serviço) e a senha.

O

         O usuário (Operador de serviço), poderá ser o usuário SA ou um usuário criado apenas para a execução do serviço

, não

. Não é recomendado vincular um usuário do

sistema

Sistema
         (Pessoa).

4)


Image Added


3.4.  Na pasta

"

Arquivos

",

poderá ser configurado os diretórios para LOG de erros, execução e tradução do RESTServer. Por

Default,

padrão o instalador sugere os nomes

conforme o

de acordo com o
        diretório de instalação.

Image Modified

3.5

)

Na pasta

"

Outros

"

,

configurar

configure o idioma, a porta e o nome do serviço para o

WINDOWS

Windows.

Image Modified

3.6

)

Após informar os parâmetros,

acionar o botão "SALVAR FECHAR"

clique em Salvar Fechar. Neste momento, o

sistema exibirá

Sistema apresentará a mensagem abaixo.

Image Modified

3.7

) Ao acionar o botão

Ao clicar em OK, o instalador começará a instalação do serviço exibindo a imagem do SARA abaixo.      
        Neste momento o instalador fará a extração dos arquivos necessários para o serviço.

Image Modified

Pastas criadas:geradas

Image Modified


Abaixo segue o objetivo de cada uma das pastas

criada

geradas:

    • Bin: Pasta de arquivos executáveis referente ao RESTServer e dos módulos (BPL) contendo as funcionalidades do
sistema
    • Sistema.
Config
    • config: Pasta de arquivos de configuração .INI. Para alterar a conexão com o
banco
    • Banco de
dados
    • Dados, usuário entre outras configurações.
    • log: Pasta de arquivos de log de erros, execução e tradução do RESTServer. Erros de instalação, atualização e execução poderão ser consultados nestes arquivos.
    • server: Pasta de arquivos de instalação do APACHE (Serviço WEB).
    • temp: Pasta temporária utilizada no processo de instalação e atualização do RESTServer.  Na pasta SQL, por exemplo, é possível encontrar todos os scripts executados para o banco de dados por release/build.
    • translate: Pasta utilizada para traduções de outros idiomas (
Tradução
    • tradução não implementada até o momento).
    • update:
Para
    • Pasta não utilizada até o momento.

3.8

)

Após as extrações dos arquivos e atualização do

banco

Banco de

dados,

Dados será aberta uma tela para a configuração do

apache

APACHE.

Um serviço APACHE é instalado em conjunto para permitir a execução do  RESTServer.

Também é possível configurar o local onde (pasta) do

servidor apache

Servidor APACHE que rodará as páginas estáticas, podendo ser uma documentação ou uma aplicação WEB.

Os valores poderão ser mantidos os recomendados (

default

padrão).

Após as configurações,

acionar o botão "Salvar fechar"

clique em Salvar Fechar.

Image Modified

3.9

)

Após a configuração do Apache, será exibida a mensagem abaixo e continuará com a instalação efetuando a atualização do banco de dados por meio das scripts enviadas

no


         no pacote.

Image Modified


3.10

)

Após a finalização, o instalador

irá subir

subirá o serviço do APACHE e o RESTServer estará pronto para

USO

utilização.

Image Modified

3.11

)

Em caso de inconsistências no processo de instalação, o serviço não será executado e as inconsistências deverão ser verificadas nos arquivos de log de erros ou log de
          execução contidos na pasta parametrizada por meio do arquivo CONFIG.INI, mencionado anteriormente.

Image Modified

04.

Atualizando o serviço

ATUALIZAÇÃO DO SERVIÇO SARA |

RESTServer

RESTSERVER

Para efetuar a atualização do serviço SARA | RESTServer, seguir os seguintes passos:

4.1

)

Para consultar o histórico de atualizações do RESTServer, você poderá efetuar a consulta na tabela

"

APP_PACKAGE_ATUALIZATION

"

, publicada na base SARA_DB do

banco de dados


        Banco de Dados.

Na imagem abaixo é possível verificar a data de atualização de cada release/build.

Image Modified


4.2

)

Também é possível consultar os nomes dos arquivos de scripts que foram atualizados no banco de dados em cada uma das versões, para isto basta consulta a tabela

"Image Removed


        APP_PACKAGE_ATUALIZATION_ITEM.


O conteúdo de cada arquivo poderá ser consultado na pasta TEMP / SQL no diretório de instalação do RESTServer.

Image Added


4.3

)

Para o processo de atualização, deverá ser baixado o pacote oficial da release ou apenas o patch de atualização do RESTServer, ambos podem ser encontrados em
        downloads na página de

suporte

Suporte da TOTVS.

 

4

)

.4.  No processo de atualização, não é necessário atualizar todas as versões pendentes para atualizar a última versão. Atualizando a última versão o instalador efetuará a

instalação


         instalação dos pacotes anteriores automaticamente. Portanto, para instalar uma nova versão ou atualizar para a última versão, basta aplicar o último pacote.

4

)

.5.  Após download, deve ser extraído os arquivos de dentro da pasta da release/build e copiados para dentro da pasta

"BIN"

Bin, no diretório de instalação do RESTServer.

Arquivos de atualização

:


Image Modified

Arquivos copiados para a pasta Bin

Image Modified

5)


4.6.  Para executar o processo de atualização, basta executar o arquivo AppServerM.exe como

administrador

Administrador.

Assim que executar será exibido a tela abaixo:

Image Modified

6)


4.7.  Para o processo de atualização, não será necessário nenhuma informação ou interação, o próprio instalador irá parar o serviço do SARA | RESTServer, efetuará a atualização

dos


         dos arquivos necessários e scripts de atualização de

banco de dados caso houver. 7)

Banco de Dados, se houver.

4.8.  Após o término da atualização o instalador será fechado.

 

Neste momento

dever ser

, será verificado se o serviço SARA | RESTServer foi iniciado novamente.

Também poderá se consultado

Também poderão ser
         consultados os arquivos de

LOG´s

Logs, para identificar se houve alguma falha durante o processo de instalação.

Image Modified

8)


4.9.  Após a conclusão da atualização, poderá ser consultado o histórico de atualização do RESTServer na tabela do

sistema

Sistema.

Image Modified

05.

Controle de segurança para execução das API´s por método.

CONTROLE DE SEGURANÇA PARA EXECUÇÃO DE APIS POR MÉTODO

Após o processo de instalação ou atualização do SARA | RESTServer

, deverá

deve ser realizado o processo de permissões para a execução das

API´s

APIs por perfil de usuário.

No Módulo

segurança

Segurança do

sistema

Sistema SARA (legado), foi criado

o

um módulo chamado

"

REST SERVER

"

, e

criado

desenvolvido 3 menus principais, conforme imagem abaixo

.

:



Na pasta:

    • API | LOCAL
, estarão
    • - estão localizadas as
API´s
    • APIs que não possuem restrições de acesso relacionadas
a
    • ao PORTAL, ou seja,  um determinado LOGIN somente
poderá
    • pode acessar informações de alguns
CLIENTES conforme
    • clientes, de acordo com o cadastro das permissões relacionadas ao PORTAL.
Na pasta

    • API | PORTAL
, estarão
    • - estãolocalizadas as
API´S
    • APIS que possuem restrições de acesso relacionadas
a
    • ao PORTAL, portanto,
portando
    • um determinado LOGIN somente
poderá
    • pode acessar as informações dos
CLIENTES conforme o
    • clientes, de acordo com cadastro das permissões relacionadas ao PORTAL.
Na pasta

    • API | PÚBLICA
, estarão
    • - estão localizadas as
API´S
    • APIS que não
precisão
    • precisam de autenticação para serem executadas.

O processo de permissões

ficou

permaneceu igual ao legado do SARA, ou seja, para as

API´s

APIs e métodos serão dadas as permissões por

PERFIL

perfil de usuário.

Para um determinado

PERFIL, poderá

Perfil pode ser dada a permissão de GET (consulta) e restringir a permissão de POST (Inserção).

Image Modified

Após as permissões, os usuários vinculados ao perfil poderão executar as

API´s

APIs e métodos normalmente.


Templatedocumentos


HTML
<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>