BlackBerry Social Networking Application Proxy para IBM Lotus Quickr Versão: Guia de instalação e configuração

Transcrição

1 BlackBerry Social Networking Application Proxy para IBM Lotus Quickr Versão: Guia de instalação e configuração

2 SWDT

3 Conteúdo 1 Visão geral... 3 Arquitetura: BlackBerry Social Networking Application Proxy e BlackBerry Client para IBM Lotus Quickr Requisitos de sistema: BlackBerry Social Networking Application Proxy Instalando o BlackBerry Social Networking Application Proxy... 7 Pré-requisitos: instalando o BlackBerry Social Networking Application Proxy... 7 Instalar o BlackBerry Social Networking Application Proxy... 7 Atualizar o BlackBerry Social Networking Application Proxy para a versão Tarefas pós-instalação... 9 Verificar se o BlackBerry Social Networking Application Proxy está em execução... 9 Instrua o usuário a especificar o endereço de servidor do BlackBerry Client para IBM Lotus Quickr Importando definições de política de TI para o BlackBerry Enterprise Server Importar definições de política de TI usando a ferramenta loadbesmetadata.exe Importar definições de política de TI usando o BlackBerry Manager Importar definições de política de TI usando o BlackBerry Administration Service Configurar regras de política de TI Permitir uma conexão confiável Permitir uma conexão confiável entre o BlackBerry Social Networking Application Proxy e o BlackBerry MDS Connection Service Determinar a versão do JRE usada pelo BlackBerry MDS Connection Service Distribuindo o BlackBerry Client para IBM Lotus Quickr a dispositivos BlackBerry Distribuir o BlackBerry Client para IBM Lotus Quickr aos dispositivos BlackBerry a partir do BlackBerry Social Networking Application Proxy Distribuir o BlackBerry Client para IBM Lotus Quickr aos dispositivos BlackBerry a partir do BlackBerry Enterprise Server versão Criar um índice de software para aplicativos em uma unidade de rede Instalar o BlackBerry Client para IBM Lotus Quickr imediatamente nos dispositivos BlackBerry em um grupo de usuários Distribuir o BlackBerry Client para IBM Lotus Quickr aos dispositivos BlackBerry a partir do BlackBerry Enterprise Server versão

4 7 Configurando o BlackBerry Social Networking Application Proxy Alterar a senha padrão para o BlackBerry Social Networking Application Proxy Administration Service Alterar a porta de escuta do BlackBerry Social Networking Application Proxy Habilitar o BlackBerry Social Networking Application Proxy para uso com um servidor proxy para relatar informações de uso Configurar cabeçalhos HTTP Exibir relatórios de estatística para o BlackBerry Social Networking Application Proxy Exibir relatórios de estatística para o BlackBerry Social Networking Application Proxy Alterar o tamanho máximo dos arquivos que os usuários baixam do servidor IBM Lotus Quickr Alterar o tamanho máximo dos arquivos que os usuários carregam no servidor IBM Lotus Quickr Alterar a mensagem de enviada pelos usuários para distribuir o BlackBerry Client para IBM Lotus Quickr Alterar o mapeamento para servidores IBM Lotus Quickr Impedir que os usuários distribuam o BlackBerry Client para IBM Lotus Quickr Configurar o registro em log para o BlackBerry Social Networking Application Proxy Configurando o log do sistema Configurando o registro em log de controle de API Solução de problemas O BlackBerry Social Networking Application Proxy não está em execução A página CXF Service List (Lista de serviços de CXF) não é exibida O download do BlackBerry Client para IBM Lotus Quickr falha e apresenta erro HTTP Fornecer comentários Aviso legal... 33

5 Visão geral Visão geral 1 O BlackBerry Social Networking Application Proxy é o gateway entre os dispositivos BlackBerry e os softwares de colaboração de equipe, como o IBM Lotus Quickr. O BlackBerry Social Networking Application Proxy comunica-se com o software de colaboração de equipe usando APIs exclusivas ao software em questão. O BlackBerry Social Networking Application Proxy foi projetado para otimizar os dados que o software de colaboração de equipe geralmente envia a dispositivos BlackBerry. A otimização ajuda a melhorar o tempo de resposta de aplicativos em execução em dispositivos BlackBerry. A instalação consiste nas seguintes etapas: Instalar o BlackBerry Social Networking Application Proxy. Importar definições de política de TI para o BlackBerry Enterprise Server. Permitir uma conexão confiável entre o BlackBerry Social Networking Application Proxy e o BlackBerry MDS Connection Service. Distribuir o BlackBerry Client para IBM Lotus Quickr aos dispositivos BlackBerry. Você pode executar o BlackBerry Social Networking Application Proxy em um servidor com outros aplicativos, mas talvez perceba um melhor desempenho se instalá-lo em um servidor dedicado que não execute outros aplicativos. Se necessário, você pode fazer as seguintes alterações na configuração do BlackBerry Social Networking Application Proxy: Alterar a senha padrão para o BlackBerry Social Networking Application Proxy Administration Service. Alterar a porta de escuta do BlackBerry Social Networking Application Proxy. Habilitar o BlackBerry Social Networking Application Proxy para uso com um servidor proxy a relatar informações de uso. Configurar cabeçalhos HTTP personalizados ou substituir cabeçalhos HTTP já existentes. Alterar o tamanho máximo dos arquivos que os usuários podem fazer download e upload no servidor IBM Lotus Quickr Modificar a mensagem de enviada pelos usuários para distribuir o BlackBerry Client para IBM Lotus Quickr. Alterar o número de conexões simultâneas do BlackBerry Social Networking Application Proxy ao servidor IBM Lotus Quickr. Alterar o mapeamento para o servidor IBM Lotus Quickr. Impedir que os usuários distribuam o BlackBerry Client para IBM Lotus Quickr. Configurar o log do sistema e o log de controle de API. Arquitetura: BlackBerry Social Networking Application Proxy e BlackBerry Client para IBM Lotus Quickr O BlackBerry Social Networking Application Proxy é parte de uma solução cliente/servidor que fornece acesso ao IBM Lotus Quickr em dispositivos BlackBerry. 3

6 Arquitetura: BlackBerry Social Networking Application Proxy e BlackBerry Client para IBM Lotus Quickr Componente BlackBerry Client para IBM Lotus Quickr BlackBerry Social Networking Application Proxy Servidor IBM Lotus Quickr Descrição O BlackBerry Client para IBM Lotus Quickr é o aplicativo que fornece acesso aos recursos de colaboração de equipe e compartilhamento de conteúdo do IBM Lotus Quickr a partir de dispositivos BlackBerry. O BlackBerry Client para IBM Lotus Quickr se comunica com o BlackBerry Social Networking Application Proxy usando o BlackBerry MDS Connection Service, que é executado no BlackBerry Enterprise Server. O BlackBerry Social Networking Application Proxy otimiza os dados enviados entre dispositivos BlackBerry e o servidor IBM Lotus Quickr. O BlackBerry Social Networking Application Proxy se comunica com o servidor IBM Lotus Quickr usando APIs específicas do IBM Lotus Quickr. O IBM Lotus Quickr é um software de colaboração de equipe e compartilhamento de conteúdo para organizações. O software é executado no servidor IBM Lotus Quickr. 4

7 Requisitos de sistema: BlackBerry Social Networking Application Proxy Requisitos de sistema: BlackBerry Social Networking Application Proxy 2 Item Requisito servidor Processador Intel dual core 2.40 GHz (ou superior) mínimo de 2 GB de RAM disponíveis servidor dedicado que não execute outros aplicativos talvez ajude a melhorar o desempenho o BlackBerry Social Networking Application Proxy e o servidor IBM Lotus Quickr devem estar localizados na mesma LAN para ajudar a melhorar o desempenho sistema operacional Windows Server 2003 (32 bits) ou Windows Server 2008 todos os service packs exigidos para o sistema operacional BlackBerry Enterprise Server BlackBerry Enterprise Server para Microsoft Exchange 4.1.6, 5.0 ou BlackBerry Enterprise Server para IBM Lotus Domino 4.1.6, 5.0 ou BlackBerry MDS Connection registrado com o BlackBerry Enterprise Server Service dispositivo BlackBerry smartphones BlackBerry Curve 8300, BlackBerry Curve 8310, BlackBerry Curve 8320 ou BlackBerry Curve 8330 com BlackBerry Device Software smartphone BlackBerry Curve 8350i com BlackBerry Device Software smartphone BlackBerry Curve 8520 com BlackBerry Device Software smartphone BlackBerry Curve 8530 com BlackBerry Device Software 5.0 smartphones BlackBerry 8800, BlackBerry 8820 ou BlackBerry 8830 World Edition com BlackBerry Device Software smartphone BlackBerry Curve 8900 com BlackBerry Device Software smartphone BlackBerry Bold 9000 com BlackBerry Device Software smartphone BlackBerry Storm 9500 com BlackBerry Device Software smartphones BlackBerry Storm e BlackBerry Storm com BlackBerry Device Software 5.0 smartphone BlackBerry Tour 9630 com BlackBerry Device Software smartphone BlackBerry Bold 9650 com BlackBerry Device Software 5.0 5

8 Requisitos de sistema: BlackBerry Social Networking Application Proxy Item Requisito IBM Lotus Quickr para J2EE smartphone BlackBerry Bold 9700 com BlackBerry Device Software 5.0 dispositivos BlackBerry compatíveis devem ser fornecidos no BlackBerry Enterprise Server versão 8.2 para IBM Lotus Domino com pacote de correção IBM 9 ( ) 6

9 Instalando o BlackBerry Social Networking Application Proxy Instalando o BlackBerry Social Networking Application Proxy 3 Pré-requisitos: instalando o BlackBerry Social Networking Application Proxy Antes de instalar o BlackBerry Social Networking Application Proxy, execute as seguintes ações: Obtenha o URL do IBM Lotus Quickr. Quando instala o BlackBerry Social Networking Application Proxy, você deve especificar o URL no seguinte formato: http(s)://<nome_do_servidor>:<porta> (por exemplo, lotusquickr.empresa.com:10038). É necessário ter permissão para criar um serviço para a conta de servidor que você usa quando instala o BlackBerry Social Networking Application Proxy. No ambiente do Windows Server 2008, sua permissão deve ser de Administrador. Instalar o BlackBerry Social Networking Application Proxy 1. Clique duas vezes no arquivo BlackBerry_Enterprise_Social_Software_for_IBM_Lotus_1.0.0.número_do_pacote.exe. 2. Na caixa de diálogo Escolher idioma de configuração, selecione o idioma que você deseja usar para a instalação. 3. Clique em OK. 4. Na tela País ou região, selecione o país onde você se encontra. 5. Clique em Avançar. 6. Na tela Contrato de licença, aceite o contrato de licença. 7. Clique em Avançar. 8. Na tela Informações do cliente, digite as informações exigidas. 9. Clique em Avançar. 10. Na tela Tipo de configuração, clique em Personalizada. 11. Clique em Avançar. 12. Na tela Configuração personalizada, expanda IBM Lotus Connections Proxy e clique em Este recurso não estará disponível. 13. Clique em Avançar. 14. Na tela de configuração do Social Networking Application Proxy, digite o URL do servidor IBM Lotus Quickr no campo URL do servidor. 15. Selecione J2EE ou Domino. 16. Clique em Avançar. 7

10 Atualizar o BlackBerry Social Networking Application Proxy para a versão Siga as instruções nas telas restantes. 18. Antes de clicar em Concluir na tela de conclusão do assistente InstallShield, anote o URL para download do cliente móvel e o URL do proxy referente ao BlackBerry Client para IBM Lotus Quickr. Você precisará do URL para download do cliente móvel para o usado para instruir os usuários a fazerem download do BlackBerry Client para IBM Lotus Quickr. Você precisará do URL do proxy quando configurar regras de política de TI ou quando o usuário iniciar o BlackBerry Client para IBM Lotus Quickr pela primeira vez e for solicitado a informar o endereço do servidor. Quando solicitado, o usuário deverá digitar o URL do proxy no campo de endereço do servidor. O programa de instalação instala o BlackBerry Social Networking Application Proxy e alguns outros arquivos necessários à distribuição do BlackBerry Client para IBM Lotus Quickr. Informações relacionadas Configurar regras de política de TI, 11 Distribuir o BlackBerry Client para IBM Lotus Quickr aos dispositivos BlackBerry a partir do BlackBerry Social Networking Application Proxy, 16 Instrua o usuário a especificar o endereço de servidor do BlackBerry Client para IBM Lotus Quickr, 9 Atualizar o BlackBerry Social Networking Application Proxy para a versão Se você tiver uma versão anterior do BlackBerry Social Networking Application Proxy instalada, execute as seguintes ações para atualizar para a versão Encerre o BlackBerry Social Networking Application Proxy executando as seguintes ações: a. Abra o Windows Services. b. Clique com o botão direito do mouse em BlackBerry SNAP Service. c. Clique em Parar. 2. Copie o arquivo tomcat.jks para um diretório temporário. O arquivo está no diretório padrão C:\Program Files\Research In Motion\BlackBerry\SNAP\snap_tomcat\conf\. 3. Remova a versão anterior do BlackBerry Social Networking Application Proxy clicando em Iniciar > Todos os programas > Research In Motion > BlackBerry Social Networking Application Proxy > Desinstalar BlackBerry Social Networking Application Proxy. 4. Instalar o BlackBerry Social Networking Application Proxy versão Copie o arquivo tomcat.jks do diretório temporário para o diretório padrão C:\Program Files\Research In Motion\BlackBerry \SNAP\snap_tomcat\conf\. 6. Inicie o BlackBerry Social Networking Application Proxy executando as seguintes ações: a. Abra o Windows Services. b. Selecione BlackBerry SNAP Service. 8

11 Tarefas pós-instalação c. Clique no ícone Reiniciar serviço. Informações relacionadas Instalar o BlackBerry Social Networking Application Proxy, 7 Tarefas pós-instalação Verificar se o BlackBerry Social Networking Application Proxy está em execução Depois de instalar o BlackBerry Social Networking Application Proxy, você pode verificar se ele está em execução. 1. No BlackBerry Browser, em um dispositivo BlackBerry, digite services. A página Lista de serviços de CXF é exibida se o BlackBerry Social Networking Application Proxy estiver em execução, e o dispositivo BlackBerry poderá se comunicar com o BlackBerry Social Networking Application Proxy. 2. Em um navegador da Web, digite o seguinte URL: Se o BlackBerry Social Networking Application Proxy estiver em execução, o navegador da Web exibirá o BlackBerry Social Networking Application Proxy Administration Service. Informações relacionadas O BlackBerry Social Networking Application Proxy não está em execução, 30 A página CXF Service List (Lista de serviços de CXF) não é exibida, 30 Instrua o usuário a especificar o endereço de servidor do BlackBerry Client para IBM Lotus Quickr Se você não importar nem configurar as definições de política de TI para o BlackBerry Social Networking Application Proxy, o usuário será solicitado a informar o endereço do servidor quando executar o BlackBerry Client para IBM Lotus Quickr. Instrua o usuário a digitar o URL do proxy que você registrou na última etapa, quando instalou o BlackBerry Social Networking Application Proxy. O URL do proxy tem o seguinte formato: services. Informações relacionadas Instalar o BlackBerry Social Networking Application Proxy, 7 Importando definições de política de TI para o BlackBerry Enterprise Server, 10 9

12 Importando definições de política de TI para o BlackBerry Enterprise Server Importando definições de política de TI para o BlackBerry Enterprise Server 4 Para importar definições de política de TI para o BlackBerry Enterprise Server, você deve usar a ferramenta loadbesmetadata.exe, o BlackBerry Manager ou o BlackBerry Administration Service. Depois de importar as definições de política de TI, você deve configurar as regras de política de TI usando o BlackBerry Administration Service. Importar definições de política de TI usando a ferramenta loadbesmetadata.exe Para obter mais informações sobre a ferramenta loadbesmetadata.exe, visite searchentry.do e leia o artigo KB CUIDADO: Não altere o arquivo de definições de política de TI que você importa para o BlackBerry Enterprise Server. Se você importar um arquivo modificado, o BlackBerry Enterprise Server talvez não funcione corretamente. 1. Baixe o arquivo ITPolicyTemplateQuickr.zip da pasta ITPolicy para uma pasta temporária no computador que hospeda o BlackBerry Manager. O local padrão da pasta ITPolicy é C:\Program Files\Research In Motion\BlackBerry\SNAP \ITPolicy. 2. Abra o arquivo ITPolicyTemplateQuickr.zip na pasta temporária. 3. No prompt de comando, navegue até a pasta temporária. 4. Na pasta temporária, digite loadbesmetadata.exe -i itpolicytemplatequickrapp.xml 5. Quando a ferramenta loadbesmetadata.exe concluir sua execução, verifique a saída da tela e o log da pasta para ver se houve erros. Quando terminar: Configure as regras de política de TI. Importar definições de política de TI usando o BlackBerry Manager CUIDADO: Não altere o arquivo de definições de política de TI que você importa para o BlackBerry Enterprise Server. Se você importar um arquivo modificado, o BlackBerry Enterprise Server talvez não funcione corretamente. 1. Baixe o arquivo ITPolicyTemplateQuickr.zip da pasta ITPolicy para uma pasta temporária no computador que hospeda o BlackBerry Manager. O local padrão da pasta ITPolicy é C:\Program Files\Research In Motion\BlackBerry\SNAP\Tools \ITPolicy. 2. Abra o arquivo ITPolicyTemplateQuickr.zip na pasta temporária. 3. No BlackBerry Manager, no painel esquerdo, clique em BlackBerry Domain. 4. Na guia Global, na lista Tarefas, clique em Controle e personalização de serviços. 10

