Saiba mais sobre como implantar o novo portal do Self-Service e solucionar problemas de instalação

O novo Portal Self-Service é uma aplicação Web HTML5 baseada em ASP.NET MVC Razor. Durante a instalação, o aplicativo Web é configurado para se conectar diretamente ao Serviço SDK em execução no navegador do servidor Service Manager. Uma configuração básica e recém-configurada do Self-Service Portal funciona como mostrado no diagrama a seguir.

Os dados fluem entre diferentes componentes na sequência a seguir.

1. Os usuários inserem a URL do aplicativo Web em seu navegador para acessar o Portal Self-Service.

2. ASP.NET cria uma nova instância para o utilizador e tenta ligar-se ao Serviço SDK, fornecido durante a instalação, no contexto do utilizador.

3. O Serviço SDK lê e grava dados no banco de dados do Service Manager.

Prepare-se para a implantação

Analise a seção a seguir para ajudá-lo a se preparar para a implantação.

Observação

Não é recomendável instalar o Portal do Self-Service no mesmo servidor que o Servidor de Gerenciamento primário.

Requisitos de hardware

Servidores do Service Manager	Processador (min)	Processador (rec)	Memória RAM (mín)	RAM (rec)	Espaço no disco rígido (min)	Espaço no disco rígido (rec)
Self-Service Portal + Gestor de Serviços Secundário (Recomendado*)	CPU de 8 núcleos de 2,66 GHz	CPU de 8 núcleos de 2,66 GHz	16 GB	32 GB	80 GB	80 GB
Self-Service Portal (Independente)	CPU de 4 núcleos de 2,66 GHz	CPU de 8 núcleos de 2,66 GHz	8 GB	16 GB	80 GB	80 GB

*Os requisitos acima fornecem acesso a 500 usuários em paralelo dentro de um tempo de resposta aceitável, que inclui operações médias de leitura com menos de 3 segundos e operações de gravação com menos de 5 segundos, considerando uma relação leitura-gravação de 80:20. Para implantações maiores, consulte a seção Implantando uma Web Farm abaixo.

Sistemas operativos suportados

• Windows Server 2025

• Windows Server 2022

• Windows Server 2019

• Windows Server 2016

Navegadores da Web suportados

O portal Self-Service precisa de uma resolução de tela acima de 1024 X 768. É suportado nos seguintes navegadores:

• Microsoft Edge 121.0.2277.4 ou posterior

• Microsoft Internet Explorer 10 e 11

• Mozilla Firefox 42 e posterior

• Google Chrome 46 e posterior

Implantar o novo portal Self-Service

Consulte o artigo Desplegar o Novo Portal Self-Service para obter etapas detalhadas sobre como desenvolver o novo Portal Self-Service. As seções a seguir resumem as principais considerações de implantação.

Instalar o Portal como o site padrão

Se você quiser instalar o novo Self-Service Portal na porta 80, você deve primeiro mover o site padrão no IIS para uma porta diferente; por exemplo, porta 8080 e, em seguida, mova Self-Service Portal para a porta 80.

Usar SSL

SSL é recomendado para garantir uma comunicação segura, especialmente ao usar a autenticação básica quando um nome de usuário e senha são transferidos pela rede em texto sem formatação.

Topologias de implantação

Você pode usar as seguintes topologias de implantação para o portal Self-Service.

Servidor único (recomendado) - Portal de autoatendimento e o servidor do Service Manager no mesmo servidor

Nessa topologia, o novo Self-Service Portal e a função Servidor de Gerenciamento são instalados no mesmo servidor. Essa é a topologia recomendada porque evita qualquer atraso de rede entre o Portal e o Serviço SDK. Além disso, recomendamos que você instale o Portal Self-Service em um servidor secundário de Gerenciamento de Serviços para evitar qualquer degradação de desempenho devido a fluxos de trabalho em execução no servidor primário.

Nessa topologia, a Autenticação do Windows (configurada por padrão) é usada para fornecer autenticação segura sem a sobrecarga do uso de SSL.

Implantação autônoma do portal de autoatendimento

Nessa topologia, o portal Self-Service é instalado em um servidor que não tem a função de servidor de gerenciamento do Service Manager instalada.

