Oracle Universal Content Management – Instalação e Configuração


Autor: Denis Abrantes

Parte II – Instalação do Content Server

Nesta segunda etapa, iremos instalar o Content Server. Antes de prosseguir neste exercício, confirme que você seguiu as etapas da Parte I, para definir os pré-requisitos da instalação.

Passo 6 – Instalação do Content Server.

  • Agora podemos iniciar a instalação do Content Server:
    • Abra um prompt de comando na pasta C:\oracle\inst\CS\UCM\ContentServer\win32
    • Inicie a instalação com o comando installer
  • Selecione as seguintes opções:
    • Locale: 4 (US english)
    • Install Type: 1 (new server)
    • Path: c:\oracle\ecm\ucm
    • Create: 1 (Yes)
    • Virtual Machine: 1 (java 1.5.0)
    • Pasta vault: c:\oracle\ecm\ucm\vault
    • Create: 1 (Yes)
    • Pasta weblayout: c:\oracle\ecm\ucm\weblayout
    • Create: 1 (Yes)
    • Configure as Master Server (1)
    • Install Admin Server to Manage (1)
    • Browser Location: c:/program files/internet explorer/iexplore.exe
    • System Locale: 4 (US English)
    • Region: (America)
    • Timezone: 107 (São Paulo)
    • Content Server Port: 4444
    • Admin Server Port: 4440
    • Security Filter: 127.0.0.1|10.1.1.10
    • URL Prefix: /ucm/
    • Email: mail
    • Admin Email: sysadmin@mail
    • Web Server Address: oracle-ucm.br.oracle.com
    • Instance Name: ucm
    • Instance Label: ucm
    • Server Description: Content Server ucm
    • Web Server: Apache (2)
    • Database: Oracle (1)
    • Manually Configure JDBC: No (2)
    • Oracle Server Hostname: oracle-ucm.br.oracle.com
    • Listener Port: 1521
    • Oracle User: ucm
    • Oracle Password: welcome1
    • Oracle Instance Name: xe
    • Configure JVM to find JDBC driver: No (2)
    • Attempt to create Database tables: Yes (1)
    • Components to install: 1,2,3,5,F
    • Install Service and start automatically (1)
    • Run as specific user: no (2)
    • Dependant on another service: no (2)
    • Install Service (2)
    • Run as specific user: no (2)
    • Dependant on another service: no (2)
    • Disable 8.3 filename creation: yes (1)
    • Caso a opção 1 Proceed esteja selecionada, pressione Enter para iniciar a instalação. Se a opção 2 Change Configuration estiver selecionada, veja a  mensagem de erro e refaça a configuração até que não haja mais erros.
  • Ao final da instalação, uma mensagem será exibida

  • O próximo passo é configurar o Apache para exibir a página do UCM.
  • Abra o arquivo httpd.conf na pasta C:\Program Files\Apache Software Foundation\Apache2.2\conf:
  • Insira este bloco de texto no final do arquivo:

    LoadModule IdcApacheAuth "C:\oracle\ecm\ucm\shared\os\win32\lib\IdcApache22Auth.dll"
    IdcUserDB Stellent "C:\oracle\ecm\ucm\data\users\userdb.txt"

    Alias /ucm "C:\oracle\ecm\ucm\weblayout"
    <Location /ucm>
    Allow from all
    DirectoryIndex portal.htm
    IdcSecurity Stellent
    </Location>
  • Esta configuração deve ficar como na imagem abaixo. Especial atenção para as quebras de linha:

  • Salve e feche o arquivo. Clique no botão Start, selecione Run e digite services.msc. Clique em OK.
  • Na tela de serviços, clique com o botão direito no serviço Apache 2.2 e selecione Restart

  • Uma vez iniciado sem erros, abra o Internet Explorer
  • Abra a URL: http://oracle-ucm.br.oracle.com/ucm
  • A página inicial do UCM deverá aparecer no navegador:


    • Página inicial do Content Server
  • OBS: Caso apareça uma mensagem falando sobre WebLayout Editor, clique no menu Start -> Programs -> Oracle Content Server -> ucm -> WebLayout Editor. Faça login como usuário sysadmin e senha idc. Nesta aplicação, clique no menu Options -> Update Portal... e em seguida clique em OK. Clique em Options -> Exit para fechar a ferramenta e acesse novamente a página inicial do Content Server.
  • Com o Content Server instalado, podemos instalar o Inbound Refinery, que irá se encarregar das conversões para PDF.

Passo 7 – Instalar Inbound Refinery

  • Execute os seguintes passos para instalar o Inbound Refinery:
    • Abra um prompt de comando na pasta C:\oracle\inst\ibr\InboundRefinery\win32
    • Inicie o instalador com o comando installer
    • Selecione as seguintes opções no menu:
      • Locale: 4 (US English)
      • Install Type: 1 (Install New Inbound Refinery)
      • Path: c:\oracle\ecm\ibr
      • Create Directory: yes (1)
      • Java Virtual Machine: 1 (Sun Java 1.5)
      • Vault Folder: c:\oracle\ecm\ibr\vault
      • Create: 1 (Yes)
      • Weblayout Folder: c:\oracle\ecm\ibr\weblayout
      • Create: 1 (Yes)
      • Master Server: 1 (Configure as a Master Server)
      • Admin Server: 2 (Configure Existing Admin Server)
      • Admin Server Path: c:\oracle\ecm\ucm\admin
      • Web Browser Path: c:\program files\internet explorer\iexplore.exe
      • Inbound Refinery Locale: 4 (US English)
      • Region: America
      • Timezone: 107 (São Paulo)
      • Inbound Refinery Port: 5555
      • Security Filter: 127.0.0.1|10.1.1.10
      • Web Server Relative Root: /ibr/
      • Web Server HTTP Address: oracle-ucm.br.oracle.com
      • Inbound Refinery Instance Name: ibr
      • Inbound Refinery Instance Label: ibr
      • Inbound Refinery Description: Inbound Refinery ibr
      • Web Server: Apache
      • Install Service (2)
      • Configure to run as specified user: no (2)
      • Configure to be dependant on another service: no (2)
      • Se a opção selecionada for a 1 Proceed, pressione enter para iniciar a instalação. Caso volte a opção 2 Change Configuration, refaça os passos da configuração, localizando o causador do erro.
  • Uma mensagem irá indicar o final da instalação com sucesso

  • Após a instalação estar concluída, devemos derrubar o Apache e incluir esta nova configuração. Para isto, execute os seguintes passos:
  • Clique no botão Start, selecione Run e digite services.msc. Clique em OK.
  • Clique com o botão direito no Serviço Apache 2.2 e selecione Stop
  • Abra o arquivo httpd.conf na pasta C:\Program Files\Apache Software Foundation\Apache2.2\conf
  • Adicione as seguintes linhas no final do arquivo:

  • IdcUserDB ibr "C:\oracle\ecm\ibr\data\users\userdb.txt"

    Alias /ibr "C:\oracle\ecm\ibr\weblayout"
    <Location /ibr>
    Allow from all
    DirectoryIndex portal.htm
    IdcSecurity ibr
    </Location>
  • O arquivo deve ficar conforme a imagem abaixo:

  • Salve e feche o documento. Reinicie o Apache na janela de Serviços
  • Abra o Internet Explorer e acesse o novo endereço: http://oracle-ucm.br.oracle.com/ibr

  • Antes de prosseguirmos na configuração, iremos instalar o GhostScript, que irá realizar as conversões para PDF.

Passo 8 – Instalar e Configurar GhostScript

  • Crie a pasta c:\temp
  • Execute o arquivo gs851w32.exe
  • Clique em Setup e mantenha as configurações conforme a imagem abaixo. Clique em Install


    • Tela de instalação do Ghostscript
  • O próximo passo é configurarmos uma impressora de PDF que irá se encarregar da conversão dos documentos para o formato PDF. Para isto:
    • Abra o Painel de Controle -> Printers
    • Execute Add Printer para iniciar o assistente de nova impressora
    • Clique Next, selecione Local Printer Attached to this computer
    • Desmarque a opção Automatically detect and install my plug&play printer. Clique em Next
    • Na tela Select a Printer Port, selecione Create a New Port e clique em Next
    • Na janela Enter a Port Name, digite o texto c:\temp\idcoutput.ps e clique OK.
    • Na próxima tela, clique em Have Disk, em seguida clique em Browse… e selecione o arquivo C:\Program Files\gs\gs8.51\lib\ghostpdf.inf. Clique Open e em seguida OK.
    • Clique em Next. Defina o Printer Name como IDC PDF Converter. Clique Next.
    • Selecione Do Not Share This Printer e clique em Next.
    • Selecione No para Print a Test Page e clique em Next.
    • Clique em Finish.
    • Um aviso de incompatibilidade pode aparecer na tela. Clique em Continue Anyway para continuar a instalação

  • Clique em Finish para terminar a instalação.
  • Voltando à janela de Printers, clique com o botão direito em IDC PDF Converter e selecione Properties
  • Nesta tela, verifique os seguintes dados:
    • Aba General: o Printer Name deve ser IDC PDF Converter
    • Aba Sharing: a opção Do Not Share this Printer deve estar selecionada
    • Aba Ports: a porta selecionada deve ser a c:\temp\idcoutput.ps
    • Aba Advanced: selecione a opção Print Directly to the Printer
  • Clique OK para fechar esta janela.

