What the Applications at IPM? IPM series

What is the Applications at IPM?

is type of management or container for documents uploaded to Oracle I/PM. In effect, an application is a
category into which documents get sorted. Each application has unique security rights
that are applied to documents in the application, and unique metadata fields to store
the metadata values associated with each document. Changing security rights within
an application affects access to all documents within the application. Similarly, adding
a metadata field to an application adds the field to all documents within the application, however metadata values for the added field must be supplied individually to each document.

 

What is the Input?

Inputs are the way that documents are uploaded to Oracle I/PM and metadata is
associated with them. Metadata values for a document are typically supplied when a
document is uploaded. Documents can be uploaded individually and metadata values
supplied manually by the person uploading the document. Most often documents are
uploaded in bulk using a scanning station. When uploaded in bulk, the scanning

 

Searches


Searches are used to retrieve a listing of documents from Oracle I/PM. A search can be
run across one or multiple applications, and the returned results listing can be
e-mailed to others or exported to a file. Documents listed in a search result can be
viewed, downloaded, copied to other applications, or otherwise manipulated as your
business need requires.

Connections
Connections are created in Oracle I/PM and used to access necessary servers. Two
types of server connections are defined in Oracle I/PM:
■ repository connections are created to connect to an Oracle Content Server or
servers where documents are stored
■ workflow connections are created to connect to workflow servers where a
workflow process is defined
Oracle I/PM stores documents in repositories set up using Oracle Universal Content
Management. Multiple repositories can be used, with connections created in Oracle
I/PM to each repository using the Oracle I/PM interface. If your business process
requires documents in a particular application to move through a workflow, then a
connection to the workflow server where the workflow is defined can also be created
in Oracle I/PM, and the application can be set to initiate the workflow when a
document is upload to it.

 

Controlling Access
Access to the documents is controlled by a number of factors. First, by controlling
access to the Oracle I/PM system. Second, by assigning permissions to the

applications, searches, and other tools provided by the Oracle I/PM system. Lastly, by
assigning permissions to the documents within different applications. In the preceding

what the IPM?

Oracle Imaging and Process Management (Oracle I/PM) integrates electronic
document storage, retrieval, and annotation with business processes to facilitate
document use across an enterprise. Documents are uploaded into a repository
managed by Oracle Universal Content Manager using an application within I/PM.
Applications are predefined by you based on your business need. Documents are
uploaded to applications based on a business need. For example, one application
would be used to upload an invoice and a different application would be used to
upload a contract. The application determines the metadata that is associated with a
document, as well as security permissions to the document and any document
annotations

How To configure Oracle UCM 11g manually to work with Oracle I/PM?

To configure Oracle UCM 11g manually to work with Oracle I/PM:

  1. Start the Oracle UCM Managed Server, as described in Section 10.2, “Starting Managed Servers.”
  2. Access Oracle Content Server, as described in Section 5.2.1, “Starting Oracle Content Server.”
  3. Enable the IpmRepository component:
    1. From the Oracle Content Server Admin Server, select Server Features.
    2. Select IpmRepository, and click the Update button.
    3. Click the OK button to enable this feature.
    4. Restart Oracle Content Server, as described in Section 5.2.4, “Restarting Oracle Content Server.”
  4. Enter the following values on the Connection Settings page:
    • Repository Proxy: weblogic
    • Port: The IDC port of the Oracle UCM instance, 4444 by default
  5. Configure the Oracle UCM machine name as part of the Content Server Pool.
  6. Upgrade the default file store:
    1. Under Administration, select Providers.
    2. Select Info in the Action column of the DefaultFileStore row.
    3. When asked if you want to upgrade the file store, click Upgrade, and then click Update in the Edit File Store Provider dialog box.

      Oracle UCM does the upgrade automatically.

How to Connecting IPM with Oracle UCM Repository?

Before Oracle I/PM can use the Oracle UCM repository, you need to configure a connection to Oracle Content Server. You can create a connection to it from Oracle I/PM.

To connect to an Oracle UCM repository:

  1. Open a web browser, and navigate to this web site: http://hostname:16000/imaging
  2. Log in with the administrator user name and password.
  3. Navigate to the Manage Connections tray, and select Create Content Server Connection from the list.
  4. Enter a name for the connection on the Basic Information page and, optionally, a description, and then click Next.
  5. Enter the following values on the Connection Settings page:
    • Repository Proxy: weblogic
    • Port: The IDC port of the Oracle UCM instance, 4444 by default

    If the Oracle UCM server is on the same machine as the Oracle IPM server, select Use Local Content Server. If the servers are not installed on the same machine, you will need to configure the Oracle UCM machine name as part of the Content Server Pool.

  6. Click Next.
  7. Enter a Connection Security value for the connection.

    Select which users and groups should have permission to access, modify, delete, or grant others access to this connection definition. At least one user or group must have the grant access permission.

  8. Click Next.
  9. At the Summary screen, click Submit.