Nessa configuração, o novo Portal Self-Service e o servidor secundário do Service Manager são instalados em servidores diferentes e um salto duplo é necessário para criar uma conexão com o Serviço SDK desde a aplicação Web. A Autenticação do Windows não pode ser usada nesse caso e o Portal precisa ser configurado para usar de Autenticação Básica. Como a Autenticação Básica é inerentemente insegura, o uso de SSL é recomendado para evitar quaisquer problemas de segurança de implantação, como acessar recursos além de firewalls e servidores proxy. Consulte detalhes adicionais sobre Autenticação Básica para cenários de salto duplo.

O uso de SSL com atrasos de rede entre o Portal e o Serviço SDK torna essa topologia mais lenta em comparação com uma implantação de servidor único. No entanto, esta configuração pode ajudar em cenários de implementação em que um salto duplo não pode ser evitado.

Implantando uma web farm

Um dos principais benefícios do novo Self-Service Portal é que o aplicativo Web não tem nenhum armazenamento de dados local além do cache. Ele lê e grava diretamente no banco de dados do Service Manager. Isso facilita a implantação de várias instâncias do servidor Web em paralelo. Para implantações grandes, com mais de 1.000 usuários acessando o portal em paralelo, você pode implantar o novo Portal Self-Service como um Web Farm semelhante à configuração a seguir.

Uma WebFarm garante alta disponibilidade ao Portal Self-Service. Internamente, o aplicativo Web cria uma conexão WCF com o Serviço SDK. Criar a conexão inicial leva tempo, então o cenário ideal é que o WebServer ao qual o usuário se conecta inicialmente atenda a todas as solicitações subsequentes para um retorno mais rápido. Para garantir esta configuração no IIS, a definição do ARR deve ser definida como Afinidade de Cliente habilitada.

Solucionar problemas de configuração

As seções de solução de problemas a seguir podem ajudá-lo a resolver problemas comuns.

O IIS não está instalado

A página Configuração mostra um erro de função do IIS, mesmo quando o IIS está habilitado no servidor.

Isso acontece quando o instalador é iniciado sem credenciais de administrador. Como resultado, o instalador não pode não acessar as definições de configuração do IIS.

Resolução: Execute SetupWizard.exe como um administrador. Você pode clicar com o botão direito do mouse em SetupWizard e selecionar Executar como administrador.

Solucionar problemas do portal New Self-Service

Esta seção descreve como solucionar problemas que você pode encontrar após a instalação do novo Self-Service Portal.

Configurações do IIS

As seguintes configurações padrão do portal são definidas durante a instalação -

Pool de aplicativos

Ele está configurado para ser executado no .NET CLR versão 4 no modo Clássico.

Em Configurações avançadas, o appPool é configurado para ser executado com uma Conta de Serviço fornecida durante a instalação. O mesmo usuário deve ter privilégio de administrador no Service Manager e na máquina local em que ele é executado.

Configuração do site

Somente Representação e Autenticação do Windows devem ser habilitados. Qualquer outra coisa deve ser desativada.

Para Representação, deve ser selecionado o utilizador autenticado .

Configurações de autenticação do Windows:

O documento padrão para o site deve ser index.cshtml.

Autenticação básica

Para um cenário de salto duplo, a Autenticação do Windows não funcionará; portanto, deve ser desativada. Habilite e configure a autenticação básica.

Ativar rastreamento

Use as etapas a seguir para habilitar o rastreamento.

Etapa 1 Adicione as seguintes configurações no arquivo web.config para habilitar a geração de log de eventos.

<system.web>  
   .....  
   <trace enabled="true"/>  
   ...  
</system.web>  

Etapa 2 saída direta para um arquivo adicionando as seguintes seções no arquivo web.config.

<system.diagnostics>  
    <trace autoflush="true">  
      <listeners>  
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\logs\SSPOutput.log" />    
      </listeners>  
    </trace>  
</system.diagnostics>  

Como o Aplicativo Web é executado no conteúdo do usuário conectado, certifique-se de fornecer permissões de gravação a todos os usuários na pasta de log. Por exemplo, c:\logs no exemplo acima.

Depurando o IIS

O IIS oferece suporte ao log eficiente para ajudá-lo a depurar problemas do IIS. Para obter mais informações, consulte Visão geral do log do IIS.

Solucionar problemas de implantação

Use as seções a seguir para solucionar problemas de implantação que podem afetá-lo.

