Objetivo

Os parâmetros de instalação do RM têm como objetivo otimizar o processo de instalação do produto, que tornará a instalação mais rápida e fácil, diminuindo a interação do instalador com o usuário.

Como utilizar os parâmetros

Os parâmetros deverão ser passados no atalho do instalador, pelo executar do Windows ou via prompt de comando.


Instalação

Opções de exibição:


  •  Modo silencioso, sem interação do usuário

(ideia) Observação: No caso de instalação de uma biblioteca “exe”, se deve substituir o “/quiet” por “/verysilent /suppressmsgboxes”, que pode ser substituído somente por “/silent”, caso queira ver as barras de progresso.

  •  Modo autônomo - somente barra de progresso
  • n - Sem interface do usuário
  • b - Interface do Usuário básica
  • r - Interface do Usuário reduzida
  • f - Interface do Usuário completa (padrão)


Tipos de Instalação:


SQL
Tipo de instalaçãoParâmetroOpçãoExplicação


Local

layerLocalTipo de instalação (3 camadas server, 3 camadas client ou local)
dbSQLSistema Gerenciador de Banco de dados utilizado.
dbserverServidor1Hostname ou IP do servidor que está instalado o SGDB. 
dbnameCorporeRMNome da instância utilizada no SGDB. 

(informação) Exemplo MSI: C\BibliotecaRM.msi /passive /qb layer=Local db=SQL dbserver=Servidor1 dbname=CorporeRM

/passive /qb são parâmetros nativos do MSI.

(informação) Exemplo EXE:  C\BibliotecaRM.exe  /SILENT /SUPPRESSMSGBOXES /retry 

/SILENT /SUPPRESSMSGBOXES /retry  são parâmetros nativos do EXE.


ORACLE
Tipo de instalaçãoParâmetroOpçãoExplicação

Local

layerServerTipo de instalação (3 camadas server, 3 camadas client ou local)
dbORACLESistema Gerenciador de Banco de dados utilizado.
dbserverServidor1/InstanciaHostname ou IP do servidor que está instalado o SGDB e sua instância. 

(informação) Exemplo MSI: C\BibliotecaRM.msi /passive /qb layer=Local db=ORACLE dbserver=Servidor1/Instancia

/passive /qb são parâmetros nativos do MSI.

(informação) Exemplo EXE:  C\BibliotecaRM.exe  /SILENT /SUPPRESSMSGBOXES /retry 

/SILENT /SUPPRESSMSGBOXES /retry  são parâmetros nativos do EXE.

SQL Server
Tipo de instalaçãoParâmetroOpçãoExplicação


3 Camadas Server

layerappserver ou jobseverTipo de instalação (3 camadas server, 3 camadas client ou local)
dbSQLSistema Gerenciador de Banco de dados utilizado.
dbserverServidor1Hostname ou IP do servidor que está instalado o SGDB. 
dbnameCorporeRMNome da instância utilizada no SGDB. 
FileserverpathInformar caminho válidoInformar o caminho válido.

(informação) Exemplo MSI: C\BibliotecaRM.msi /passive /qb layer=appserver db=SQL dbserver=Servidor1 dbname=CorporeRM

/passive /qb são parâmetros nativos do MSI.

(informação) Exemplo EXE:  C\BibliotecaRM.exe  /SILENT /SUPPRESSMSGBOXES /retry 

/SILENT /SUPPRESSMSGBOXES /retry  são parâmetros nativos do EXE.


ORACLE
Tipo de instalaçãoParâmetroOpçãoExplicação


3 Camadas Server

layerappserver ou jobseverTipo de instalação (3 camadas server, 3 camadas client ou local)
dbORACLESistema Gerenciador de Banco de dados utilizado.
dbserverServidor1/InstanciaHostname ou IP do servidor que está instalado o SGDB e sua instância. 
FileserverpathInformar caminho válidoInformar caminho válido

(informação) Exemplo MSI: C\BibliotecaRM.msi /passive /qb layer=appserver db=ORACLE dbserver=Servidor1/CorporeRM

/passive /qb são parâmetros nativos do MSI.

(informação) Exemplo EXE:  C\BibliotecaRM.exe  /SILENT /SUPPRESSMSGBOXES /retry 

