O administrador pode configurar o Client System Analyzer (CSA) com mais detalhes modificando os parâmetros de contexto no arquivo WAR da aplicação CSA.
|
Nome do Parâmetro |
Descrição |
Valor Padrão |
|---|---|---|
| alertWhenDone | Se esta opção for definida como verdadeira, será exibida uma mensagem indicando que o applet foi executado. | falso |
| appletJAR | O nome do arquivo JAR | CSA.jar |
| aplicação |
O nome da aplicação associada à instância CSA. Se nenhuma aplicação for especificada, os clientes coletados por essa instância CSA não terão uma aplicação. |
nenhum |
| autoRedir | Se esta opção for definida como “verdadeira”, a página JSP CSA alterna automaticamente para a utilização da Sun JVM se a JVM tiver sido definida para o JInitiator, mas o cliente não tiver a versão apropriada do JInitiator instalada. | falso |
| bwTestFile | O nome do arquivo que foi obtido por download do servidor durante o teste de largura de banda. |
CSA.mb (incluído com a CSA na aplicação Grid Control) |
| bwTestMsec | O tempo que o applet deverá passar pelo teste de largura de banda. O applet calcula a largura de banda contando o número de bytes que ele pode obter por download nesse intervalo. | 200 ms |
| classid |
O campo “classid” para a tag OBJECT. Só será aplicável quando a JVM tiver sido definida como “JInitiator.” O classid para Sun é “clsid:8AD9C840-044E-11D1-B3E9-00805F499D93” |
nenhum – este campo DEVERÁ ser preenchido quando a JVM tiver definida como “JInitiator,” sendo ignorado caso a JVM tenha sido definida de outra forma |
| codebase | O campo codebase da tag OBJECT. Só será aplicável quando a JVM tiver sido definida como "KInitiator". | O default para Sun é http://java.sun.com/products/plugin/autodl/jinstall-1_4_2-windows-i586.cab#Version=1,4,0,0 |
| classid |
O campo “classid” para a tag OBJECT. Só será aplicável quando a JVM tiver sido definida como “JInitiator.” O classid para Sun é “clsid:8AD9C840-044E-11D1-B3E9-00805F499D93” |
nenhum – este campo DEVERÁ ser preenchido quando a JVM tiver definida como “JInitiator,” sendo ignorado caso a JVM tenha sido definida de outra forma |
| collectCookie | A lista dos nomes dos cookies a serem coletados. Esse parâmetro é uma lista separada por vírgulas de nomes de cookies. Apenas cookies para o usuário do Sistema Operacional atual no browser atual serão coletados. O administrador poderá especificar ‘*' para coletar todos os cookies do usuário atual para o browser atual. | Se este campo não estiver presente, nenhum cookie será coletado. |
| cookieDomain | O domínio do cookie CSA. | Se o domínio ou o caminho do cookie não for definido, o cookie será desativado |
| cookieMaxAge | A duração máxima, em segundos, do cookie na máquina cliente. | o default é 1 ano |
| cookiePath | O caminho do cookie CSA | Se o domínio ou o caminho não for definido, o cookie será desativado |
| customClass | O nome da classe usada para coletar dados personalizados (veja abaixo) | nenhum – o comportamento default é que nenhum código personalizado seja executado |
| customKey1 customKey2 customKey3 |
O valor das chaves personalizadas. Todas as coletas feitas por uma página JSP CSA que utiliza esse descritor de disponibilização terão esses valores para as chaves personalizadas. Esses valores podem ser sobrepostos pelo código personalizado. | Se nenhum valor de chave personalizada for especificado, nada será coletado (a menos que e a coleta seja feita por código personalizado) |
| descriptionFile | O caminho completo de um arquivo de texto que contém a descrição a ser exibida na página de disponibilização. O conteúdo do arquivo deverá estar em formato HTML. | nenhum |
| destURL | Especifica o URL de alvo. Esse é o URL ao qual o botão Prosseguir da página JSP CSA está associado. | Se nenhum destURL for especificado, o botão “Prosseguir” levará o usuário à página de referência; se não houver uma página de referência, o botão “Prosseguir” não será exibido. |
| destURLResultsParam | Especifique o nome do parâmetro de URL que será adicionado ao “URL de alvo” para indicar o nível de conformidade do cliente. Por exemplo, se o valor tiver sido “conformidade” e o nível geral de conformidade do cliente tiver sido crítico, o parâmetro “compliance=critical” será adicionado ao URL de alvo. | Sun |
| JVM | Esta opção determina o tipo de JVM a ser usado. Se o valor for “Sun”, a página JSP redirecionará o browser para usar a JVM Sun. Se o valor for “Oracle”, a página redirecionará o browser a utilizar o Oracle JInitiator. Se o valor for “qualquer um”, a JSP gravará a tag “applet”, fazendo com que o cliente use qualquer JVM que esteja conectada ao browser. | Sun |
| maxExecInterval | O parâmetro que é adicionado ao payload de cookie CSA. Quando a lógica de redirecionamento lê o cookie e o timestamp do cookie difere do horário atual em um valor acima desse, o applet é disponibilizado novamente. Esse parâmetro pode ser sobreposto pelo parâmetro de contexto “csa_execInterval” no filtro/JSP de redirecionamento. | 90 dias |
| maxFileSize | O volume máximo de dados, em KB, que pode ser publicado de volta no receptor em uma única solicitação. Se o tamanho dos dados publicados exceder esse limite, a solicitação será rejeitada e os dados já gravados no disco rígido serão deletados. | 100 |
| maxOutptFiles | O número máximo de arquivos de saída que podem estar presentes em XML OutputDir. |
100 |
| outputDir | O diretório em que os arquivos xml da configuração CSA serão gravados. A página de applet e a página do receptor deverão ler esse parâmetro; e esse parâmetro deverá ser idêntico para ambas as páginas. | Por default, os arquivos de saída são gravados no subdiretório “csa_results” do diretório-raiz da aplicação (se o diretório-raiz da aplicação existir e o subdiretório existir ou puder ser criado). A utilização do valor default para esse parâmetro não é recomendada. |
| outputEnabled | Ativa ou desativa a criação de arquivos XML de saída. Aplicável a ambas as páginas. |
Por default, os arquivos XML são criados e armazenados em XMLOutputDir. |
| pluginspage | Esta opção é usada para direcionar o usuário ao JVM Installer sob o Netscape, pois o Netscape não suporta instalação automática. Aplicável somente se a JVM tiver sido definida como JInitiator. O default para Sun é http://java.sun.com/products/plugin/index.html#download | nenhum – este campo DEVERÁ ser preenchido quando a JVM tiver sido definida como “JInitiator”, sendo ignorado caso a JVM tenha sido definida de outra forma receptor |
| receptor |
O URL no qual o applet deverá publicar os dados coletados. Observação: ao definir este parâmetro, o administrador deve certificar-se de que a versão do receptor é a mesma versão do applet. |
O default é procurar por “CSAr.jsp” no mesmo caminho que a página JSP CSA. |
| ruleFile | Especifica no servidor, em relação ao diretório-raiz da aplicação Web, o caminho do arquivo que contém as regras a serem avaliadas. | rules.xml |
| script | Especifica um script, fornecido pelo administrador, que pode ser processado no arquivo XML CSA antes de ele ser marcado para upload pelo agente. | nenhum – se nenhum script for especificado, nenhum script será processado |
| tipo | O campo “tipo” da tag OBJECT mostrado pela página JSP CSA para disponibilizar o applet. Isso só será aplicável se a JVM tiver sido definida como “JInitiator”. Se a JVM tiver sido definida como “Sun”, o tipo será “aplicação/x-java-applet” | nenhum – este campo deverá ser preenchido quando a JVM tiver definida como “JInitiator,” sendo ignorado caso a JVM tenha sido definida de outra forma |
| viewData | Se for definido como verdadeiro, esse parâmetro permitirá que o usuário final veja os dados coletados após eles terem sido publicados no servidor. | falso |
Além desses parâmetros, também é possível configurar os parâmetros de redirecionamento CSA. O redirecionamento pode ser ativado por meio da utilização de um filtro de servlet ou da inclusão de um arquivo JSP de redirecionamento CSA em alguma outra página. O parâmetro de contexto a seguir deverá estar disponível para redirecionar o trabalho.
|
Nome do Parâmetro |
Descrição |
Valor Padrão |
|---|---|---|
| csa_csaURL | O URL da página JSP CSA para o qual o usuário deverá ser redirecionado. | Sem valor default: esse valor deverá ser definido ou o redirecionamento não poderá funcionar |
| csa_execInterval | O intervalo, em segundos, entre execuções do CSA. Se a diferença entre a idade do cookie e o horário atual do servidor for maior que execInterval, o usuário será redirecionado. |
nenhum. Se execInterval não for definido, o usuário só será redirecionado se houver um cookie CSA |
| csa_redirectURL | O URL para o qual o usuário deverá ser direcionado após a execução do CSA |
nenhum: se este parâmetro não for definido, o usuário será direcionado de volta para a página solicitada originalmente. |
| csa_UIMode |
0 - síncrono (na janela atual do browser) 1 - visível assíncrono 2 - invisível assíncrono |
síncrono |
Observação: Se o administrador ativar o redirecionamento utilizando o filtro de servlet CSA, os parâmetros mostrados acima deverão ser fornecidos na forma de parâmetros de inicialização para o filtro (exceto o parâmetro UIMode, que não é obrigatório no caso do filtro de servlet.)
Em determinados casos, talvez sejam necessários diferentes conjuntos de parâmetros para diferentes aplicações. Por exemplo, duas diferentes aplicações podem ter conjuntos de regras e códigos personalizados distintos, e o administrador talvez queira associá-los a diferentes Alvos de Coleta CSA. Nesse cenário, o administrador pode especificar os parâmetros ruleFile, appletJar, script e outputDir para uma aplicação específica utilizando os parâmetros de contexto “<nome da aplicação> ruleFile,” <nome da aplicação> appletJar,” etc. Se uma aplicação for especificada, como parâmetro de contexto ou por meio de URL, a CSA será executada com os valores de parâmetros específicos para a aplicação. Se nenhuma aplicação for especificada ou um dos parâmetros de uma aplicação não for sobreposto, os parâmetros default serão usados.
Alguns dos parâmetros especificados na tabela acima também podem ser especificados como parâmetros de URL. Se o parâmetro “application” for especificado no URL, os parâmetros de contexto associados a essa aplicação serão utilizados, em vez dos parâmetros default. Se um parâmetro for especificado no URL, ele sobreporá o valor para esse parâmetro especificado no descritor de desenvolvimento da aplicação CSA e também sobreporá o valor específico da aplicação para esse parâmetro de contexto nos casos em que uma aplicação é especificada.
Os parâmetros que podem ser especificados no URL são: customKey1-3, alertWhenDone, application, autoRedir, bwTestMsec, JVM, uiMode.
Sobre o Client System Analyzer
Roteiro de Informações do Enterprise Manager
Copyright © 1996, 2007, Oracle. Todos os direitos reservados.