Uso do Adobe Exceptions Deployer

NOTA: este documento foi substituído desde o lançamento da versão 1.9.3 da Creative Cloud Packager. Consulteeste documento para obter instruções de instalação para os pacotes criados desde esta versão da ferramenta do packager.

O aplicativo Adobe^® Exceptions Deployer fornece uma forma automática de implantar pacotes na pasta Exceptions, isto é, os pacotes que, de outra maneira, você implantaria separadamente antes e/ou depois de implantar o arquivo principal MSI ou PKG.

O aplicativo Exceptions Deployer pode ser usado para implantar apenas as cargas geradas pela Adobe^® Creative Cloud™ Packager na pasta Exceptions. As cargas não geradas pela Creative Cloud Packager (por exemplo, baixadas da Web) não podem ser implantadas usando o aplicativo Exceptions Deployer.

O aplicativo Exceptions Deployer é copiado para a pasta Exceptions quando você cria um pacote usando a Creative Cloud Packager.

Neste artigo:

• Informações relevantes sobre os pacotes de instalação
• Uso do aplicativo Exceptions Deployer para implantar as cargas de exceção

Ao criar um pacote, a Creative Cloud Packager apresenta uma lista de aplicativos e atualizações que podem ser instalados para que você faça suas opções. Todas essas opções são gravadas no pacote.

Quando você cria um pacote para implantação corporativa com a Creative Cloud Packager, duas pastas são criadas:

• A pasta Build contém o arquivo MSI (Windows) ou PKG (Mac OS) para implantação usando ferramentas de implantação corporativas, como Microsoft SCCM, Apple ARD ou JAMF Casper Suite.
• A pasta Exceptions contém as cargas que devem ser instaladas separadamente.
  

Pacotes na pasta Exceptions

No Windows

No Windows, a pasta Exceptions inclui todos os pacotes que devem ser instalados separadamente.

No Windows, o Acrobat era incluído na pasta Exceptions, mas para os pacotes criados na versão 1.9.3 ou superior da Creative Cloud Packager, o Acrobat será incluído na pasta Build e será instalado junto com outros aplicativos no pacote de instalação principal.

No Mac OS

No Mac OS, se você selecionar a opção DESATIVAR COMPONENTES DO AIR NO PACOTE na tela Configurar pacote, os componentes baseados no AIR não serão instalados com o pacote regular. Eles são copiados para a pasta Exceptions, de onde você os instalará. As instruções sobre a instalação são fornecidas nas próximas seções.

No Mac OS, se você não selecionar a opção DESATIVAR COMPONENTES DO AIR NO PACOTE na tela Configurar pacote, nenhum componente será copiado na pasta Exceptions.

Sequência de instalação dos pacotes na pasta Exceptions

Com exceção do Acrobat XI para Windows (em pacotes antigos), todos os pacotes na pasta Exceptions devem ser implantados depois que você tiver implantado o pacote principal MSI ou PKG. O Acrobat XI for Windows deve ser implantado antes da implantação do pacote principal.

Portanto, se você estiver usando o aplicativo Exceptions Deployer para implantar o Acrobat XI no Windows, deverá executar o aplicativo Exceptions Deployer antes da implantação do pacote MSI principal (no modo pré). Para todos os outros pacotes, você executa o aplicativo Exceptions Deployer depois da implantação dos pacotes principais (no modo pós). Se a pasta Exceptions contiver o Acrobat para Windows e outros pacotes, você executará o aplicativo Exceptions Deployer duas vezes: uma vez antes da implantação do pacote MSI principal (isso implantará o Acrobat para Windows) e outra depois da implantação do pacote MSI principal (isso implantará outros pacotes).

Para a Acrobat, o aplicativo Exception Deployer não é necessário. Para o Acrobat, você só precisa executar o setup.exe na pasta Build que o Acrobat, o tipo escolhido de licença e quaisquer outros aplicativos principais não encontrados no diretório Exceptions serão instalados.

Se ainda houver aplicativos na pasta Exceptions, você deve executar o ExceptionDeployer com a opção pós-instalação para instalá-los. Esse aplicativos incluem o Adobe Scout, o Gaming SDK e o Adobe Help.

Para obter instruções sobre como instalar o Acrobat manualmente, consulte Implantação do Adobe Acrobat.

Script de implantação da CCP

No Windows, você pode usar o seguinte script para implantar a Creative Cloud Packager. O script em anexo é um exemplo e você pode usá-lo após editar os detalhes abaixo de acordo com o pacote a ser implantado:

• Idioma: @cd /d "%~dp0"
• Nomes dos arquivos MSI e de log: start /wait msiexec /i "<msi_file_name>.msi" /qn /lv* "<log_file_name>.log"