/SILENT /SUPPRESSMSGBOXES /retry  são parâmetros nativos do EXE.


Tipo de instalaçãoParâmetroOpçãoExplicação


3 Camadas Client

layerclientTipo de instalação (3 camadas server, 3 camadas client ou local)
hostserverServidor1Hostname ou IP do servidor que está instalado como 3 camadas server.
hostport8050Porta utilizada pelo servidor que está instalado como 3 camadas server.

(informação) Exemplo MSI: C\BibliotecaRM.msi /passive /qb layer=client hostserver=Servidor1 hostport=8050

/passive /qb são parâmetros nativos do MSI.

(informação) Exemplo EXE:  C\BibliotecaRM.exe  /SILENT /SUPPRESSMSGBOXES /retry 

/SILENT /SUPPRESSMSGBOXES /retry  são parâmetros nativos do EXE.

Para a instalação de Portais de Forma Personalizada 

Exemplo do comando: msiexec /q /i "TOTVS RM Portal - 12.1.2205.1.msi" addlocal=Default, AppPortalPep, AppPortalCliente com as opções abaiixo:

A opção "/q" realiza a instalação de forma "silenciosa", sem abrir nenhuma tela para o usuário. -

A opção "addlocal" permite selecionar quais componentes do instalador deseja-se instalar.

Atualmente, os componentes possíveis de serem instalados são:

  • Default
  • AppPortalCliente
  • AppRHUnificado
  • AppProcessoSeletivo
  • AppEducacional
  • AppGestaoEducacional
  • AppPortalDaObra
  • AppPortalFarmacia
  • AppPortalDoFornecedor
  • AppPortalDoProfessor
  • AppPortalPep
  • AppPortalPvi

Importante: Para que os portais funcionem, é necessária a instalação do componente Default, que contem arquivos comuns e obrigatórios para cada um dos portais.



(ideia) Observação: o caminho do instalador deve obrigatoriamente ser adicionado entre aspas. Veja abaixo alguns exemplos válidos:

  •  C:\>"BibliotecaRM - 12.1.17.1.msi" 
  •  C:\>"BibliotecaRM - 12.1.17.1.exe" 

Parâmetros:


(informação) Quando usado configtotvsupdate=true, é obrigatório o uso dos parâmetros servertotvsupdate e portatotvsupdate para que ocorra a configuração automática.

(ideia) Observação: Disponível a partir da versão 12.1.24.

TOTVS Update
ParâmetroOpçãoExplicação
configtotvsupdateTrueIrá configurar o TOTVS Update automático.
servertotvsupdateServidor1Servidor para atualização.
portatotvsupdate12124Numero de porta de acesso ao servidor informado


(informação) Exemplo MSI
: C\BibliotecaRM.msi /passive /qb configtotvsupdate=true servertotvsupdate=Servidor1 portatotvsupdate=12124

A partir da 12.1.34

ORACLE

Parâmetro


OpçãoExplicação
useOracleRacTrueHabilita o uso do Oracle Rac

(informação) Exemplo MSIC\BibliotecaRM.msi /passive /qb layer=Local db=ORACLE dbserver=Servidor1/Instancia insthostcleanner=true dbuser=usuario1 dbpassword=senha1 useOracleRac=True

(informação) Quando usado insthostcleanner=true, é obrigatório o uso dos parâmetros db, dbserver, dbuser, dbpassword e quando SGBD for SQL dbname, caso seja ORACLE não é necessário dbname.

(ideia) Observação: Disponível a partir da versão 12.1.23.

SQL
ParâmetroOpçãoExplicação
insthostcleannerTrueIrá instalar o Host Cleanner automático.
dbSQLSistema Gerenciador de Banco de dados utilizado.
dbserverServidor1Hostname ou IP do servidor que está instalado o SGDB. 
dbnameCorporeRMNome da instância utilizada no SGDB. 
dbuserusario1Usuário que será usado para fazer login no SGDB.
dbpasswordsenha1Senha que será usado para fazer login no SGDB.
AliasName 
CorporeRMNome que será atribuído ao Alias.
  • O parâmetro AliasName, quando informado, será usado também para definir o DefaultDB no arquivo de configuração do RM.Host.