As alterações de definição (Anúncios/Ofertas de Solicitação/Ofertas de Serviços/Artigos de Conhecimento) não são mostradas

O novo Self-Service Portal usa um mecanismo de cache para armazenar dados estáticos para fornecer tempos de resposta rápidos. O tempo limite do cache é definido como 30 minutos por padrão, o que é configurável. Para obter mais informações, consulte Implantar o Novo Portal Self-Service na seção Personalização Básica. Quaisquer alterações nas definições de anúncios, ofertas de solicitação, ofertas de serviço e artigos de conhecimento não são mostradas até que o cache seja limpo.

O cache de memória usado é baseado no .NET Framework MemoryCache. O conteúdo armazenado em cache permanece na memória até que o processo de trabalho do IIS seja encerrado. Reiniciar o IIS não ajuda, porque o IIS não remove um processo antigo e, em seguida, inicia um novo. Em vez disso, reutiliza um já existente. Para impor uma nova leitura e remover dados de cache, identifique o processo de Trabalho do IIS associado à instância e selecione Finalizar tarefa antes de reiniciar o IIS.

As seções Minhas solicitações e Minhas atividades estão vazias

Novas projeções de tipo são incluídas no arquivo Portal.mpb, que faz parte do instalador, e precisam ser importadas para o Service Manager. Para importar, use as etapas a seguir.

1. Importe o arquivo Portal.mpb no servidor de gerenciamento.

2. No Servidor de Gerenciamento ao qual o Portal se conecta, reinicie o Serviço SDK.

Pop-ups bloqueando links externos

Se a configuração Configuração de Segurança Reforçada para o Internet Explorer estiver habilitada, o usuário receberá o seguinte pop-up em cada página enquanto navega no portal.

O pop-up acima aparece para o SDK JavaScript do App Insights, que é integrado ao Portal Self-Service para coletar dados de telemetria. Você pode desabilitar o envio de dados de telemetria alterando o valor do parâmetro de configuração EnableTelemetry , que removerá o pop-up. Para obter mais informações, consulte Implantar o Novo Portal Self-Service na seção Personalização Básica.

Você pode acessar o portal no computador que hospeda o IIS, mas não pode acessá-lo de um computador remoto

Esse problema pode ocorrer se Portal e SDK Service estão localizados em computadores diferentes (Stand-Alone Self-Service Portal Deployment). Isso causa um cenário de salto duplo ao tentar aceder ao portal a partir de um computador remoto. Portanto, a configuração padrão do portal descrita em de Autenticação do Windows não funcionará. Para resolver este problema, use a configuração de autenticação básica em vez disso.

Não é possível ver algumas Ofertas de Serviço ou Ofertas de Serviço publicadas no portal

Isso ocorre porque as Ofertas de Serviço são exibidas somente se atenderem a uma das seguintes condições:

• A Oferta de Serviço adapta-se ao idioma do navegador ou ao idioma selecionado através do seletor de idioma do Portal.

• A Oferta de Serviço não tem idioma selecionado.

  

  

Aqui está a lista de idiomas com códigos de idioma que são suportados pelo portal:

• en-US: Inglês

• fr-FR: français

• de-DE: Deutsch

• cs-CZ: língua checa

• es-ES: español

• hu-HU: húngaro

• it-IT: italiano

• ja-JP: 日本語

• ko-KR: 한국어

• nl-NL: Neerlandês

• pl-PL: Polski

• pt-BR: português (Brasil)

• pt-PT: português (Portugal)

• ru-RU: русский

• sv-SE: Svenska

• tr-TR: Türkçe

• zh-CHS: 中文(简体)

• zh-TW: 中文(简体)

A exibição de tempo para meus itens sempre indica AM

Para resolver esse problema, localize a tag "utc-date" e substitua DateTime.Parse(xyz). ToString("yyyy,M,d,h,m,s") com DateTime.Parse(xyzToString("yyyy,M,d,H,m,s") nos seguintes ficheiros:

• Visualizações\KnowledgeBase\Article.cshtml

• Visualizações\MyActivities\ActivityDetails.cshtml

• Visualizações\MyRequests\RequestDetails.cshtml

• Visualizações\Shared\_Layout.cshtml

Próximos passos

• Para implantar o portal do Self-Service e personalizá-lo, revise Implantar o portal Self-Service.