Passo 9 – Configurar os Componentes Adicionais do UCM e IBR

  • Abra o navegador e carregue a página inicial do UCM: http://oracle-ucm.br.oracle.com/ucm/
  • Faça o login com o usuário sysadmin e senha idc
  • Na barra lateral, expanda o menu Administration e clique no link Admin Server
  • Clique no botão ucm. Em seguida, clique no link General Configuration
    • Marque a caixa de opção “Automatically Assign a content ID on Check In”
    • No campo abaixo, defina o Auto Number Prefix: ucm_
      • Desta forma, todos os documentos publicados sem ID terão o prefixo ucm_
    • Marque também a caixa de seleção Enable Java Server Pages (JSP)

    • Clique em Save
    • Clique no Link de Stop para interromper o Content Server
    • Agora iremos configurar a busca textual, utilizando o banco de dados Oracle como mecanismo de busca.
    • Abra o arquivo C:\oracle\ecm\ucm\config\config.cfg usando o wordpad
    • Altere a linha SearchIndexerEngineName=DATABASE.METADATA para  SearchIndexerEngineName= DATABASE.FULLTEXT
    • Salve e feche o arquivo.
    • Abra um prompt do SQL Plus clicando no botão Start -> Programs -> Oracle Database 10g Express Edition -> Run SQL Command Line
    • Dentro do SQL Plus, digite os seguintes comandos:
      • conn ucm/welcome1
      • @ C:\oracle\inst\cs\UCM\ContentServer\database\oracle\admin\batchsnippet.sql;
      • commit;
      • exit

    • Reinicie o Content Server clicando no botão Play
    • Clique no botão Homepage e em seguida no link de login para acessar o Content Server. Expanda a aba Administration e clique no link Admin Applets.
    • Clique no ícone do Repository Manager e clique na aba Indexer
      • Clique no botão Start do painel “Collection Rebuild Cycle”. Neste momento o campo State irá mudar para Initialization. Quando ele mudar de volta para Finished, clique no botão Start do painel “Automatic Update Cycle”. O campo Status dele também será alterado para Initialization. Quando ele mudar para Finished, clique em Options -> Exit.

    • Clique no link Home ou pressione F5 para atualizar a página. Podemos ver que, juntamente com os campos tradicionais de busca, agora temos a opção de Full Text Search utilizando o banco de dados.

  • Para instalarmos os demais componentes, expanda a aba Administration, clique em Admin Server. Na nova janela que se abrir, clique no botão ucm e em seguida no link Component Manager

  • Para instalarmos um novo componente, clique no botão Browse ao lado de Install New Component

  • Selecione o arquivo C:\oracle\inst\ibr\components\InboundRefinerySupport.zip
  • Clique em Install. Caso apareça uma tela pedindo usuário e senha, utilize sysadmin/idc
  • Uma tela de confirmação será exibida; clique em Continue
  • Na próxima tela, clique no link para habilitar o componente e reiniciar o Content Server

  • Reinicie o servidor clicando no botão Stop e em seguida no botão Play.

  • Clique no link Component Manager.
  • Repita o procedimento de instalação com os seguintes arquivos:
    • C:\oracle\inst\ibr\components\ContentBasket.zip
    • C:\oracle\inst\ibr\components\DamConverterSupport.zip
    • C:\oracle\inst\ibr\components\ZipRenditionManagement.zip
    • C:\oracle\inst\Desktop\Component\DesktopIntegrationSuite.zip
    • C:\oracle\inst\DynamicConverter\component\DynamicConverter.zip
    • C:\oracle\inst\PDFWatermark\PDFWatermark.zip
      • OBS: Na tela de configuração deste componente, deixe os valores padrão.
    • Agora iremos instalar os componentes no Inbound Refinery
    • Clique no ícone Home na página do Server Admin
    • Clique no botão ibr e em seguida no link Component Manager
    • Clique em Browse e carregue o arquivo C:\oracle\inst\ibr\components\DigitalAssetManager.zip
    • Clique em Install e em seguida em Continue
      • OBS: caso o servidor peça autenticação, utilize o usuário refadmin e senha idc
    • Clique no link para habilitar o componente e reiniciar o Inbound Refinery
    • Reinicie o Inbound Refinery
    • Clique no link Component Manager
    • Repita o procedimento com os seguintes arquivos:
      • C:\oracle\inst\ibr\components\DAMConverter.zip
      • C:\oracle\inst\ibr\components\PDFConverter.zip
      • C:\oracle\inst\ibr\components\XMLConverter.zip
    • Feche todas as janelas abertas do Internet Explorer
    • Abra uma nova janela do navegador e acesse o Content Server com o usuário sysadmin e senha idc
    • Na barra Administration, clique em Providers
    • Em Create a New Provider, clique no link Add da opção Outgoing

  • Configure as seguintes informações:
    • Provider Name: ibr
    • Provider Description: ibr
    • Server Port: 5555
    • Instance Name: ibr
    • Relative Web Root: /ibr/
    • Deixe os demais valores como estão

    • Marque as opções Proxied e Handles Inbound Refinery Conversion Jobs
    • Clique em Add

  • Reinicie o Content Server através do link Admin Server na barra Administration
  • Volte ao Content Server, expanda a aba Administration e clique em Admin Applets
  • Clique no link Configuration Manager. Na janela que aparecerá, clique em Options -> Content Types

  • Clique em Add e crie um novo tipo chamado Projeto

  • Clique em OK e em seguida em Close.
  • Na janela do Configuration Manager, clique em Options -> File Formats
  • Selecione a linha com a Description Microsoft Word Document e clique no botão Edit
  • Configure o campo Conversion com o valor Word e clique em OK.

  • Clique no botão Close. Na janela do Configuration Manager, clique em:
    • Options -> Publish Dynamic Layout Files
    • Options -> Publish Static Layout Files
    • Options -> Exit
  • Feche a janela do navegador. Abra uma nova janela e acesse o Content Server com o usuário sysadmin.
  • Vamos criar uma pasta para armazenarmos os arquivos
  • Na aba Browse Content, clique em Contribution Folders

  • No menu Actions, selecione a opção New Folder

  • Preencha os atributos da pasta

  • Clique em Save
  • Agora vamos configurar o Dynamic Converter, para gerar versões HTML dos documentos publicados
    • Na aba Administration, expanda a pasta Dynamic Converter Admin e clique em Create New Template

    • Defina o Title e o Content ID como DC_Template1 e o Template Format como HTML.

    • Clique em CheckIn para publicar o novo template
    • Clique no link Configuration Settings, na pasta Dynamic Converter Admin
    • Defina o Default Template como DC_Template1
    • No campo Conversion Formats, selecione o valor application/msword. Com isso, a tela ficará com os seguintes valores:

    • Mantenha as outras opções no valor padrão e clique no botão Update
    • Vamos agora testar a conversão. Expanda a aba Browse Content, clique em Contribution Folders. Selecione a pasta Documentos e no menu Actions, selecione New Content
    • Faça o Check In de um arquivo .doc. Uma vez terminado o Check In, clique em Content Information. Nesta tela, verifique se existe uma nova opção chamada Get Conversion (HTML):

    • OBS: repare que por enquanto a versão web que está sendo criada também tem o formato Word, porque ainda não configuramos o filtro de conversão para PDF. Isto será feito em seguida.
    • Com isto temos a conversão para HTML configurada. O Dynamic Converter pode ser utilizado para criar filtros de formatação, que permitem que a versão HTML de um documento tenha cores e fontes diferentes do arquivo original. No escopo deste documento não iremos explorar esta característica, mas você pode consultar o Dynamic Converter Admin Guide para obter mais informações.

    Passo 10 – Preparar o Ambiente e testar a conversão para PDF

    • Na barra Administration, expanda a pasta Refinery Administration e clique na opção File Formats Wizard

    • Verifique se a opção Microsoft Word Document está marcada. Caso não esteja, marque-a e clique em Update
    • Abra uma nova janela do navegador e acesse o Inbound Refinery com o usuário refadmin e senha idc
    • Expanda a aba Conversion Settings e clique no link Third-Party Application Settings
    • Clique no botão Options abaixo de Distiller Engine

    • No campo Path do Ghostscript installation directory, preencha com o valor C:\Program Files\gs\gs8.51

    • Clique em Update e feche esta janela
    • Expanda a aba Conversion Settings e clique no link Primary Web Rendition

    • Marque a opção Convert to PDF using OutsideIn e clique em Update
    • Abra uma nova janela do navegador e acesse o Content Server com o usuário sysadmin
    • Expanda o painel Browse Content, abra a pasta Contribution Folders e clique na pasta Documentos
    • Expanda o menu Actions e clique em New Content
    • Selecione um arquivo .doc qualquer no campo Primary File e preencha o Title com qualquer valor.
    • Clique no botão Check In
    • Na tela de confirmação, clique em Content Info

    • O campo Status, se estiver definido com o valor GenWWW, mostra que a conversão está ocorrendo. Atualize o status da conversão clicando no link Refresh (OBS: não pressione F5, pois este comando atualiza toda a janela do navegador).
    • Após encerrada a conversão, o status do documento irá mudar para Released, e o campo Web Location apresenta a URL para a versão PDF do documento:

    • Com isso a conversão para PDF está configurada.
    Agora já temos a infraestrutura do repositório instalada. É hora de rechearmos de funcionalidades!! Continue conosco nestes exercícios e iremos adicionar diversos novos recursos, como marca d’água para PDFs, integração com Windows Explorer e Outlook, workflows e muito mais.

    Até breve!

    1. OBS: Para encerrar o ambiente, siga a seguinte sequência:
    2. Abra a janela de serviços do Windows, através do menu Start -> Run -> services.msc
    3. Selecione o serviço IDC Content Service ucm e clique em Stop.
    4. Pare o banco de dados através do menu Start -> Oracle Database Express Edition -> Stop Database.