1. Requisitos de sistema para a instalação do .NET Framework 3.0
2. .NET Framework 3.0: Problemas de instalação conhecidos
3. Etapas para a resolução de problemas de erros de download
4. Problemas conhecidos do Windows Communication Foundation
5. Problemas conhecidos do Windows Workflow Foundation 6. Problemas conhecidos do Windows Presentation Foundation
| Processador | Mínimo:
Recomendado:
|
| Sistema operacional | O .NET Framework 3.0 pode ser instalado em qualquer um dos seguintes sistemas:
* O Windows Vista já vem com o .NET Framework 3.0. Não há a necessidade de pacote de instalação separado. O Vista não oferece suporte aos pacotes do .NET Framework 3.0 autônomos. |
| RAM | Mínimo:
Recomendado:
|
| Disco Rígido | Até 500 MB de espaço disponível pode ser necessário. |
| Drive de CD ou DVD | Desnecessário. |
| Resolução | Mínima:
Recomendado:
|
| Mouse | Desnecessário. |
Ao iniciar o instalador do .NET Framework 3.0, o local de instalação padrão é o drive do sistema, que é o drive que inicializa o sistema. Certifique-se de que o espaço necessário (de até 500 MB) esteja disponível no drive do sistema.
Seqüência de falhas de download e instalação do .NET Framework 3.0.
Para resolver esse problema
Execute o dotnetfx3setup.exe a partir do site e tente fazer o download novamente. Clique aqui para mais informações sobre resolução de problemas de erros de download.
– ou –
Instale o pacote redistribuível completo dotnetfx3.exe (x86) ou dotnetfx3_x64.exe (x64). Esses pacotes são encontrados no mesmo local de download do .NET Framework 3.0.
Caso a instalação necessite ser reinicializada, e o antivírus estiver definido para limpar o diretório temporário ao iniciar, os arquivos de instalação necessários serão excluídos e a instalação apresentará erro de programa não encontrado.
Para resolver esse problema
Antes de executar a instalação do .NET Framework 3.0, altere as configurações do antivírus para que ele não limpe a pasta temporária ao iniciar ou reiniciar. Para realizar essa etapa, consulte o manual do antivírus.
Caso outros aplicativos estejam sendo executados ao mesmo tempo que você inicia o Modo de Manutenção, como programas de verificação de vírus, isso pode fazer com que a instalação fique consideravelmente lenta dando a impressão de que houve falha.
Para resolver esse problema
Aguardar. É a melhor opção. Não houve falha na instalação.
Ao instalar o .NET Framework 3.0, a mensagem de erro “Desinstalar o Windows Workflow Foundation” pode aparecer, mas não há a opção ARP do Windows Workflow Foundation para desinstalá-lo.
Para resolver esse problema
Execute a ferramenta de desinstalação em: http://www.microsoft.com/downloads/details.aspx?FamilyId=AAE7FC63-D405-4E13-909F-E85AA9E66146
Caso tenha uma versão local do MSXML6 já instalada no Windows XP SP2 e Windows 2003 SP1, a instalação do .NET Framework 3.0 irá sobrescrevê-la pela versão em inglês.
Para resolver esse problema
Reinstale a versão local do MSXML6 após ter instalado o .NET Framework 3.0.
O Windows Vista já vem com o .NET Framework 3.0. Não há a necessidade de pacote de instalação separado. O Vista não oferece suporte aos pacotes do .NET Framework 3.0 autônomos.
Esta seção descreve possíveis problemas encontrados caso uma versão de pré-lançamento do .NET Framework 3.0 (CTP e Beta) tenha sido anteriormente instalada e como removê-la para atualizar para a versão RTM.
Execute a ferramenta de desinstalação
A ferramenta de desinstalação do .NET Framework 3.0 atual está disponível em http://www.microsoft.com/downloads/details.aspx?FamilyId=AAE7FC63-D405-4E13-909F-E85AA9E66146. Essa ferramenta soluciona muitos problemas de desinstalação e é o primeiro e melhor passo para tentar resolver os problemas de desinstalação/reinstalação. Os detalhes sobre o uso correto da ferramenta podem ser encontrados na página de download.
Caso não consiga executar a ferramenta ou ela não resolva o problema, examine a seção Problemas Conhecidos e Soluções a seguir, para encontrar possíveis soluções.
Observação: Esses problemas de instalação ocorrem apenas quando uma versão de pré-lançamento do .NET Framework 3.0 foi instalada antes da versão RTM. Esses tipos de problemas foram encontrados em edições de pré-lançamento recentes do .NET Framework 3.0.
Problemas conhecidos e soluções
2.7.1 O “Microsoft Digital Identity Service” (idsvc) não é excluído durante a desinstalação
Na desinstalação, algumas versões de pré-lançamento do .NET Framework 3.0 não excluíram corretamente todos os serviços criados por elas. A presença de um desses serviços em um sistema bloqueia a instalação do .NET Framework 3.0. Ocorrerá falha na instalação com este erro:
ERRO_DE_FALHA_NA_INSTALAÇÃO 1603 Erro fatal durante a instalação
Um desses arquivos de log %temp%\dd_wcf_retCA*.txt também serão mostrados:
ServiceModelReg [15:48:08:041]: Instalando: Microsoft Digital Identity Service (idsvc)
ServiceModelReg [15:48:08:073]: Erro: System.ComponentModel.Win32Exception: O nome já está em uso como nome de serviço ou nome de exibição de serviço
Para resolver esse problema
Execute a ferramenta de desinstalação em: http://www.microsoft.com/downloads/details.aspx?FamilyId=AAE7FC63-D405-4E13-909F-E85AA9E66146
Caso o problema persista:
abra um prompt de comando.
2.7.2 Algumas chaves de registro de contador de desempenho WCF não são excluídas na desinstalação de algumas versões do .NET Framework 3.0
Algumas versões de pré-lançamento do .NET Framework 3.0 não removeram todas as chaves de registro de contador de desempenho na desinstalação. A presença dessas chaves bloqueia a instalação do .NET Framework 3.0. Ocorrerá falha na instalação com este erro:
“ERRO_DE_FALHA_NA_INSTALAÇÃO 1603 Erro fatal durante a instalação”
As seguintes chaves ainda podem estar presentes no registro após a desinstalação:
• HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSDTC Bridge 3.0.0.0\Performance
• HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ServiceModelEndpoint 3.0.0.0\Performance
• HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ServiceModelOperation 3.0.0.0\Performance
• HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ServiceModelService 3.0.0.0\Performance
• HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SMSvcHost 3.0.0.0\Performance
Para resolver esse problema
Execute a ferramenta de desinstalação em: http://www.microsoft.com/downloads/details.aspx?FamilyId=AAE7FC63-D405-4E13-909F-E85AA9E66146
Se o erro persistir:
1. Tente reiniciar. Muitos problemas podem desestabilizar os contadores de desempenho. A reinicialização pode consertar alguns desses problemas e é mais segura que editar manualmente o registro.
2. Caso isso não resolva o problema:
a. Verifique os seguintes registros. Exclua as chaves de registro pai de todos os registros seguintes que estejam vazios ou cujos valores contenham “Wbem*”:
• HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSDTC Bridge 3.0.0.0\Performance
• HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ServiceModelEndpoint 3.0.0.0\Performance
• HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ServiceModelOperation 3.0.0.0\Performance
• HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ServiceModelService 3.0.0.0\Performance
• HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SMSvcHost 3.0.0.0\Performance HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ServiceModelEndpoint 3.0.0.0\Performance
você deve excluir:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ServiceModelEndpoint 3.0.0.0”
2.7.3 Entradas machine.config obsoletas que consultam versões “2.0.0.0” de conjuntos do .NET Framework 3.0 bloqueiam a instalação
Algumas versões de pré-lançamento do .NET Framework 3.0 não removeram todas as entradas machine.config na desinstalação. Quaisquer entradas que consultem a versão 2.0.0.0 do “System.ServiceModel.dll” no arquivo machine.config bloqueiam a instalação do .NET Framework 3.0. Ocorrerá falha na instalação com este erro:
“ERRO DE_FALHA_NA_INSTALAÇÃO 1603 Erro fatal durante a instalação”
Além de:
1. Um evento de erro aparece no log de evento do aplicativo que faz referência a problemas ao executar o ServiceModelReg.exe.
2. O arquivo de log de instalação chamado “dd_wcf_retCA*” no local do diretório %temp% do usuário contém uma entrada que indica o ServiceModelReg.exe. de execução de problemas
3. Tanto a entrada de log de evento como a entrada de log de instalação devem ter uma exceção similar ao seguinte (o carimbo de hora irá variar):
ServiceModelReg [16:21:10:656]: Erro: System.IO.FileLoadException: Não e possível carregar o arquivo ou o conjunto 'System.ServiceModel, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089' ou uma de suas dependências. A localização da definição de manifesto de conjunto não coincide com a referência de conjunto. (Exceção a partir do HRESULT: 0x80131040)
Para resolver esse problema
Remova as entradas machine.config obsoletas, manualmente:
1. A partir de uma janela, execute “notepad %windir%\microsoft.net\framework\v2.0.50727\config\machine.config”
2. Remova quaisquer nós XML e nós filhos que consultem o System.ServiceModel.dll.
3. Caso esteja executando em uma máquina de 64 bits e exista o seguinte arquivo de configuração:
“%windir%\Microsoft.NET\Framework64\v2.0.50727\config\machine.config”
edite o arquivo para remover quaisquer nós xml e nós filhos que consultem o System.ServiceModel.dll.
2.7.4 Talvez não seja possível hospedar na internet o WCF Services se uma versão anterior do Pre-RC1 tiver sido instalada anteriormente
Caso você tenha instalado uma versão anterior do .NET Framework 3.0 quando o IIS foi instalado, ao tentar fazer a atualização para a versão RTM do.NET Framework 3.0 você poderá encontrar dificuldades em acessar o serviços do WCF que estiverem no host IIS usando arquivos .svc Em computadores que operem com o Windows Server 2003, acessar uma extensão .svc a partir do navegador pode retornar um erro “404: página não encontrada”. Em computadores que operem com o Windows XP, o conteúdo .svc pode ser exibido como um texto plano.
Isso ocorre devido a um problema com os registros de mapeamento de script do WCF da versão anterior.
Para resolver esse problema
Há três maneiras de resolver esse problema:
1. Faça download da ferramenta sem suporte, CleanIISScriptMaps.exe do http://wcf.netfx3.com/files/folders/product_team/entry5648.aspx. Execute a ferramenta a partir de um console de comando sem nenhum argumento.
2. Desinstale e reinstale o IIS ou recrie os Web sites:
a. Desinstale o IIS e reinstale-o para que o IIS Metabase seja atualizado. Em seguida, execute a ferramenta de instalação WCF manualmente para registrar novamente os scripmaps do WCF:
“%windir%\Microsoft.NET\Framework\v3.0\Windows Communication Foundation\ServiceModelReg.exe” /r /y
b. Caso esteja executando o Windows 2003 Server, você pode resolver o problema excluindo e recriando o “Default Web Site”.
3. Instale o .svc manualmente como uma solução temporária:
a. Você pode executar o seguinte comando para instalar o mapeamento .svc manualmente. No entanto, isso atualiza o IIS Metabase dos sites existentes.
"%windir%\Microsoft.NET\Framework\v3.0\Windows Communication Foundation\ServiceModelReg.exe" /s:W3SVC
2.7.5 O corrompimento do IIS Metabase bloqueia a instalação do .NET Framework 3.0
Caso tenha instalado uma versão anterior do .NET Framework 3.0 enquanto o IIS estava sendo instalado, é possível que o IIS metabase tenha sido corrompido. Isso pode bloquear a instalação do .NET Framework 3.0.
É possível identificar esse problema das seguintes formas:
1. Ocorrerá falha na instalação com este erro:
“ERRO_DE_FALHA_NA_INSTALAÇÃO 1603 Erro fatal durante instalação”
2. Um evento de erro é mostrado no log de evento do aplicativo relacionado a falha ao registrar os scripmaps WCF. A origem do evento é System.ServiceModel.Install.dll 3.0.0.0.
3. Os logs de instalação do diretório %temp% também conterão informações de falhas ao registrar os scriptmaps WCF.
4. Tanto o log de evento como o log de instalação podem conter os seguintes rastreamentos de pilha de exceção:
System.ApplicationException: O ServiceModelReg.exe detectou um possível corrompimento no IIS metabase que impede o registro dos scriptmaps do ServiceModel IIS. Corrija o corrompimento do IIS metabase, ou, caso não queira o recurso do ServiceModel WebHost, desabilite o serviço do IISAdmin e registre novamente o ServiceModel.
Para resolver esse problema
1. Desinstale o IIS.
2. Reinstale o IIS.
3. Execute a instalação do .NET Framework 3.0.
Esse erro ocorre quando o serviço BITS está desabilitado, não existe, foi excluído dos aplicativos de serviços, foi interrompido enquanto o download estava em progresso ou se algum serviço cujo BITS depende falhou ou foi excluído. A mensagem de erro para esse problema é "O serviço BITS deve ser habilitado antes que a instalação seja iniciada. Habilite o serviço BITS e execute a instalação novamente."
Para resolver esse problema
services.msc e em seguida clique em OK.Observação: Caso não visualize Serviço de Transferência Inteligente de Segundo Plano na lista, o serviço não está instalado no computador. Você pode fazer o download e instalar o BITS em http://www.microsoft.com/downloads/details.aspx?FamilyId=B93356B1-BA43-480F-983D-EB19368F9047&displaylang=en.
Caso essas etapas não resolvam o problema, é necessário habilitar os serviços da qual a BITS depende.
Para habilitar as dependências
Esses erros ocorrem quando as interfaces BITS não forem registradas ou quando as configurações de registro forem corrompidas.
Para resolver esse problema
Faça a atualização da BITS em http://www.microsoft.com/downloads/details.aspx?FamilyId=B93356B1-BA43-480F-983D-EB19368F9047&displaylang=en.
– ou –
Efetue o reparo do serviço BITS executando a ferramenta bitsadmin do prompt de comando:
Bitsadmin /util /repairservice /force
É possível fazer o download da ferramena Bitsadmin em http://www.microsoft.com/downloads/details.aspx?amp;displaylang=en&familyid=49AE8576-9BB9-4126-9761-BA8011FABF38&displaylang=en.
Esse tipo de erro pode ocorrer por uma ou mais das seguintes razões:
Para resolver esse problema
Forneça as configurações corretas do servidor proxy e certifique-se de que sua máquina esteja habilitada para resolver o servidor proxy.
– ou –
Faça a atualização para o BITS 2.0. É possível fazer o download do BITS 2.0 em
http://www.microsoft.com/downloads/details.aspx?amp;displaylang=en&familyid=49AE8576-9BB9-4126-9761-BA8011FABF38&displaylang=en.
Observação Para resolver esses erros, saia da instalação, verifique se está conectado à rede, e reinicie a instalação.
Esse tipo de erro ocorre quando o serviço BITS falha ao criar ou gravar um arquivo. Um outro programa, como o chkdsk.exe, pode estar sendo executado, bloqueando o disco e evitando que o BITS grave no arquivo.
Para resolver esse problema
Certifique-se de que um outro programa (por exemplo, chkdsk.exe) que poderia estar bloqueando o disco, não esteja sendo executado e reinicie o download.
– ou –
Reinicie seu computador e, em seguida, reinicie a instalação. Certifique-se de estar conectado à Internet.
Houve falha do serviço BITS devido a um dos possíveis erros de proxy relacionados abaixo:
Para resolver esse problema
Forneça as credenciais corretas de autenticação do servidor proxy e reinicie a instalação.
– ou –
Faça a atualização do servidor proxy para que ele ofereça suporte ao HTTP 1.1 e certifique-se de que o proxy ofereça suporte a credenciais implícitas (como NTLM). Talvez seja necessário contatar o seu administrador de rede.
– ou –
Ignore o proxy alterando as configurações de proxy do Internet Explorer.
Para ignorar um servidor proxy:
Caso necessite de assistência futura com as configurações de servidor proxy, contate o administrador de rede.
O serviço BITS não é executado em:
Para resolver esse problema
Não há solução. Não há suporte para essas situações.
4.10 Exceção ao executar um serviço TCP e TCP MEX na mesma porta
Quando o compartilhamento de porta está habilitado, configurar um serviço TCP e um ponto de extremidade para usar a mesma porta faz com que ocorra uma exceção em AddressAlreadyInUse ao iniciar o serviço.
Há duas maneiras de resolver esse problema:
1. Altere a configuração do serviço TCP e dos pontos de extremidade TCP MEX para usar portas diferentes.
2. Habilite o compartilhamento de porta do TcpTransportBindingElement do ponto de extremidade TCP MEX. O código seguinte ilustra esse processo:
ServiceMetadataBehavior mexBehavior = new ServiceMetadataBehavior();
host.Description.Behaviors.Add(mexBehavior);
Binding mexBinding = MetadataExchangeBindings.CreateMexTcpBinding();
CustomBinding mexBinding2 = new CustomBinding(mexBinding);
mexBinding2.Elements.Find<TcpTransportBindingElement>().PortSharingEnabled = true;
host.AddServiceEndpoint(typeof(IMetadataExchange), mexBinding2, mexAddress);
4.11 Mensagens de falhas > 64 KB pode causar um ProtocolException (exceção de protocolo)
quando o MaxBufferSize for ao menos Int.MaxValue – 1024 bytes (2147482623 bytes), enviar uma mensagem de falha maior que 64 KB faz com que o cliente receba um ProtocolException ao invés de um FaultException (exceção de falha). Para transferências em buffer, o MaxBufferSize é o mesmo que MaxReceivedMessageSize. Isso só afeta os serviços se for usado um transporte HTTP(S).
Para resolver esse problema, defina o MaxBufferSize (MaxReceivedMessageSize) para Int.MaxValue – 1025 bytes (2147482622 bytes) ou menor. Também é possível definir diretamente o HttpWebRequest.DefaultMaximumErrorResponseLength para o limite desejado. Definir o DefaultMaximumErrorResponseLength afetará todos os canais do mesmo domínio de aplicativo.
4.12 Não é possível usar o EncryptBeforeSign e o XmlSerializerFormatAttribute no mesmo contrato
A mensagem de segurança com a proteção EncryptBeforeSign não funciona de forma apropriada se o XmlSerializerFormatAttribute for usado no contrato. Se ambos forem usados, o WCF cria mensagens com conteúdo de corpo inválido após a decodificação —uma instrução de processamento <?xml ..> adicional é gerada antes do primeiro elemento de corpo.
Para evitar este problema, não use o EncryptBeforeSign com o XmlSerializerFormatAttribute no mesmo contrato.
4.13 Não é possível hospedar WS-ReliableMessaging Channels usando diferentes versões de WS-Adressing
Um AppDomain (domínio de aplicativo) não pode hospedar canais WS-ReliableMessaging que usam diferentes versões de WS-Addressing. Nesses casos o primeiro canal ativo ditará a versão dos cabeçalhos do WS-Addressing Action de todas as mensagens de protocolo subseqüentes, mesmo que essas mensagens tenham sido enviadas por um canal configurado para usar versões diferentes de protocolo de endereçamento.
Caso você precise de um aplicativo ou serviço único para criar canais do WS-ReliableMessaging que usem diferentes versões do WS-Addressing, use um AppDomain separado para cada um deles. Quando um serviço WCF está hospedado na Web, será necessário usar dois diretórios virtuais — um que hospede os serviços com pontos de extremidade WS-Addressing 1.0 e um com pontos de extremidade WS-Addressing versão agosto de 2004.
<system.webServer>
<módulos>
<add name="WorkflowHost" type="System.Workflow.Runtime.Hosting.WorkflowWebHostingModule, System.Workflow.Runtime, Version=3.0.00000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" preCondition="runtimeVersionv2.0" />
</módulos>
<system.webServer> |
Não e possível adicionar o serviço ExternalDataExchangeService às múltiplas instâncias WorkflowRuntime. A todo momento uma nova instância WorkflowRuntime é criada, um novo serviço ExternalDataExchangeService deve ser criado e quaisquer serviços de comunicação locais devem ser adicionados ao serviço ExternalDataExchangeService novamente.
Se você criar uma atividade de composição personalizada contendo uma atividade filho que implemente o ICompensatable e uma atividade CompesateActivity que compense a atividade de composição, mas não a atividade filho explicitamente, então haverá falha de compensação com exceções caso a atividade personalizada esteja localizada no fluxo de trabalho.
Para evitar esse problema, você deve encapsular todas as atividades filho da atividade personalizada em uma atividade CompensatableSequenceActivity e implementar a compensação na atividade CompensatableSequenceActivity.
Caso a solução tenha vários projetos, então os diretórios de projeto necessitam ser assemelhados a outros. Caso você tenha alterado a estrutura do projeto como um projeto que tenha sua raiz em um outro diretório de projeto, é provável que você se depare com erros de compilação de marcação inesperados durante a recriação relatando que um tipo em uma DLL (de um dos projetos dependentes) não pôde ser encontrado.
Soluções: