Definir os canais

Um canal é um pacote de aplicativos de software com versões específicas. Seu rótulo (por exemplo, Beta ou Versão) indica o status de estabilidade e qualidade dos aplicativos do pacote. Ao definir diversos canais, você pode implantar diferentes produtos com versões adequadas para diferentes grupos de usuários. Quando o iManage Updater é executado, ele identifica qual canal está atribuído ao usuário atual, com base nisso, determina os produtos e versões que devem estar instalados para o canal correspondente.

Os canais são definidos no arquivo update.ini, localizado em %ProgramData%\iManage\AgentServices\CentralizedConfigs . Um arquivo update.ini de exemplo é semelhante a isto:

[General] server=updates.imanage.com/Updates/Work1021 default=beta [beta] AgentSvc=https://updates.imanage.com/Updates/Software/;iManageAgentServices-102061.exe;102.0.61;{67E81972-CA2E-4A7A-AD32-CC95A33B1592};{AD517F43-5642-4356-B5BE-8EC6920EFBFD};rollback;wixexe;/passive; iManage Work Desktop for Windows x86=https://updates.imanage.com/Updates/Software/beta/;iManage Work Desktop for Windows x86.exe;102.0.150;{E97D2B88-6E81-45B1-8796-4C49C71ECEFA};{5DEB3BDC-4167-4EA0-A8E3-2366510ECE9B};norollback;wixexe;/passive;x86 iManage Work Desktop for Windows x64=https://updates.imanage.com/Updates/Software/beta/;iManage Work Desktop for Windows x64.exe;102.0.150;{B106FE6E-5160-401E-BCC7-8840DCD25E56};{98D55B81-8867-4E13-99C7-99157609C0F7};norollback;wixexe;/passive;x64 [release] AgentSvc=https://updates.imanage.com/Updates/Software/;iManageAgentServices-102061.exe;102.0.61;{67E81972-CA2E-4A7A-AD32-CC95A33B1592};{AD517F43-5642-4356-B5BE-8EC6920EFBFD};rollback;wixexe;/passive; iManage Work Desktop for Windows x86=https://updates.imanage.com/Updates/Software/beta/;iManage Work Desktop for Windows x86.exe;102.0.150;{E97D2B88-6E81-45B1-8796-4C49C71ECEFA};{5DEB3BDC-4167-4EA0-A8E3-2366510ECE9B};norollback;wixexe;/passive;x86 iManage Work Desktop for Windows x64=https://updates.imanage.com/Updates/Software/beta/;iManage Work Desktop for Windows x64.exe;102.0.150;{B106FE6E-5160-401E-BCC7-8840DCD25E56};{98D55B81-8867-4E13-99C7-99157609C0F7};norollback;wixexe;/passive;x64

A seção [Geral] inclui duas propriedades:

  • servidor: Indica o local do servidor de atualização. Por exemplo: updates.imanage.com/Updates/Work1021

  • padrão: Indica o canal padrão atribuído ao usuário.

As próximas seções são as definições para os canais, por exemplo, [beta] e [versão]. Você pode adicionar quantos canais desejar e nomeá-los de acordo com os requisitos da sua organização, por exemplo, [pré-versão], [versão] e assim por diante. Cada canal inclui uma lista de todos os produtos suportados. Isso oferece a capacidade de suportar diferentes versões de produtos com o mesmo arquivo de configurações. Você pode adicionar diversos produtos do iManage e de terceiros dentro de um canal. Cada linha de produto deve ser definida usando o seguinte formato:

<product ID>=<update server path>;<installer file name>;<version number>;<upgrade code>;<product code>;rollback|norollback;<installer parameters (optional)>;<Microsoft Office bitness (x64, x86, or blank)>

Exemplo:

iManage Work Desktop for Windows x64=https://updates.imanage.com/Updates/Software/beta/;iManage Work Desktop for Windows x64.exe;102.0.150;{B106FE6E-5160-401E-BCC7-8840DCD25E56};{98D55B81-8867-4E13-99C7-99157609C0F7};norollback;wixexe;/passive;x64

Tabela: Parâmetros de canal

Parâmetro

Descrição

ID do produto

Nome do produto a ser instalado.

Exemplo: iManage Work Desktop para Windows x64

Caminho do servidor de atualização

Local do servidor de atualização que é usado pelo recurso iManage Auto Updates para fazer download dos aplicativos mais recentes para a instalação inicial e sempre que esses aplicativos forem atualizados.

O caminho do servidor pode ser um caminho de arquivo (local ou estilo UNC) ou um servidor da Web HTTP/HTTPS.

Nome do arquivo do instalador

Nome do arquivo do instalador do produto.

Exemplo: iManage Work Desktop for Windows x64.exe

Número de versão

Número de versão do produto a ser instalado. Com essa propriedade, você pode controlar a instalação de diferentes versões do produto para diferentes canais. Por exemplo, você pode selecionar uma versão de produto para o canal [Beta] e uma versão diferente para o canal [Versão].

Código de atualização

Um identificador exclusivo (formato de registro GUID) que é válido para a vida útil do produto. Código de atualização é a propriedade de instalador do Windows contida dentro do banco de dados de instaladores do Windows (arquivo .msi) na tabela Propriedade. Você pode usar um freeware—por exemplo, Orca (disponível com Microsoft SDK)—para editar ou navegar em um arquivo MSI.

Código do produto

Um identificador exclusivo (formato de registro GUID) que é alterado para cada versão principal do produto, ou quando você desejar desinstalar versões anteriores antes de instalar a versão mais recente. Código de produto é a propriedade de instalador do Windows contida dentro do banco de dados de instaladores do Windows (arquivo .msi) na tabela Propriedade. Você pode usar um freeware—por exemplo, Orca (disponível com Microsoft SDK)—para editar ou navegar em um arquivo MSI.

rollback|norollback

O iManage Updater possui o recurso de reverter versões e produtos de software, quando necessário. As reversões permitem que uma empresa desfaça uma atualização. Por exemplo, se uma empresa atualizou alguns usuários da versão 144 para a 149 e, depois, decidiu — por algum motivo — que não queria mais a atualização, ela pode revertê-la, trazendo os usuários de volta à versão 144. Quando ocorre uma reversão, os usuários recebem o mesmo aviso de quando uma atualização está disponível. Quando a atualização é instalada, o software do usuário é revertido à versão específica, em vez de ser atualizado à versão mais recente.

Quando norollback é especificado, o iManage Updater permite que os usuários instalem qualquer versão do software que seja igual ou mais recente do que a versão do software especificada para seu canal correspondente.

Quando rollback é especificado, se o iManage Updater detectar que os usuários instalaram alguma versão que não for a especificada para esse canal, ele solicitará que os usuários instalem uma atualização, que faz o upgrade ou downgrade do software conforme necessário.

NOTA:

Quando um downgrade ou reversão ocorre, o iManage Updater realiza uma desinstalação e reinstalação completas desse pacote de software.

Parâmetros do instalador (opcional)

Argumentos para o instalador para alterar o comportamento de instalação padrão. Exemplo: TRANSFORMS=\\myserver\sharename\Work10\customizations\customwork10.mst

Microsoft Office bitness

Essa propriedade mapeia a quantidade de bits com o Microsoft Office bitness. O valor pode ser x64 ou x86. Se não houver dependência do Microsoft Office bitness, você pode deixar em branco.