How to configuring WebLogic NodeManager ?

the original Post here

Starting Point

The assumption is that the WebLogic Server installation has been done and that the Node Manager Windows Service was installed as a part of the installation.

Any paths reflected below should be updated to reflect your directory structures. In fact, it probably would not be a bad idea to find/replace some of the following with the relevant strings:

  • WebLogic Server installation path: D:\Oracle\wls11g
  • Hostname: jbayer-us
  • Domain path: D:\Oracle\wls11g\user_projects\domains\my_domain

Uninstall / Reinstall NodeManager Service

This needs to be done if you installed Node Manager with the standard installer because by default Node Manager binds to localhost. So as more OS instances are added, it will be required to have Node Manager instances on the network communicate to each other. This can only happen if Node Manager binds to an network interface that is available remotely.

  • open cmd prompt
  • run D:\Oracle\wls11g\wlserver_10.3\server\bin\setWLSEnv.cmd
  • run D:\Oracle\wls11g\wlserver_10.3\server\bin\uninstallNodeMgrSvc.cmd
  • Make backup copy of installNodeMgrSvc.cmd
  • edit installNodeMgrSvc.cmd to bind to hostname for remote starts
  • set NODEMGR_HOST=jbayer-us
  • run D:\Oracle\wls11g\wlserver_10.3\server\bin\installNodeMgrSvc.cmd
  • start the service – mine is called “Oracle WebLogic NodeManager…” but on older versions it’s likely will start with “BEA …” startnodemanager.cmd
  • starting the NodeManager process should create the nodemanager.properties file we will edit next

CrashRecovery and StartupScriptEnabled (updated 01/10/2010)

  • We want to Enable NodeManager to restore servers to their last known state after a reboot.
  • Open nodemanager.properties from the directory D:\Oracle\wls11g\wlserver_10.3\common\nodemanager\
  • Change the CrashRecoveryEnabled property from false to true:
  • CrashRecoveryEnabled=true
  • Also, because the domain’s \bin\startWebLogic script already has classpath configured, which is especially helpful for use with SmartUpdate that manages WebLogic patches as those classpath’s are not trivial to understand, I strongly recommend setting StartupScriptEnabled=true StartScriptEnabled=true in nodemanager.properties (Thanks to Ray T for the typo fix 6/29/10)
  • stop/start node manager after making changes to nodemanager.properties

Set up the Machines

  • Go to the domain’s AdminServer console
  • http://localhost:7001/console
  • If you need to start it, run <your_domain_dir>\bin\startWebLogic.cmd
  • With the console navigate to <domain_name> -> Environment -> Machines
  • Create a new machine – I named mine after the hostname of the server – jbayer-us
  • If you have more than one OS instance, create one machine for each.

nm_machines

  • In console go to <domain_name> -> Environment -> Servers
  • Create a new server, example: managedServer1
  • Put in the listen address to the hostname you want to bind to, in my case jbayer-us
  • Change the port to 8001or another available port so as not to conflict with the 7001 port of the AdminServer
  • Assign managedServer1 it to the jbayer-us machine you just created – <domain_name> -> Enviornment -> Servers -> managedServer1
  • There should be a dropdown you can use to select the machine
  • Click the save button on this settings page (don’t forget this step)
  • Now activate changes if required

We need to assign the machine for the AdminServer, this cannot be done while the AdminServer is running.

  • Stop AdminServer
  • Open the domain config, example – D:\Oracle\wls11g\user_projects\domains\my_domain\config\config.xml
  • Find the element used to assign the machine for managedServer1
  • <machine>jbayer-us</machine>
  • Copy that and paste that element right after the AdminServer <name/> element
  • If it is not already set, also specify the AdminServer listen address to be the hostname to bind to, by default it is blank which means bind to all network interfaces.
  • After these changes my config.xml snippet for the AdminServer looks like this:
<server>
<name>AdminServer</name>
<machine>jbayer-us</machine>
<listen-address>jbayer-us</listen-address>
</server>
    • Start the AdminServer again with the domain directory’s bin\startWebLogic.cmd
    • Check the console page <domain_name> -> Environment -> Servers to see that the servers are defined correctly as expected

