parte 8 gateway web - scada.comscada.com/content/userguides/statusenterprise_pt/status...

Status Enterprise Guia do Usuário

Parte 8 – Gateway Web

Status Enterprise Gateway Web

1

Conteúdos

1 RESUMO 3

1.1 Especificações /Requerimentos da Gateway ....................................................................... 3 1.2 Suporte para Dispositivos Móviles ........................................................................................ 4 1.3 Conectando com a Gateway ................................................................................................ 4 1.4 Arquitetura ............................................................................................................................ 4 1.5 Características Suportadas e Limitações ............................................................................. 4 1.5.1 Características Soportadas ............................................................................................... 5 1.5.2 Controles UI Suportados ................................................................................................... 5 1.5.3 Espaços de trabalho e Segurança .................................................................................... 8 1.5.4 Restrições .......................................................................................................................... 8

2 PERSONALIZANDO O INÍCIO DE SESSÃO PARA A GATEWAY ......................................................... 10

2.1 Configurações de Início de Sessão Automático ................................................................. 10 2.2 Fixando uma Rota para o “Mimic” por Padrão. .................................................................. 11 2.3 Método de Navegação Recomendado ............................................................................... 13 2.4 Mudando o Servidor da Gateway ....................................................................................... 13 2.5 Criando uma Página de Início de Sessão Personalizada. ................................................. 15 2.6 Movendo a Gateway para outro Site IIS ............................................................................. 16 2.6.1 Borrar la Gateway desde el Sitio Web Actual en IIS ....................................................... 16 2.6.2 Adicionando a Gateway para um novo Site IIS ............................................................... 17

3 RESOLUÇÃO DE PROBLEMAS .................................................................................................... 18

3.1 Elementos Truncados ......................................................................................................... 20


2

Imagems e Tabelas Imagem 1 – Especificações/Requerimentos ................................................................................................. 3

Imagem 2 – Tela de Configuração de IIS ................................................................................................... 10

Imagem 3 – Pantalla de Configurações de Aplicaión ................................................................................. 11

Imagem 4 – Administrador de IIS. .............................................................................................................. 12

Imagem 5 – Rota do “mimic” por Padrão .................................................................................................... 12

Imagem 6 – Configurações de Aplicação ................................................................................................... 13

Imagem 7 – Rota do Servidor na Gateway ................................................................................................. 14


3

1 Resumo Este documento define as linhas gerais no uso da interfaz de usuário para o tempo de execução baseado em Web de Status Enterprise conhecido Passagem ou Gateway Web. A Gateway é um aplicativo ASP.NET que conecta com o servidor de Status Enterprise e transforma os “mimics” salvados no servidor como XAML, em documentos HTML 5 para os navegadores Web. Os “Mimics” que foram abertos vão ter conexão com os dados em tempo-real. A maioría dos navegadores e dispositivos móveis– incluindo o Ipad – suportam HTML5. Para uma lista de termos freqüentes, definições e abreviaturas, por favor, consulte a Parte 1 – Resumo e Conceitos Básicos. NOTA: A fim de que a aplicação de Gateway funcione, IIS deve estar instalado antes que o Status Enterprise for instalado.

1.1 Especificações /Requerimentos da Gateway

XP 7 & 8 IIS Deve estar instalado. *Passos:

Abra “Ativar ou Desativar características de Windows”

Ative “Internet Information Services”

Expanda “Internet Information Services\Servicios World Wide Web \Características de Desenvolvimento de Aplicações \” e ative “ASP.NET 4.5”

Clique em “OK” *Sãe voçê não tiver permissões para editar as características de Windows, contacte o seu administrador de red.

Após a instalação de IIS você precisa executar o executável RegIIS localizado em “%WindowsDir%\Microsoft.NET\Framework\v4.0.30319\...” e nomeado “aspnet_regiis.exe”. *Se tiver um SO de 64 bits, substitua Framework por Framework64.

No administrador de IIS o “Pool” de Aplicações devería ser fixado da seguinte forma: IIS > ApplicationPools > Advanced Settings

.NET Framework Ver = v4.0 Identity = Network Service

Navegadores suportados: Mozilla Firefox Google Chrome **Preferentemente**

Navegadores soportados: Internet Explorer Google Chrome **Preferentemente** Mozilla Firefox Safari Opera

Imagem 1 – Especificações/Requerimentos


4

Ao executar IIS 8 e Windows Server 2012, é extremadamente recomendável que você instale o Protocolo WebSocket desde as características e funções do servidor.

As regras de entrada/salida do Firewall devem ser especificamente fixadas para o executável do servidor (StatusEnterpriseServer.exe) por cada zona sobre a que esperamos enviar dados.

Os arquivos estáticos “js” deveríam se usar em modo usuário e modo Kernel armazenando em cache para reduzir o tempo de carregamento de páginas.

1.2 Suporte para Dispositivos Móviles

A gateway Status Enterprise pode ser acessada a partir de iPads, Iphones e quaisquer dispositivos móveis que suportem HTML5, permitindo o acesso móvel direitamente para seus “mimics” e dados ao vivo sem necessidade de se conectar com um cliente remoto via VPN.

1.3 Conectando com a Gateway A primeira vez que um usuário tenta acessar na Gateway, vai se fazer uma comprobação para verificar que o IIS está instalado e configurado no seu sistema. Se o IIS não estiver instalado, vai se solicitar ao usuário para que esta instalação seja completada antes de usar Gateway Status Enterprise. Se o IIS já estiver instalado, o cliente da Gateway vai executar um teste do administrador de IIS para verificar que ele está configurado corretamente. Se não¸a configuração será comletada automáticamente antes de que o usuário possa iniciar sessão. Seu Administrador de Rede vai lhe fornecer com a direcção web para iniciar sessão na Gateway Status Enterprise. A URL por padrão é http://localhost/StatusEnterpriseGateway e usa o porto 4502. A página de inicio de sessão vai pedir o nome usuário e a senha. Após ter iniciado sessão vai se mostrar um sistema de navegação que permite navegar através das pastas até o documento que você deseje abrir – o “path” da pasta atual, é na parte inferior da tela e tem um botão para mudar de nível. Um nome de usuário e senha pode ser introduzido na Gateway através do arquivo “web.config” a fim de que a gateway inicie com um usuário automaticamente (isto podería ser especialmente util se você tiver uma conta de usuário público com a gateway hospedada no servidor web). Também pode se adicionar uma rota para o documento na mesma forma se quisermos que o usuário inicie sessão sobre um “mimic” específico.

1.4 Arquitetura A Gateway Status Enterprise inicia sobre o Servidor Status e mantém a sessão para seu cliente web quando você tem a sessão iniciada. A Gateway faz solicitações ao “mimic” a partir do servidor usando o documento selecionado através do sistema ou especificado no arquivo “web.config”. Quando o documento é passado para a Gateway, ela o torna num documento a partir de seu formato nativo de “mimic” XAML para um documento HTML5. O HTML este é devolvido ao cliente para ser mostrado num navegador web. Uma conexão de soquete web é criada entre a Gateway eo cliente web. Todos os gráficos no documento HTML5 que contêm ligações para dados em tempo real são atualizados através da conexão de soquete web para o Gateway.

1.5 Características Suportadas e Limitações

http://localhost/StatusEnterpriseGateway


5

1.5.1 Características Soportadas

Os “Mimics” que funcionam na Gateway terão quase todas as funcionalidades que têm no cliente Runtime. Todos os controles de navegação são suportados. Todos as ligações de Dados são suportadas, incluindo as ligações bidirecionais, e vão continuar a atualização com dados ao vivo e aceitando a escrita de propiedades a partir do “mimic”. As Tendências também são suportadas, quer as históricas e as que funcionam com dados em tempo real.

Os Controles de Alarmes atualmente não estão suportados, por tanto, embora seus dados sejam monitorados em tempo real e seus alarmes estejam monitorando as mudanças, você não vai ver os controles de alarmes a partir da Gateway Web.

1.5.2 Controles UI Suportados Os Documentos XAML destinados à conversão para a HTML precisam usar um subconjunto de Controles UI disponíveis no Designer de “Mimics”, que incluem:

1.5.2.1 Botões

Flat Toggle Switch (Interruptor Plano de alternância)

Gel Toggle Button (Botão Gel de alternância)

Generic Toggle Button (Botão de alternância Genérico)

Industrial Toggle Button (Botão de alternância industrial)

Power Toggle Button (Botão de alternância de energía)

Toggle Switch (Interruptor de alternancia)

1.5.2.2 Controles Comuns

Check Box (Caixa de Seleção)

Label (Etiqueta)

Text Block (Bloco de Texto)

1.5.2.3 Controles de Data e Hora

Date Time Display (Mostrador de Data e Hora)

1.5.2.4 Controles de Bitola

Dual Gauge (Bitola Dupla)

Dynamic Gauge (Bitola Dinámica)

Horizontal Linear Gauge (Bitola Linear Horizontal)

Parabolic Gauge (Bitola Parabólica)

Racing Gauge (Bitola de Racing)


6

Radial Gauge (Bitola Radial)

Simple Gauge (Bitola Simples)

Variable Gauge (Bitola Variável)

Vertical Linear Gauge (Bitola Vertical Linear)

1.5.2.5 Painéis e Grelhas

Canvas (Lona)

1.5.2.6 Controles Indicadores

Indicator Tower Three State

1.5.2.7 Entrada

Data Text Box (Caixa de texto de dados)

1.5.2.8 Etiquetas

Data Label (Etiqueta de Dados)

Variance Label (Etiqueta de Variação)

1.5.2.9 Monitores LED

LED Five By Seven Matrix (de Matriz Cinco por Sete)

LED Light (de Luz)

LED Seven Segment (de Segmento Sete)

LED Sixteen Segment (de Segmento dezesseis)

1.5.2.10 Mídia

Bindable Image (Imagem Vinculável)

1.5.2.11 Controles Diversos

Ratings Control (Controle de Classificação)

1.5.2.12 Motores e Ventiladores

Centrifugal Pump (Bomba Centrífuga)


7

Gear (Engrenagem)

Heavy Motor (Motor Pesado)

Helical Motor (Motor Helicoidal)

Metal Fly Wheel

Paddle Wheel

Simple Fan

Small Fly Wheel

Sprocket (Roda Dentada)

Square Motor (Motor Quadrado)

Tire (Pneu)

Wind Generator (Gerador de Vento)

1.5.2.13 Botões de Navegação

Gel Navigation Back Button

Gel Navigation Button

Navigation Back Button

Navigation Border (Borda ou Limite de Navegação)

Navigation Button (Botão de Navegação)

Navigation Combo (Combinação)

Navigation List

1.5.2.14 Tanques e Tubulações

Connector Pipe (Tubulação conectora)

Cutaway Tank (Tanque de Corte)

Cylinder Tank (Tanque de Cilindro)

Fitted Elbow Pipe (Tubo de cotobelo embutido)

Fitted Pipe (Tubo adaptado)

Funnel Tank

Indicator Tank

Ladder Tank (Tanque de escada)

Mixing Tank (Tanque de mistura)

Standard Elbow Pipe (Tubo de Cotobelo Standard ou Padrão)

Standard Pipe (Tubo Padrão)

Universal Pipe Connector (Conector de Tubo Universal)

Valve (Válvula)


8

Vessel Tank (Tanque de Vaso)

1.5.2.15 Formas

Ellipse

Line

Path

Polygon

Polyline

Polygon and Polyline Pencil

Rectangle

1.5.2.16 Tendências

Trend Graph (Grafico de Tendências)

Graph Pen (Pena gráfica)

Até aquí os controles UI suportados em HTML5.

1.5.3 Espaços de trabalho e Segurança

A configuração de Segurança e os Espaços de Trabalho (E. T.) de seu modelo de dados são aplicáveis quando os “Mimics” são executados na Gateway Web. Seu inicio de sessão é monitorado pelo Status Server, então, os Espaços de Trabalho de que você é membro vão ser mostrados na sua sessão web. As propriedades que você não pode acessar segundo os seus E. T. , não vão ser atualizadas.

1.5.4 Restrições Como temos mencionado acima, há certos controles na "caixa de ferramentas" do Designer de Mimics que não são compatíveis com a Web Gateway. A lista de controles suportados pode ser encontrada na Secção 1.5.2. Usando a Gateway para executar um “mimic” que tiver alguns controles no suportados, não impede que o “mimic” funcione mas esses controles não vão ser mostrados tela. Em vez disso, um marcador genérico vai ser exibido. Todos os controles suportados funcionam normalmente. Os alarmes não estão disponíveis na Gateway Web, e as Tendências estão disponíveis com suporte limitado. Os “mimics” na gateway podem ser mostrados a partir de qualquer navegador que suporte HMTL5, incluindo as versões atuais dos seguintes navegadores:


9

Internet Explorer

Chrome

Firefox

Opera

Safari A maioria dos navegadores móveis têm adotado o padrão HTML5, mas nem sempre a compatibilidade das características com os dispositivos e a mesma. Se quiser verificar a compatibilidade de seu dispositivo com HTML5 antes de usar a Gateway Web, até hoje você pode tentar através dos seguintes navegadores móveis (todos suportam HTML5):

Safari iOS

Android Browser

Google Chrome

Amazon Silk

Blackberry Browser

Nokia Browser

Internet Explorer

Opera Mobile

Opera Mini

Firefox


10

2 Personalizando o Início de Sessão para a Gateway

2.1 Configurações de Início de Sessão Automático

Esta Secção descreve como configurar o Gateway para pular a tela de Início de Sessão usando as credenciais predefinidas.

Requerimentos:

No arquivo Web.config, as variáveis “Nome de usuário” e “Senha” devem estar fixadas com as credenciais corretas, e a configuração “Inicio de Sessão Automático” precisa estar fixado para um valor de ‘Sim’.

Exemplo:

Abra IIS, selecione a Aplicação “StatusEnterpriseGateway” e depois selecione a característica “Configuração da Aplicação”.

Imagem 2 – Tela de Configuração de IIS


11

Fixe “Início de Sessão Automático” a ‘Sim’, e o ‘Nome de usuário’ e a ‘Senha” às credenciais correspondentes.

Imagem 3 – Pantalla de Configurações de Aplicaión

Agora, quando você abrir a gateway, automáticamente vai iniciar sessão com o usuário predefinido.

2.2 Fixando uma Rota para o “Mimic” por Padrão.

Esta secção descreve como fixar um “mimic” para mostrar quando o usuário inicie sessão, em vez de a pagina de navegação do modelo.

Requerimentos:

A viariável DefaultMimicPath no arquivo Web.config deve ser fixada com uma rota válida. Exemplo:

Abra o IIS, selecione a aplicação “StatusEnterpriseGateway” e depois selecione a característica “Configurações de Aplicação”.


12

Imagem 4 – Administrador de IIS.

Fixe “DefaultMimicPath” com uma rota válida para o “mimic” que quiser mostrar.

Imagem 5 – Rota do “mimic” por Padrão


13

Agora quando você iniciar uma sessão na Gateway, este “mimic” será mostrado em vez do sistema de navegação.

2.3 Método de Navegação Recomendado

A Gateway Status Enterprise inclui un menú de navegação. O menú é mostrado após o início de sessão.

Este menú fornece de acesso rápido para todo o “mimic”, e para os Activos, mas não é o método

recomendado de navegação. A Boa Prática sería criar uma Página de Início com botões de navegação

para os “mimics” necessários.

2.4 Mudando o Servidor da Gateway

Esta secção define como especificar com qual Servidor de Gateway Web vamos nos conectar:

Requerimentos:

A variável ‘StatusEnterpriseServer’ o arquivo Web.config deve ter fixada uma rota para o servidor.

Exemplo:

Abra o IIS, selecione la Aplicação “StatusEnterpriseGateway”, e depois selecion a característica “Configurações de Aplicação”.

Imagem 6 – Configurações de Aplicação


14

Fixe “StatusEnterpriseServer” para uma rota válida no Servidor Status Enterprise.

Imagem 7 – Rota do Servidor na Gateway

Agora a Gateway irá conectar a um servidor em outro lugar em vez de sua máquina.


15

2.5 Criando uma Página de Início de Sessão Personalizada.

Requerimentos:

Voçê tem que ter um formulario com uma acção de "UserLogin.aspx" e um método “post”

Para o formulárico vão ser requeridas três entradas: uma entrada de texto “Nome de Usuário”, outra de “Senha” e um botão de “Enviar”.

A caixa de texto de entrada “Nome de Usuário” precisa um nome de “Nome de Usuário” e “Senha” precisa um nome de “Senha”

A terceira entrada deve ser de tipo "Enviar" ou “Submit”