13 Importar definições de política de TI usando o BlackBerry Administration Service 5. Clique em Importar definições de política de TI. 6. Na caixa de diálogo Abrir arquivo, navegue até a pasta temporária em que você descompactou o arquivo ITPolicyTemplateQuickr.zip. 7. Clique no arquivo ITPolicyTemplateQuickrApp.xml. 8. Clique em Abrir para importar as definições de política de TI. Quando o processo de importação estiver completo, a seguinte mensagem será exibida: A importação das definições desta regra de política de TI foi realizada com êxito. Ocorreram 3 adições e 0 atualizações. Quando terminar: Configure as regras de política de TI. Importar definições de política de TI usando o BlackBerry Administration Service CUIDADO: Não altere o arquivo de definições de política de TI que você importar para o BlackBerry Enterprise Server. Se você importar um arquivo modificado, o BlackBerry Enterprise Server talvez não funcione corretamente. 1. Baixe o arquivo ITPolicyTemplateQuickr.zip da pasta ITPolicy para uma pasta temporária no computador que hospeda o BlackBerry Administration Service. O local padrão da pasta ITPolicy é C:\Program Files\Research In Motion\BlackBerry \SNAP\ITPolicy. 2. Abra o arquivo ITPolicyTemplateQuickr.zip na pasta temporária. 3. No BlackBerry Administration Service, no menu Gerenciamento da BlackBerry Solution, expanda Política. 4. Clique em Gerenciar regras de política de TI. 5. Clique em Importar definições de política de TI. 6. Na seção Importação da definição de política de TI, navegue até a pasta temporária em que você descompactou o arquivo ITPolicyTemplateQuickr.zip. 7. Clique no arquivo ITPolicyTemplateQuickr.xml. 8. Clique em Salvar. Quando terminar: Configure as regras de política de TI. Configurar regras de política de TI Depois de importar as definições de política de TI, você deve configurar as regras de política de TI usando o BlackBerry Administration Service. Para obter mais informações sobre como configurar as regras da política de TI, consulte o Guia de administração do BlackBerry Enterprise Server. Para ver descrições das regras de política de TI, consulte o Guia de referência de políticas do BlackBerry Enterprise Server para BlackBerry Enterprise Server versão 5.0 SP1. 1. Inicie o BlackBerry Administration Service. 11

14 Configurar regras de política de TI 2. Configure as seguintes regras de política de TI a partir do grupo de políticas Aplicativos de valor agregado da RIM. Permitir edições no URL do BlackBerry Social Networking Application Proxy para Lotus Quickr URL do BlackBerry Social Networking Application Proxy para Lotus Quickr Habilitar o recurso "Indicar a um amigo" no BlackBerry Client para Lotus Quickr 3. Para a regra de política de TI Desabilitar aplicativos de valor agregado da RIM, defina o valor em Não. 12

15 Permitir uma conexão confiável Permitir uma conexão confiável 5 Você deve permitir uma conexão confiável entre o BlackBerry Social Networking Application Proxy e o BlackBerry MDS Connection Service. Para permitir uma conexão confiável entre estes servidores, você deve adicionar um certificado ao BlackBerry MDS Connection Service. O certificado permite que o serviço aceite conexões HTTPS. O BlackBerry Social Networking Application Proxy oferece suporte a certificados assinados e auto-assinados, portanto você não precisa adicionar o certificado do IBM Lotus Quickr ao BlackBerry Social Networking Application Proxy. Permitir uma conexão confiável entre o BlackBerry Social Networking Application Proxy e o BlackBerry MDS Connection Service Para habilitar a conexão HTTPS entre o BlackBerry Social Networking Application Proxy e o BlackBerry MDS Connection Service, você deve criar um certificado para o BlackBerry Social Networking Application Proxy usando o keytool Java, exportar o certificado para um arquivo e então importar o certificado para o BlackBerry MDS Connection Service. Para obter mais informações sobre o uso do keytool Java, visite Antes de começar: Atualize a variável de ambiente do caminho para o computador no qual você instalou o BlackBerry Social Networking Application Proxy para incluir o local do keytool Java. O keytool Java está localizado na pasta C:\Program Files\Java \<versão_jre>\bin. Depois de atualizar a variável de caminho, verifique se o keytool Java é executado. No prompt de comando, digite keytool. Você também usará o keytool Java no computador que hospeda o BlackBerry MDS Connection Service. A variável de ambiente do caminho nesse computador deve incluir o local do keytool Java. 1. Crie um certificado para o BlackBerry Social Networking Application Proxy e adicione-o ao armazenamento de chaves executando as seguintes ações: a. No prompt de comando, digite cd C:\Program Files\Research In Motion\BlackBerry\SNAP\snap_tomcat\conf. b. No prompt de comando, digite keytool genkey alias <alias_de_seu_certificado> validity 365 keyalg RSA keystore tomcat.jks storepass tomcat. Não use snap como alias de certificado. c. Digite as informações de certificado solicitadas. Quando você for solicitado a informar seu First name (Nome) e Last name (Sobrenome), digite o nome totalmente qualificado do servidor. Em Password (Senha), digita tomcat. A senha para as chaves e para o armazenamento de chaves deve ser a mesma. 2. Para ter a certeza de que o certificado foi criado com êxito, no prompt de comando digite keytool list keystore tomcat.jks storepass tomcat e reveja as informações sobre o certificado. 3. Altere o arquivo server.xml para que ele contenha uma referência ao alias de certificado, executando as seguintes ações: a. Abra o arquivo server.xml usando um editor de texto. A pasta padrão é C:\Program Files\Research In Motion \BlackBerry\SNAP\snap_tomcat\conf. 13

16 Permitir uma conexão confiável entre o BlackBerry Social Networking Application Proxy e o BlackBerry MDS Connection Service b. Altere keyalias=snap para keyalias=<alias_de_seu_certificado>. O alias de certificado é aquele que você criou na etapa 1b. c. Salve as alterações feitas no arquivo server.xml. 4. Reinicie o BlackBerry Social Networking Application Proxy executando uma das seguintes ações: a. Abra o Windows Services. b. Clique com o botão direito do mouse em BlackBerry SNAP Service. c. Clique em Stop (Parar). d. Clique em Start (Iniciar). 5. Verifique se o BlackBerry Social Networking Application Proxy está configurado para aceitar o certificado, executando as seguintes ações: a. No computador que hospeda o BlackBerry MDS Connection Service, abra um navegador da Web. b. No campo Endereço, digite ou endereço_ip>:22443/snapconsole. c. Na caixa de diálogo Alerta de segurança, clique em View Certificate (Exibir certificado). d. Na caixa de diálogo Certificado, examine as informações sobre o certificado para ter a certeza de que correspondem ao certificado que você criou nas etapas 1 a Exporte o certificado para um arquivo.cer, executando as seguintes ações: a. Na caixa de diálogo Certificate (Certificado), na guia Details (Detalhes), clique em Copy to File (Copiar para arquivo). b. No assistente para exportação de certificados, clique em Next (Avançar). c. Na tela Formato do arquivo de exportação, clique em DER encoded binary X.509(.CER). d. Clique em Next (Avançar). e. Na caixa de diálogo Salvar como, clique em Browse (Procurar) e selecione a pasta e o nome do arquivo para o certificado que você deseja exportar. f. Clique em Save (Salvar). g. Clique em Finish (Concluir). h. Clique em OK duas vezes. 7. Exporte o certificado para o BlackBerry MDS Connection Service executando as seguintes ações: a. No computador que hospeda o BlackBerry MDS Connection Service, copie o arquivo.cer para <unidade>:\program Files\Java\<versão_JRE>\lib\security. b. No prompt de comando, navegue até <unidade>:\program Files\Java\<versão_JRE>\lib\security. c. Digite keytool -import -trustcacerts -alias <alias_de_seu_certificado> -file <nome_do_arquivo_cert> - keystore cacerts. d. Digite a senha do armazenamento de chaves. A senha padrão é changeit. e. Para adicionar o certificado ao armazenamento de chaves, no prompt de comando, digite Yes. 8. Reinicie o BlackBerry MDS Connection Service. 14