(informação) Exemplo MSI
: C\BibliotecaRM.msi /passive /qb layer=Local db=SQL dbserver=Servidor1 dbname=CorporeRM insthostcleanner=true dbuser=usuario1 dbpassword=senha1


ORACLE
ParâmetroOpçãoExplicação
insthostcleannerTrueIrá instalar o Host Cleanner automático.
dbSQLSistema Gerenciador de Banco de dados utilizado.
dbserverServidor1Hostname ou IP do servidor que está instalado o SGDB. 
dbuserusario1Usuário que será usado para fazer login no SGDB.
dbpasswordsenha1Senha que será usado para fazer login no SGDB.


(informação) Exemplo MSI
C\BibliotecaRM.msi /passive /qb layer=Local db=ORACLE dbserver=Servidor1/Instancia insthostcleanner=true dbuser=usuario1 dbpassword=senha1 useOracleRac=True

Para passar os parâmetros de Linguagem. use a expressão LANG

(ideia) Observação: Informar conforme nomenclatura descrita em: http://msdn.microsoft.com/en-US/library/ee825488(v=cs.20).aspx ( Válido somente para a Instalação .msi)

A Instalação .exe aceita somente pt, es e en

(informação) Exemplo MSI: C\BibliotecaRM.msi /passive /qb layer=Local db=SQL dbserver=Servidor1 dbname=CorporeRM lang=pt-BR

Para passar os parâmetros de quantidade de hosts, use a expressão:

Quantidade de Hosts

QTDhost

Exemplo: C\BibliotecaRM.msi /passive /qb layer=local hostserver=Servidor1 hostport=8050 ApiPort=9090 HttpPort=9091 lang=pt-BR QTDhost=3

ApiPort:

ApiPort

HttpPort:

HttpPort

Exemplo: C\BibliotecaRM.msi /passive /qb layer=local hostserver=Servidor1 hostport=8050 ApiPort=9090 HttpPort=9091 lang=pt-BR QTDhost=3

(ideia) Observação: Quando a quantidade de Hosts for maior que a recomendada , a instalação irá respeitar a quantidade recomendada.



Habilitar segurança nos portais (WebConfigs):


APLICASEGURANCAWEBCONFIG

Exemplo:   

No msi:

       "C:\TOTVS RM Portal.msi" /quiet /qn layerSide=Local APLICASEGURANCAWEBCONFIG=TRUE (para habilitar)

        ou

       "C:\TOTVS RM Portal.msi" /quiet /qn layerSide=Local APLICASEGURANCAWEBCONFIG=FALSE (para não habilitar)

No exe:

       "C:\TOTVS RM Portal.exe" /verySILENT /suppressmsgboxes /APLICASEGURANCAWEBCONFIG=TRUE (para habilitar)

        ou

       "C:\TOTVS RM Portal.exe" /verySILENT /suppressmsgboxes /APLICASEGURANCAWEBCONFIG=FALSE (para não habilitar)


Garbage Collector MultiThread (gcServer)

O Garbage Collector, quando operando em ambiente Server, proporciona desempenho otimizado para hosts que possuem múltiplos núcleos, uma vez que a infraestrutura do .Net framework cria uma thread de coleta para cada núcleo.

Esta tag será adicionada automaticamente com valor “true” nos arquivos de configuração do Host (Arquivos alterados RM.Host.exe.config, RM.Hostservice.exe.config e RM.Lib.Gerador.Execute.exe.config)

Exemplo: C\BibliotecaRM.msi .../gcServer="true"

(ideia) Observação: Por padrão, durante a instalação, a tag será adicionada como “false” no arquivo "RM.Host.JobRunner.exe.config" e deverá permanecer como “false”.



Desinstalação

Parâmetro
Opção
Explicação
dellalYes | NoApaga todos os arquivos contido na pasta do RM.

(informação) Exemplo MSI: msiexec /x "C:\BibliotecaRM.msi" /passive /qb delall=Yes

/x, /passive, /qb são parâmetros nativos do MSI.

(informação) Os parâmetros de desinstalação RM serão utilizados somente nos instaladores MSI.