Para mostrar erros quando o início de sessão falhar, adicione uma referência para o script query_string.js e nomeie-la loadPageVar(“error”). Isto vai devolver um erro para o servidor quando i Início de Sessão falhar. Isto pode ser armazenado numa variável e mostrado na página da forma necessária.

Exemplos:

Formulário com Entradas – HTML

<form action=”UserLogin.aspx” method=”post”>

<input type=”text” name=”username” placeholder=”Username” /> <input type=”password” name=”password” placeholder=”Password” /> <input type=”submit” title=”Log In” />

</form>

Salvando o “erro” como uma variável e mostrando-lo na página – Javascript w/ librería de jQuery referenciada y usada $(function() {

var error = loadPageVar(“error”); if (error != undefined && error != null && error != “”) {

var errorBar = $(‘#errorBar’); errorBar.text(error); errorBar.css(‘display’, ‘block’);

} });

Ativando Encriptação SSL Javascript w/ librería de jQuery referenciada y usada $(function() { If (location.href.substring(0,5) != “https”)

{ Location.href = “https” + location.href.substring(4); }

});


16

NOTA: Se estiver criando uma tela de início de sessão personalizada, verifique que a Gateway está apontando para a página que você criou, atualizando o parâmetro "loginPage" localizado nas "Configurações do aplicativo" no IIS.

2.6 Movendo a Gateway para outro Site IIS

É possível que voçê queira mover a Gateway para outro site de IIS. Esta secção vai guiá-lo sobre como mover a Gateway isso com sucesso.

2.6.1 Borrar la Gateway desde el Sitio Web Actual en IIS

Para eliminar la gateway, navege até o site onde a Gateway esté instalada. Si está disponible, la Gateway será instalada en el sitio Web por defecto. Si no está disponible crea un nuevo sitio llamado “StatusEnterpriseGateway”. Expande el sitio, después encuentra una Aplicação de IIS llamada “StatusEnterpriseGateway” y haz clic derecho para sacar el menú contextual y selecciona eliminar como se miestra na imagem de abajo:


17

2.6.2 Adicionando a Gateway para um novo Site IIS

Para añadir el Gateway en el IIS, primero selecciona tu Sitio Web IIS donde quieras añadir la Gateway, después crea un nuevo “Directorio Virtual” que apunte a la carpeta de la Gateway en tu directorio de instalação de Status Enterprise (C:\Program Files\B-Scada\StatusEnterprise\Gateway by default).

Después, convierte el Directorio Virtual para una Aplicação usando el botón derecho del ratón, asegurate que el “Pool” de Aplicações está siendo usado. La Gateway Status Enterprise requiere que el “Pool” de Aplicações usado esté ejecutando ASP.NET 4.0 usando una fuente de informação ejecutandose como servicio de red. Una vez completado, verifica que la Gateway carga apropiadamente visitando la URL asociada con el sitio al que has añadido la Gateway.

NOTA: Si mueves la Gateway a otro sitio, asegurate que el Index.aspc está añadido al documento por defecto.


18

3 Resolução de Problemas

Error Code:

Server Error in '/StatusEnterpriseGateway' Application.

Access to the registry key 'Global' is denied.

Description: Una excepção no controlada durante la ejecução de la solicitud Web actual. Revise el seguimiento de la pila para obtener más informação acerca del error y dónde se originó en el código.

Exception Details: System.UnauthorizedAccessException:EL Acesso a la clave del registro 'Global' está denegado. ASP.NET No autoriza el acesso a este recurso. Considera garantizar los derechos de acesso al recurso para la petição de identidad de ASP.NET. ASP.NET tiene un proceso de identidades base (normalmente {MACHINE}\ASPNET en IIS 5 o Servicio de Red en IIS 6 and IIS 7, y la aplicação de “pool” de identidades configurada en IIS 7.5) que es usado si la aplicação no utiliza impersonação. Si la aplicação utiliza impersonação via <identity impersonate=”true”/> la identidad será anónima.

Para garantizar acesso ASP.NET a un arquivo, haz clic derecho en el arquivo en el explorador, elige propiedades y selecciona la pestaña Seguridad. Haz clic para agregar el usuário o grupo apropiado.Realza la cuenta ASP.NET, y marca las cajas para el acesso deseado.

Source Error:

Line 96: socketServer.NewMessageReceived += new

SessionEventHandler<WebSocketSession, string>(socketServer_NewMessageReceived);

Line 97:

Line 98: if (!SocketServerManager.Start())

Line 99: {

Line 100: SocketServerManager.Stop();

Arquivo Origen: c:\Status Enterprise 2011 Q4\Gateway\Status.Enterprise.Gateway\Global.asax.cs Line: 98

Stack Trace:

[UnauthorizedAccessException: Access to the registry key 'Global' is denied.]

Microsoft.Win32.RegistryKey.Win32Error(Int32 errorCode, String str) +6504925

Microsoft.Win32.RegistryKey.InternalGetValue(String name, Object defaultValue,

Boolean doNotExpand, Boolean checkSecurity) +361

Microsoft.Win32.RegistryKey.GetValue(String name) +62


19

System.Diagnostics.PerformanceMonitor.GetData(String item) +148

System.Diagnostics.PerformanceCounterLib.GetPerformanceData(String item) +255

System.Diagnostics.PerformanceCounterLib.get_CategoryTable() +172

System.Diagnostics.PerformanceCounterLib.CounterExists(String category, String

counter, Boolean& categoryExists) +35

System.Diagnostics.PerformanceCounterLib.CounterExists(String machine, String

category, String counter) +95

System.Diagnostics.PerformanceCounter.InitializeImpl() +392

System.Diagnostics.PerformanceCounter..ctor(String categoryName, String

counterName, String instanceName, Boolean readOnly) +373

System.Diagnostics.PerformanceCounter..ctor(String categoryName, String

counterName, String instanceName) +14

SuperSocket.SocketEngine.SocketServerManager.StartPerformanceLog() +252

SuperSocket.SocketEngine.SocketServerManager.Start() +498

Status.Enterprise.Gateway.Global.StartSuperWebSocketByConfig() in c:\Status

Enterprise 2011 Q4\Gateway\Status.Enterprise.Gateway\Global.asax.cs:98

[HttpException (0x80004005): Access to the registry key 'Global' is denied.]

System.Web.HttpApplicationFactory.EnsureAppStartCalledForIntegratedMode(HttpConte

xt context, HttpApplication app) +12864673

System.Web.HttpApplication.RegisterEventSubscriptionsWithIIS(IntPtr appContext,

HttpContext context, MethodInfo[] handlers) +175

System.Web.HttpApplication.InitSpecial(HttpApplicationState state, MethodInfo[]

handlers, IntPtr appContext, HttpContext context) +304

System.Web.HttpApplicationFactory.GetSpecialApplicationInstance(IntPtr

appContext, HttpContext context) +404

System.Web.Hosting.PipelineRuntime.InitializeApplication(IntPtr appContext) +475

[HttpException (0x80004005): Access to the registry key 'Global' is denied.]

System.Web.HttpRuntime.FirstRequestInit(HttpContext context) +12881540

System.Web.HttpRuntime.EnsureFirstRequestInit(HttpContext context) +159

System.Web.HttpRuntime.ProcessRequestNotificationPrivate(IIS7WorkerRequest wr,

HttpContext context) +12722601

Solução:

1. Abra o administrador de IIS.

2. Expanda a máquina local no painel conexões da esquerda. 3. Clique no “Pool” de Aplicações no painel de conexões. 4. Clique com botão direito em StatusEnterpriseGateway no painel “Pool” de Aplicações e selecioe

Configurações Avanzadas. 5. Baixo o frame “Modelo del Proceso” selecione identidade. 6. Clique no botão sobre o ‘…’ na direita dos valores disponíveis. 7. Selecione “Conta ‘Built-in’:

“NetworkService”


20

3.1 Elementos Truncados

Ativar o registro de dados de WCF poder gerar uma perda de dados. Consulte ‘Habilidando WFC registrando motivos de corrupção no serviço webHttp que devolve uma correnteça: http://social.msdn.microsoft.com/Forums/en-US/wcf/thread/2bc5e5a6-1971-46cb-8b4f-f1c46130faca

http://social.msdn.microsoft.com/Forums/en-US/wcf/thread/2bc5e5a6-1971-46cb-8b4f-f1c46130faca

parte 8 gateway web - scada.comscada.com/content/userguides/statusenterprise_pt/status...

Documents