17 Permitir uma conexão confiável entre o BlackBerry Social Networking Application Proxy e o BlackBerry MDS Connection Service Informações relacionadas O download do BlackBerry Client para IBM Lotus Quickr falha e apresenta erro HTTP 500, 30 Determinar a versão do JRE usada pelo BlackBerry MDS Connection Service 1. Abra o Windows Services no computador que hospeda o BlackBerry MDS Connection Service. 2. Clique com o botão direito do mouse em BlackBerry MDS Connection Service. 3. Clique em Properties (Propriedades). 4. Na caixa de diálogo Propriedades, copie o conteúdo do campo Path to executable (Caminho para executável) para um editor de texto. 5. No caminho que você copiou, procure a versão do JRE no parâmetro jvmpath. Por exemplo: jvmpath="c:\program Files \Java\jre1.6.0_02\bin\client\jvm.dll". Quando terminar: Use a versão do JRE especificada no parâmetro jvmpath quando importar o certificado do BlackBerry Social Networking Application Proxy para o BlackBerry MDS Connection Service. 15

18 Distribuindo o BlackBerry Client para IBM Lotus Quickr a dispositivos BlackBerry Distribuindo o BlackBerry Client para IBM Lotus Quickr a dispositivos BlackBerry 6 Você pode distribuir o BlackBerry Client para IBM Lotus Quickr a dispositivos BlackBerry a partir do BlackBerry Social Networking Application Proxy ou do BlackBerry Enterprise Server. Distribuir o BlackBerry Client para IBM Lotus Quickr aos dispositivos BlackBerry a partir do BlackBerry Social Networking Application Proxy Para distribuir o BlackBerry Client para IBM Lotus Quickr a dispositivos BlackBerry, você pode enviar um aos usuários da organização com o URL para download do cliente móvel. Este URL é aquele que você registrou na última etapa, quando instalou o BlackBerry Social Networking Application Proxy. 1. Componha um que instrua os usuários a fazerem download do BlackBerry Client para IBM Lotus Quickr. Inclua no o URL para download do cliente móvel (por exemplo, 2. Envie a mensagem de . Informações relacionadas Instalar o BlackBerry Social Networking Application Proxy, 7 Distribuir o BlackBerry Client para IBM Lotus Quickr aos dispositivos BlackBerry a partir do BlackBerry Enterprise Server versão Você pode distribuir o BlackBerry Client para IBM Lotus Quickr a dispositivos BlackBerry a partir do BlackBerry Enterprise Server. Para isso, execute as seguintes ações. Para obter mais informações sobre como distribuir o BlackBerry Client para IBM Lotus Quickr, consulte o BlackBerry Enterpise Server Administration Guide (Guia de administração do BlackBerry Enterprise Server). Compartilhe uma unidade de rede para aplicativos. Crie um índice de software para aplicativos em uma unidade de rede. Crie uma configuração de software. Crie um grupo de usuários. Adicione uma conta de usuário a um grupo. Atribua a configuração de software a um grupo de usuários. Se o BlackBerry Enterprise Server estiver configurado para enviar aplicativos em intervalos regulares, o BlackBerry Client para IBM Lotus Quickr será enviado aos dispositivos BlackBerry no próximo intervalo. Opcionalmente, você pode instalar o BlackBerry Client para IBM Lotus Quickr imediatamente nos dispositivos BlackBerry em um grupo de usuários. Informações relacionadas 16

19 Distribuir o BlackBerry Client para IBM Lotus Quickr aos dispositivos BlackBerry a partir do BlackBerry Enterprise Server versão Criar um índice de software para aplicativos em uma unidade de rede, 17 Instalar o BlackBerry Client para IBM Lotus Quickr imediatamente nos dispositivos BlackBerry em um grupo de usuários, 17 Criar um índice de software para aplicativos em uma unidade de rede 1. No BlackBerry Social Networking Application Proxy, execute as seguintes ações: a. Navegue até a pasta <pasta_de_instalação_de_servidor_snap>\snap\snap_tomcat\webapps\root\qkrclient. b. Copie o arquivo LotusQuickr.zip para a pasta de rede compartilhada no BlackBerry Enterprise Server. 2. No BlackBerry Enterprise Server, execute as seguintes ações: a. Extraia o arquivo LotusQuickr.zip na pasta C:\Program Files\Common Files\Research In Motion\Shared \Applications. A pasta LotusQuickr é criada como uma subpasta em Aplicativos, e o conteúdo do arquivo LotusQuickr.zip é copiado para a pasta LotusQuickr. b. No prompt de comando, digite cd C:\Program Files\Common Files\Research In Motion\AppLoader. c. No prompt de comando, digite loader.exe/index. Os arquivos PkgDBCache.xml e specification.pkg são criados na pasta LotusQuickr. O BlackBerry Enterprise Server usa estes arquivos quando você instala o BlackBerry Client para IBM Lotus Quickr. Instalar o BlackBerry Client para IBM Lotus Quickr imediatamente nos dispositivos BlackBerry em um grupo de usuários Se você não deseja enviar o BlackBerry Client para IBM Lotus Quickr do BlackBerry Enterprise Server aos dispositivos BlackBerry no próximo intervalo programado, poderá instalar o BlackBerry Client para IBM Lotus Quickr imediatamente. 1. No BlackBerry Manager, no painel esquerdo, clique em um grupo de usuários. 2. No painel direito, expanda Admin de TI. 3. Clique em Implantar aplicativos. O BlackBerry Client para IBM Lotus Quickr é enviado imediatamente aos dispositivos BlackBerry do grupo de usuários 4. Para verificar se o BlackBerry Client para IBM Lotus Quickr foi instalado corretamente, execute as seguintes ações em um dispositivo BlackBerry no grupo de usuários: a. Na tela inicial, verifique se o ícone do BlackBerry Client para IBM Lotus Quickr é exibido. b. Clique em Opções > Opções avançadas> Aplicativos. c. Verifique se BlackBerry Client para IBM Lotus Quickr é exibido na lista. 17

20 Distribuir o BlackBerry Client para IBM Lotus Quickr aos dispositivos BlackBerry a partir do BlackBerry Enterprise Server versão 5.0 Distribuir o BlackBerry Client para IBM Lotus Quickr aos dispositivos BlackBerry a partir do BlackBerry Enterprise Server versão 5.0 Você pode distribuir um BlackBerry Java Application, como o BlackBerry Client para IBM Lotus Quickr, a dispositivos BlackBerry a partir do BlackBerry Enterprise Server. Para isso, execute as seguintes ações. Para obter mais informações sobre distribuição de um BlackBerry Java Application a partir do BlackBerry Enterprise Server, consulte o BlackBerry Enterpise Server Administration Guide (Guia de administração do BlackBerry Enterprise Server). Especifique uma pasta de rede compartilhada para BlackBerry Java Applications. Adicione um BlackBerry Java Application ao repositório do aplicativo. O BlackBerry Client para IBM Lotus Quickr encontrase no arquivo LotusConnections.zip, na pasta padrão <pasta_do_servidor_snap>\snap_tomcat\webapps\root \qkrclient. Crie uma configuração de software. Adicione um BlackBerry Java Application a uma configuração de software. Adicione contas de usuário a um grupo. Atribua uma configuração de software a um grupo. O BlackBerry Administration Service cria um trabalho para entregar o BlackBerry Java Application aos dispositivos BlackBerry no grupo. Para gerenciar as configurações de distribuição padrão para trabalhos, consulte o BlackBerry Enterprise Server Administration Guide (Guia de administração do BlackBerry Enterprise Server). 18

21 Configurando o BlackBerry Social Networking Application Proxy Configurando o BlackBerry Social Networking Application Proxy 7 Alterar a senha padrão para o BlackBerry Social Networking Application Proxy Administration Service A senha padrão para o BlackBerry Social Networking Application Proxy Administration Service é SNAPpsw. Você pode trocar a senha padrão para outra que seja mais conveniente à sua organização. 1. Abra o arquivo tomcat-users.xml usando um editor de texto. O local padrão do arquivo é C:\Program Files\Research In Motion\BlackBerry\SNAP\snap_tomcat\conf. 2. Altere a senha de SNAPpsw para aquela que você deseja usar. 3. Salve a alteração feita no arquivo. 4. Reinicie o BlackBerry Social Networking Application Proxy para que a alteração que você fez entre em vigor, executando as seguintes ações: a. Abra o Windows Services. b. Selecione BlackBerry SNAP Service. c. Clique no ícone Restart Service (Reiniciar serviço). Alterar a porta de escuta do BlackBerry Social Networking Application Proxy O BlackBerry Social Networking Application Proxy se comunica com o BlackBerry Client para IBM Lotus Quickr por uma porta usando HTTPS. O valor padrão para a porta é Você pode alterar o valor padrão da porta. O novo valor pode ir de 1025 a e não pode ser usado por outro aplicativo. 1. Abra o BlackBerry Social Networking Application Proxy Administration Service digitando o seguinte URL em um navegador da Web: 2. Clique em HTTPS Port (Porta HTTPS). 3. No painel de configuração de porta, altere o valor padrão conforme necessário. 4. Clique em Test Port (Testar porta) para ter a certeza de que o novo valor é adequado. 5. Clique em Submit Changes (Enviar alterações). 6. Reinicie o BlackBerry Social Networking Application Proxy para que a alteração que você fez entre em vigor, executando as seguintes ações: a. Abra o Windows Services. b. Selecione BlackBerry SNAP Service. 19

22 Habilitar o BlackBerry Social Networking Application Proxy para uso com um servidor proxy para relatar informações de uso c. Clique no ícone Restart Service (Reiniciar serviço). Habilitar o BlackBerry Social Networking Application Proxy para uso com um servidor proxy para relatar informações de uso Se sua organização usa um servidor proxy para acessar a Internet, você deve especificar os valores para o servidor proxy. O BlackBerry Social Networking Application Proxy usa o servidor proxy para acessar a Internet e relatar informações de uso. 1. Abra o BlackBerry Social Networking Application Proxy Administration Service digitando o seguinte URL em um navegador da Web: 2. Clique em Report Stats Proxy (Relatório de estatísticas de proxy). 3. No painel de configuração de proxy, digite os valores do servidor proxy. 4. Clique em Submit Changes (Enviar alterações). 5. Reinicie o BlackBerry Social Networking Application Proxy para que a alteração que você fez entre em vigor, executando as seguintes ações: a. Abra o Windows Services. b. Selecione BlackBerry SNAP Service. c. Clique no ícone Restart Service (Reiniciar serviço). Configurar cabeçalhos HTTP Os cabeçalhos HTTP definem várias características sobre o servidor BlackBerry Social Networking Application Proxy ou sobre os dados que são enviados ao servidor IBM Lotus Quickr. Dependendo das necessidades da sua organização, você pode definir cabeçalhos HTTP personalizados ou sobrescrever cabeçalhos HTTP existentes que o BlackBerry Social Networking Application Proxy envia ao servidor IBM Lotus Quickr. Os cabeçalhos HTTP e valores de HTTP que você especifica são estáticos (fixos) e substituem os cabeçalhos HTTP com o mesmo rótulo, que são enviados pelo BlackBerry Client para IBM Lotus Quickr ou pelo BlackBerry MDS Connection Service. 1. Abra o BlackBerry Social Networking Application Proxy Administration Service digitando o seguinte URL em um navegador da Web: 2. Clique em Static HTTP Headers (Cabeçalhos HTTP estáticos). 3. No painel de configuração de cabeçalhos HTTP estáticos, digite os valores para seus cabeçalhos HTTP personalizados ou para os cabeçalhos HTTP que você deseja substituir. 4. Clique em Submit (Enviar). 5. Reinicie o BlackBerry Social Networking Application Proxy para que as alterações que você fez entrem em vigor, executando as seguintes ações: a. Abra o Windows Services. 20

23 Exibir relatórios de estatística para o BlackBerry Social Networking Application Proxy b. Selecione BlackBerry SNAP Service. c. Clique no ícone Restart Service (Reiniciar serviço). Exibir relatórios de estatística para o BlackBerry Social Networking Application Proxy O BlackBerry Social Networking Application Proxy captura dados de utilização para cada solicitação feita pelo BlackBerry Client para IBM Lotus Quickr. Os dados de utilização são armazenados diariamente em arquivos denominados qkr-rawstats.<aaaa-mm-dd>.dat. Uma vez ao mês, os arquivos de dados de utilização são agregados, e são gerados dois arquivos de relatório: qkr-agg-stats-pin-<aaaa-mm-dd>.dat e qkr-agg-stats-api-<aaaa-mm-dd>.dat. O BlackBerry Social Networking Application Proxy armazena os arquivos de dados de utilização e os arquivos de relatório na pasta de estatística. O local padrão é C:\Program Files\Research In Motion\BlackBerry\SNAP\snap_tomcat\stats. Quando os arquivos de relatório são gerados, o processo de agregação remove os arquivos de dados de utilização que são gerados diariamente. Você não deve modificar nem excluir os arquivos de relatório. Você pode usar o BlackBerry Social Networking Application Proxy Administration Service para ver os seguintes tipos de relatórios: Atividades de PIN: Este relatório exibe o número de solicitações recebidas por cada dispositivo BlackBerry que executa o BlackBerry Client para IBM Lotus Quickr. O relatório lista cada dispositivo BlackBerry usando seu PIN. Número de PINs: Este relatório exibe o número de solicitações recebidas por cada dispositivo BlackBerry que executa o BlackBerry Client para IBM Lotus Quickr. Os relatórios listam cada dispositivo BlackBerry usando seu PIN. Atividades de API: Este relatório exibe o número de solicitações recebidas por cada API do BlackBerry Social Networking Application Proxy. Exibir relatórios de estatística para o BlackBerry Social Networking Application Proxy 1. Abra o BlackBerry Social Networking Application Proxy Administration Service digitando o seguinte URL em um navegador da Web: 2. Em IBM Lotus Quickr, clique em Reports (Relatórios). 3. No painel Exibir relatórios, clique no tipo de relatório e no mês que você deseja ver. 4. Clique em Get Report (Obter relatório). 21

24 Alterar o tamanho máximo dos arquivos que os usuários baixam do servidor IBM Lotus Quickr Alterar o tamanho máximo dos arquivos que os usuários baixam do servidor IBM Lotus Quickr Você pode especificar o tamanho dos arquivos que os usuários podem baixar do servidor IBM Lotus Quickr para seus dispositivos BlackBerry. Os arquivos podem ter, no máximo, 5 MB. 1. Abra o BlackBerry Social Networking Application Proxy Administration Service digitando o seguinte URL em um navegador da Web: 2. Em IBM Lotus Quickr, expanda Gerenciamento de propriedades. 3. Clique em Visão geral das propriedades. 4. Clique em filedownloadservice.maxallowedfilesizeinbytes. 5. No painel de atualização de propriedades, digite o tamanho máximo de arquivo. 6. Clique em Enviar alterações. 7. Reinicie o BlackBerry Social Networking Application Proxy para que as alterações que você fez entrem em vigor, executando as seguintes ações: a. Abra o Windows Services. b. Selecione BlackBerry SNAP Service. c. Clique no ícone Reiniciar serviço. As alterações entrarão em vigor no BlackBerry Client para IBM Lotus Quickr na próxima vez que o usuário efetuar login. Alterar o tamanho máximo dos arquivos que os usuários carregam no servidor IBM Lotus Quickr Você pode especificar o tamanho dos arquivos que os usuários podem carregar de seus dispositivos BlackBerry no servidor IBM Lotus Quickr. Os arquivos podem ter, no máximo, 5 MB. 1. Abra o BlackBerry Social Networking Application Proxy Administration Service digitando o seguinte URL em um navegador da Web: 2. Em IBM Lotus Quickr, expanda Gerenciamento de propriedades. 3. Clique em Visão geral das propriedades. 4. Clique em fileuploadservice.maxallowedfilesizeinbytes. 5. No painel de atualização de propriedades, digite o tamanho máximo de arquivo. 6. Clique em Enviar alterações. 22

25 Alterar a mensagem de enviada pelos usuários para distribuir o BlackBerry Client para IBM Lotus Quickr 7. Reinicie o BlackBerry Social Networking Application Proxy para que as alterações que você fez entrem em vigor, executando as seguintes ações: a. Abra o Windows Services. b. Selecione BlackBerry SNAP Service. c. Clique no ícone Reiniciar serviço. As alterações entrarão em vigor no BlackBerry Client para IBM Lotus Quickr na próxima vez que o usuário efetuar login. Alterar a mensagem de enviada pelos usuários para distribuir o BlackBerry Client para IBM Lotus Quickr Os usuários de dispositivos BlackBerry podem distribuir o BlackBerry Client para IBM Lotus Quickr a outras pessoas enviando um . Para enviar o , os usuários devem clicar em Tell A Friend (Indicar a um amigo) no BlackBerry Client para IBM Lotus Quickr. A mensagem de contém um link a partir do qual os usuários podem fazer download do BlackBerry Client para IBM Lotus Quickr em um dispositivo BlackBerry que ofereça suporte. Você pode alterar a linha de assunto e o texto padrão do Abra o BlackBerry Social Networking Application Proxy Administration Service digitando o seguinte URL em um navegador da Web: 2. Em IBM Lotus Quickr, expanda Properties Management (Gerenciamento de propriedades). 3. Clique em Properties Overview (Visão geral das propriedades). 4. Clique em invitesubject. 5. No painel de atualização de propriedades, altere o texto da linha de assunto do Clique em Submit Changes (Enviar alterações). 7. No painel de atualização de propriedades, expanda a lista suspensa. 8. Clique em invitetext. 9. Altere o texto do corpo do Clique em Submit Changes (Enviar alterações). O link para download do BlackBerry Client para IBM Lotus Quickr é anexado automaticamente ao fim do Reinicie o BlackBerry Social Networking Application Proxy para que as alterações que você fez entrem em vigor, executando as seguintes ações: a. Abra o Windows Services. b. Selecione BlackBerry SNAP Service. c. Clique no ícone Restart Service (Reiniciar serviço). As alterações serão exibidas no BlackBerry Client para IBM Lotus Quickr na próxima vez que o usuário efetuar login. 23

26 Alterar o mapeamento para servidores IBM Lotus Quickr Informações relacionadas Requisitos de sistema: BlackBerry Social Networking Application Proxy, 5 Alterar o mapeamento para servidores IBM Lotus Quickr Durante a instalação do BlackBerry Social Networking Application Proxy, você especifica o URL do servidor IBM Lotus Quickr. Se o local do servidor IBM Lotus Quickr for alterado depois que você instalar o BlackBerry Social Networking Application Proxy, poderá alterar o URL. 1. Abra o BlackBerry Social Networking Application Proxy Administration Service digitando o seguinte URL em um navegador da Web: 2. Em IBM Lotus Quickr, expanda Properties Management (Gerenciamento de propriedades). 3. Clique em Properties Overview (Visão geral das propriedades). 4. Clique em quickrurl. 5. No painel de atualização de propriedades, digite o URL do servidor IBM Lotus Quickr. 6. Clique em Submit Changes (Enviar alterações). 7. Reinicie o BlackBerry Social Networking Application Proxy para que as alterações que você fez entrem em vigor, executando as seguintes ações: a. Abra o Windows Services. b. Selecione BlackBerry SNAP Service. c. Clique no ícone Restart Service (Reiniciar serviço). Informações relacionadas Pré-requisitos: instalando o BlackBerry Social Networking Application Proxy, 7 Impedir que os usuários distribuam o BlackBerry Client para IBM Lotus Quickr Você pode impedir que os usuários de dispositivos BlackBerry distribuam o BlackBerry Client para IBM Lotus Quickr a outras pessoas enviando um . A mensagem de contém um link a partir do qual os usuários podem fazer download do BlackBerry Client para IBM Lotus Quickr em um dispositivo BlackBerry. 1. Abra o BlackBerry Social Networking Application Proxy Administration Service digitando o seguinte URL em um navegador da Web: 2. Em IBM Lotus Quickr, expanda Properties Management (Gerenciamento de propriedades). 3. Clique em Client Distribution (Distribuição de cliente). 4. No painel de distribuição de cliente, clique Disable (Desabilitar). 5. Clique em Submit Changes (Enviar alterações). 24

27 Configurar o registro em log para o BlackBerry Social Networking Application Proxy 6. Reinicie o BlackBerry Social Networking Application Proxy para que as alterações que você fez entrem em vigor, executando as seguintes ações: a. Abra o Windows Services. b. Selecione BlackBerry SNAP Service. c. Clique no ícone Restart Service (Reiniciar serviço). O item de menu Tell A Friend (Indicar a um amigo) é desativado no BlackBerry Client para IBM Lotus Quickr. Para remover o item de menu, no IBM Lotus Quickr modifique a política de TI que controla o item de menu. Para obter mais informações, consulte a documentação do IBM Lotus Quickr. Configurar o registro em log para o BlackBerry Social Networking Application Proxy O BlackBerry Social Networking Application Proxy foi projetado para oferecer suporte a registro em log configurável na estrutura de log do Apache log4j. A estrutura do log4j define como as instruções de log no código do aplicativo são controladas. Ao alterar certas propriedades e valores associados ao registro em log, você pode especificar o tipo de informação de log que é coletado e direcionar as informações de log a vários destinos de saída, como console, componentes de interface e arquivos. Para obter mais informações sobre o log4j, visite logging.apache.org/log4j/1.2/index.html. O BlackBerry Social Networking Application Proxy oferece suporte a log do sistema e log de controle de API. Você pode usar o log do sistema para registrar informações sobre as APIs para o BlackBerry Social Networking Application Proxy. Você pode usar o log de controle de API para registrar informações sobre o desempenho das APIs para o BlackBerry Social Networking Application Proxy. O BlackBerry Social Networking Application Proxy direciona as informações de log a um arquivo de saída. O local padrão do arquivo de saída é C:\Program Files\Research in Motion\BlackBerry\SNAP\snap_tomcat\logs. Configurando o log do sistema O BlackBerry Social Networking Application Proxy oferece suporte a vários loggers diferentes que controlam as informações registradas sobre as APIs para o BlackBerry Social Networking Application Proxy. As informações de log que os loggers geram é controlada pelo nível do log. Os loggers oferecem suporte a cinco níveis de log, que você pode alterar: depuração, informação, aviso, erro e fatal. Nome do logger qkr.net.rim Descrição registra todas as informações relacionadas à lógica comercial do BlackBerry Social Networking Application Proxy 25

28 Configurar o registro em log para o BlackBerry Social Networking Application Proxy Nome do logger org.apache.commons.httpclient net.rim org.apache.abdera org.apache.cxf org.springframework Descrição registra todas as informações que o cliente HTTP disponibiliza com base no nível de log. registra todas as informações que o BlackBerry Social Networking Application Proxy disponibiliza com base no nível de log. registra todas as informações que a biblioteca de software Apache Abdera disponibiliza com base no nível de log. registra todas as informações que a biblioteca de software Apache CXF disponibiliza com base no nível de log. registra todas as informações que a biblioteca de software Spring disponibiliza com base no nível de log. Alterar as propriedades de registro em log do sistema 1. Abra o BlackBerry Social Networking Application Proxy Administration Service digitando o seguinte URL em um navegador da Web: 2. Em Configuração comum, expanda Gerenciamento de log. 3. No painel Configurações de log do sistema, altere os valores das propriedades conforme o necessário. 4. Clique em Enviar alterações. 5. Reinicie o BlackBerry Social Networking Application Proxy para que a alteração que você fez entre em vigor, executando as seguintes ações: a. Abra o Windows Services. b. Selecione BlackBerry SNAP Service. c. Clique no ícone Reiniciar serviço. Propriedades de log do sistema Com o uso do BlackBerry Social Networking Application Proxy Administration Service, você pode alterar as seguintes propriedades de registro em log do sistema. Propriedade Índice máximo de backup Descrição O BlackBerry Social Networking Application Proxy gera arquivos de log do sistema diariamente e armazena-os em uma subpasta na pasta de logs. O nome da subpasta tem o formato AAAAMMDD. O nome corresponde à data em que o BlackBerry Social Networking Application Proxy cria a subpasta. 26