Enroll the domain with Node Manager (updated 01/10/2010)

    • Navigate with a command prompt go to the domain directory
    • run bin\setDomainEnv.cmd
    • run java weblogic.WLST
    • connect to the AdminServer with your credentials:
    • connect(‘weblogic’,’welcome1′,’t3://jbayer-us:7001′)
    • Make sure you use forward slashes instead of backslashes in Windows:
    • nmEnroll(domainDir=’D:/Oracle/wls11g/user_projects/domains/my_domain’,nmHome=’D:/Oracle/wls11g/wlserver_10.3/common/nodemanager’)
    • Now go back to the web console – http://localhost:7001, for each server in the environment, go to the server start tab and put in the appropriate values.
    • serverStartTab If you are using StartScriptEnabled=true in nodemanager.properties, then the classpath and jvm arguments from the script will be used first and the values you specify on the Server Startup tab will get added to the end, so you only need to enter values that are unique to each server in the classpath and arguments section.
    • If you’re using Sun JDK instead of JRockit, then use –Xrs instead of –Xnohup refer to the official docs for more on this, but it has to do with handling OS signals properly.
    • 7-2-10 update: Reader Ray T writes in with another tip:“After some testing: starting, stopping servers, killing processes, rebooting etc after the configuration, I also found that I could not get the managed servers to shutdown cleanly – or at least the console would not recognize that they had. This had the added side effect of then not letting me start/restart a managed server via the console.I found that also adding StopScriptEnabled=true solved that final problem.”

Click the image to enlarge – actual text values below:

Java Home

D:\Oracle\wls11g\jrockit_160_14_R27.6.5-32

Java Vendor

Oracle

BEA Home

D:\Oracle\wls11g

Root Directory

D:\Oracle\wls11g\user_projects\domains\my_domain

Classpath is empty as the script values are sufficient

Arguments

-Xnohup

Security Policy File

D:\Oracle\wls11g\wlserver_10.3\server\lib\weblogic.policy

User Name

weblogic

Password

welcome1

Confirm Password

welcome1

    • Save
    • Now do the same thing for each managed server.
    • Activate the changes if required

Node Manager Domain Username and Password

    • Set the Node Manager username/password for the domain in the console
    • Click <domain_name> in the console navigator
    • Select Security tab
    • Expand to the “Advanced” options about half-way down the page
    • Choose a Node Manager username/password and put it in the username/password/confirm boxes your credentials, these could be unique from your user used to start the AdminServer, but I chose to keep mine the same weblogic/welcome1.  If you change this user name and password, then you’ll need to specify both when using the command nmConnect().  Thanks Ray T for the catch – 6/29/10.

Decrease Log Verbosity For Standard OutnmCriticalLogSetting

    • In console, go to each server’s Logging -> General page
    • Expand to the Advanced section half-way down the page
    • Change the standard out notice level to “Critical”
    • This log file that captures Standard Out does not roll over while a server is running, so it’s really important to make sure this file doesn’t get too large. Note that this is not the server log file, this is only standard out.

Have NodeManager Start and Stop the Servers

    • If it is running, shutdown the AdminServer
    • Start the AdminServer with NodeManager
    • Go to domain dir
    • run bin\setDomainEnv.cmd
    • run java weblogic.WLST
    • nmConnect(domainName=’my_domain’)  nmConnect(domainName=’my_domain’, username=’weblogic’, password=’welcome1’)  6/29/10 Updated thanks to Ray T who noticed that if you change the domain’s Node Manager user and password in the section above called “Node Manager Username and Password” that you’ll need to specify those values here otherwise the defaults of weblogic/welcome1 are used, which worked in my case, but not for others.
    • nmStart(‘AdminServer’)
    • Go to console -> Environment -> Servers control tab and start the managed server from the console. It will send a command to Node Manager which actually performs the operation on the console’s behalf.
    • Gotcha! – If you have never started the managed server ever before and you try to start it from Node Manager, you might get an error.  In the server log it mjght say something like: Booting as admin server, but servername, managedServer1, does not match the admin server name, AdminServer  To get around this, simply start the Managed Server for the first time using either the Admin Console Servers->Control tab or the startManagedWebLogic.cmd script.  Subsequent nmStart commands should not have this issue any longer.

Test Killing and Restarting

If the servers are started successfully by Node Manager, try and kill a process from task manager and see if it restarts.

Looking at the Node Manager directory in the domain for each Managed Server, you will be able to see the state – below is a screenshot of managedServer1’s files. The PID and .state files should tell you what you need to know to see if the server recovered.  If it did not, the .out file in the server log directory should hopefully give you a clue why.

nmDir

If manual killing of the process restarts a Server then you are ready to test an operating system reboot. Reboot the machine without stopping the WebLogic Servers. Each server should be restored to the state that it was in when the OS was rebooted.