Uso do aplicativo Exceptions Deployer para implantar as cargas de exceção

Nesta seção:

• Pacote zip do aplicativo Exceptions Deployer
• Requisitos para executar o aplicativo Exceptions Deployer
• Sintaxe e descrição do aplicativo Exceptions Deployer
  
• Exemplos
  
• Retorno de valores
  
• Uso da página principal do aplicativo Exceptions Deployer no macOS
• Arquivo de log do aplicativo Exceptions Deployer
  

Pacote zip do aplicativo Exceptions Deployer

O pacote zip contém dois arquivos:

• Arquivo ExceptionDeployer, que é o executável do aplicativo Exceptions Deployer
• Arquivo ExceptionConfig, que contém informações relacionadas à configuração para cargas de exceção.
  

O aplicativo Exceptions Deployer deve ser executado diretamente da pasta Exceptions. Ele é copiado para a pasta Exceptions quando você cria um pacote usando a Creative Cloud Packager.

Requisitos para executar o aplicativo Exceptions Deployer

• O aplicativo Exceptions Deployer deve ser iniciado com as credenciais de administrador.
• Pode haver apenas uma instância do aplicativo Exceptions Deployer em execução em uma máquina.
  

Sintaxe e descrição do aplicativo Exceptions Deployer

Execute o aplicativo Exceptions Deployer da pasta Exceptions com a sintaxe a seguir. Os parâmetros em negrito são obrigatórios.

Exemplos

• O comando a seguir é usado para implantar o Acrobat for Windows. (Você se recordará que o Acrobat for Windows deve ser implantado antes da implantação do pacote principal.) A opção --mode=pre especifica que o aplicativo Exceptions Deployer é executando antes da implantação do pacote principal. O installLanguage é especificado como en_US (Inglês dos EUA). Essa opção também é obrigatória durante a implantação do Acrobat for Windows.

ExceptionDeployer --workflow=install --mode=pre --installLanguage=en_US

• O seguinte comando é usado para implantar todos os pacotes na pasta Exceptions (exceto o pacote Acrobat for Windows se estiver presente). A opção --mode=post especifica que o aplicativo Exceptions Deployer é executado depois da implantação do pacote principal. Observe que a opção --installLanguage não é exigida aqui. Além disso, como a opção --INSTALLDIR não foi especificada, a carga de exceção é implantada no local padrão especificado na carga.
  
  

ExceptionDeployer --workflow=install --mode=post

• O seguinte comando especifica que os pacotes na pasta Exceptions devem ser implantados no diretório \test na máquina cliente. Supõe-se que você implantou anteriormente o pacote principal no local \test na máquina cliente

ExceptionDeployer --workflow=install --mode=post --INSTALLDIR=\test

• O seguinte comando especifica que os pacotes devem ser instalados no local \test na máquina cliente. Como a opção abortOnFail é definida como true, se um dos pacotes não puder ser implantado, o aplicativo Exceptions Deployer será encerrado em vez de continuar com a implantação do próximo pacote.

ExceptionDeployer --workflow=install --mode=post --INSTALLDIR=\test --abortOnFail=true

Retorno de valores

Depois da execução, o aplicativo Exceptions Deployer retorna um dos seguintes valores:

As informações detalhadas estão disponíveis no arquivo de log do aplicativo Exceptions Deployer, explicado na próxima seção.

Uso da página principal do aplicativo Exceptions Deployer no Mac OS

No Mac OS, você pode usar a página principal do Adobe Exceptions Deployer para obter informações sobre a sintaxe e o uso da linha de comando. Use as seguintes etapas para configurar a página principal:

1. Monte o arquivo dmg do aplicativo Exceptions Deployer.
   
2. Abra um terminal de comando.
   
3. Altere o diretório para o arquivo dmg montado.
   
4. Execute o seguinte comando:
   sudo sh Install_XDAManPage.sh
   

Isso configura a página principal do aplicativo Exceptions Deployer. Agora você pode obter as informações de uso e sintaxe executando o comando man ExceptionDeployer.

Arquivo de log do aplicativo Exceptions Deployer

O arquivo de log do aplicativo Exceptions Deployer fornece informações detalhadas sobre os eventos que ocorrem durante a implantação de cargas de exceção.

O arquivo de log é chamado ExceptionDeployer.log. Esse arquivo está localizado como se segue:

• No Windows, o arquivo de log está em %temp%.
• No macOS, o arquivo de log está na pasta ~/Library/Logs/.
  

Estes são trechos de conteúdo dos arquivos de log de amostra:

ExceptionDeployer.log no Windows: antes da implantação do arquivo MSI principal

ExceptionDeployer.log no macOS: depois da implantação do arquivo PKG principal