Histórico da Página
...
É necessário instalar o URL Rewrite e o ARR (Application Request Routing) no IIS.
...
id | 1 |
---|---|
effectType | fade |
...
effectDuration | 0.1 |
---|---|
label | 1 - Instalar Application Request Routing (ARR) |
effectType | fade |
Fazer o download do ARR no link https://www.microsoft.com/en-us/download/details.aspx?id=47333.
Fazer a instalação no mesmo servidor do Portal do Professor e ao final da instalação deve ser habilitado o proxy do ARR.
...
effectDuration | 0.1 |
---|---|
label | 2- Instalação e Configuração do URL Rewrite |
effectType | fade |
...
id | 2 |
---|
...
label | Instalação do URL Rewrite |
---|---|
effectType | fade |
1. Acessar o IIS (como administrador) | Clicar na opção: "Obter Novos Componentes Web Plataform"
2. Em seguida, será habilitado uma tela, onde serão carregados as plataformas Web.
3. Pesquisar por “URL Rewrite” e clicar na opção: Add:
4. Após a Instalação, será criado um ícone: “URL Rewrite” no IIS
...
effectDuration | 0.1 |
---|---|
label | Configuração do URL Rewrite |
effectType | fade |
É necessário configurar duas regras para o rewrite, onde a primeira é utilizada para direcionamento de api's onde não é necessário passar o alias selecionado e a segunda é utilizada para as api's onde é necessário passar o alias selecionado. Segue a configuração das duas regras:
1º Regra:
1. Acessar o IIS -> Ir no aplicativo do Portal do professor-> URL Rewrite
2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.
Inserir as informações:
3. No campo "Name" informar um nome para a regra que está sendo criada
4. Na opção: Match URL, no campo: "Pattern" inserir as informação: aliasname\.(.*)/api/(.*)
5. Na opção: "Actions", no campo: Rewrite URL informar o link: http://{R:1}.nome_da_maquina_do_host:porta/api/{R:2}
6. Marcar a opção: "Stop processing of subsequent rules"
2º Regra:
1. Acessar o IIS -> Ir no aplicativo do Portal do professor-> URL Rewrite
2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.
Inserir as informações:
3. No campo "Name" informar um nome para a regra que está sendo criada
4. Na opção: Match URL, no campo: "Pattern" inserir as informação: api/(.*)
5. Na opção: "Actions", no campo: Rewrite URL informar o link: http://nome_da_maquina_do_host:porta/api/{R:1}
Aviso | ||
---|---|---|
| ||
A porta utilizada deve ser a mesma que está configurada na chave "ApiPort" no arquivo de host (RM.Host.Service.exe.config, se utilizar o Host Service e RM.Host.exe.config, se utilizar o Host local). Ver a aba Configurações do config. A ordem das regras devem ser respeitada. |
...
effectDuration | 0.1 |
---|---|
label | 3- Configuração do Hosts |
effectType | fade |
Acessar o RM.Host.Service.exe.config (Se o cliente utilizar o Host Service) ou RM.Host.exe.config (Se o cliente utilizar o Host local) na Pasta: Totvs\RM.Net\Bin da versão e inserir as chaves:
<add key="ApiPort" value="Porta definida no Host" />
<add key="DefaultDB" value="CorporeRM" />
<add key="SubDomainMask" value="[ALIAS].Nome_Da_Maquina_Do_Host" />
Aviso | ||
---|---|---|
| ||
Para a opção "SubDomainMask", o nome da máquina deve ser inserido todo utilizando letras minúsculas. O texto [ALIAS] não deve ser alterado, deve ser inserido o texto desta forma, o que deve ser alterado é o "nomeDaMaquinaDoHost". Exemplo: a máquina do host possui o nome de ServerXYZ, desta forma, deve ser inserido o texto [ALIAS].serverxyz. |
...
label | 4- Configuração do Portal |
---|
Após configurar o servidor conforme o item de pré-requisito, é necessário configurar o arquivo de configuração no portal do professor. Para isso, acessar o arquivo config.js que está disponível no caminho padrão do instalador do novo Portal do Professor. “C:\totvs\CorporeRM\FrameHTML\Web\App\Edu\PortalDoProfessor\config”.
No arquivo, as seguintes configurações são possíveis:
1- O item "apiServer" deve ser configurado de acordo com a abordagem escolhida no item pré-requisito, deve ser informado o endereço que está configurado as APIs.
2- O item "basePath" deve ser configurado com o mesmo caminho relativo utilizado no portal.
3- O item "defaultAlias" deve ser configurado com o alias padrão utilizado para fazer o acesso a base de dados, este alias deve existir no arquivo alias.dat.
4- O item "imgBannersLogin" são os banners que são exibidos na tela de login do portal, para alterar, adicionar/remover itens, basta adicionar um novo item ou remover um item da lista, a imagem deve ser adicionada no caminho "C:\totvs\CorporeRM\FrameHTML\Web\App\Edu\PortalDoProfessor\assets\img\banners-login", o nome adicionado na lista deve ser o mesmo nome da imagem adicionada neste caminho.
- O item "basePath" deve ser o mesmo caminho relativo utilizado no portal.
- O item "imgBannersLogin" está configurado com 3 imagens, o que fará com que na tela de login, sejam exibidas em forma de carrossel estas imagens.
...
label | 5 - Configuração dos Hosts |
---|
Esta configuração é necessária ser realizada em todas as máquinas que o IIS (internet information service) estiver configurado. Isto é necessário porque quando a requisição da api chega no iis, ela é filtrada pelo módulo do Rewrite e é redirecionada para o host, mas como a requisição vem do IIS, o mesmo não consegue encontrar o endereço do host, desta forma, a configuração que é feita no arquivo de host do Windows, irá informar para o IIS qual a máquina do host. A seguir segue o passo a passo da configuração:
- Acessar o arquivo de host do windows (geralmente se encontra em C:\Windows\System32\drivers\etc\hosts)
- Para cada alias cadastrado no rm, deve existir um registro no arquivo de host. Deve ser inserido um registro no mesmo padrão que foi informado no arquivo de configuração do host (ver a configuração do Rewrite, na aba configuração do config), onde deve ser inserido no seguinte padrão: Nome_Do_Alias.Nome_Da_Maquina_Do_Host todo em minúsculo.
Exemplo: Como exemplo, existem dois alias cadastrados no rm, um com o nome de CorporeRM e outro com o nome de CorporeRMOracle, e existe duas máquinas rodando o IIS e nestas maquinas rodam o host, uma com o nome de ServerXYZ e outra com o nome de SERVERZYX, desta forma, no arquivo de host da máquina ServerXYZ, ficaria da seguinte maneira:
...
Para a máquina SERVERZYX:
- 127.0.0.1 corporerm.serverzyx
- 127.0.0.1 corporermoracle.serverzyx
...
label | 5- Configuração das Bases de Dados |
---|
O acesso a base de dados é feita através da utilização dos alias. O portal busca os alias que estão cadastrados no rm.exe, caso possua apenas um alias cadastrado, o combo para selecionar os alias não é exibido e o alias é automaticamente selecionado.
...
effectDuration | 0.1 |
---|---|
label | 6- URL do Novo portal do Professor |
effectType | fade |
...