WebTop environment for WebTop using the Eclipse and tomcat

You don't have to encrypt the username, but the password must be encrypted. This is what the documentation states. From Documentum Content Server 6.5 Administration Guide:

Execute "java -cp dfc.jar com.documentum.fc.tools.RegistryPasswordUtils password_of_user". Modify dfc.properties: "dfc.globalregistry.password=encryped_password_of_user".

I left the typo of "encryped" in there in case you go searching in the doc for it. That's how it is in the doc.

All comments

What version of WebTop are you using? My instructions are going to assume 6.x. Here is my general procedure for any WDK application in Eclipse:

Make sure that you have WTP in Eclipse.
In Windows --> Preferences --> Server --> Runtime Environments, define your Tomcat environment.
In Eclipse, create a new Dynamic Web Project with target runtime set to whatever you defined above, Configuration modified to suit your development (maybe change Dynamic Web Module to 2.3 or 2.4 instead of 2.5, depending in your WebTop version, as this is the web.xml version), and uncheck Generate web.xml deployment descriptor. I'll assume for the rest here that you've left everything else as default.
Unzip the WebTop war file and put the files directly under the WebContent directory of the project that you've created. It should be in <ECLIPSE_WORKSPACE>/webtop/WebContent.
Refresh the project in Eclipse. In the Jave EE perspective, you should see things show up in Java Resources --> Libraries --> Web App Libraries.
Shut off the validators for whatever bothers you (it always fails to validate WDK JSPs, for example) by right-clicking on the project and going to Properties --> Validation.
Edit WebContent/WEB-INF/classes/dfc.properties and add the host and port for your docbroker, and set up the global registry, too.
Right-click on the project and select Run As... Run On Server. It will guide you through setting up a local server if you haven't.
Let it publish and start up the server. You should be able to go to http://localhost:8080/webtop and log in to your docbase.
Do your development as usual. Drop Java code in webtop/src and JSPs & XMLs into webtop/WebContent/custom. Restart Tomcat as needed.
At the end, Export the project as a war, or write an Ant script to do this, there's a War Ant task. You can also deploy this war to whatever environment you want, again using Ant's War task. You can run the Ant script from within Eclipse.

I hope this helps!

Hi David,

I have made following changes in the dfc.properties file but still i am getting black page display and exception "com.documentum.web.common.Trace - Preference repository is not available, reason: repository credentials are not valid

com.documentum.web.env.PreferenceRepository$DisabledException: repository credentials are not valid"

#dfc.docbroker.host[0]=http://192.168.10.45:8080/webtop/

#dfc.globalregistry.repository=documentum
#dfc.globalregistry.username=mstechnology
#dfc.globalregistry.password=password

Thanks,

Nitin Sengar

Wiesnoepersad

#dfc.docbroker.host[0]=http://192.168.10.45:8080/webtop/

#dfc.globalregistry.repository=documentum
#dfc.globalregistry.username=mstechnology
#dfc.globalregistry.password=password

isn't correct ..

first # - means comment - not parsed - so remove the "#"

second:dfc.docbroker.host[0]=http://192.168.10.45:8080/webtop/ is incorrect, must be:

dfc.docbroker.host[0] = <ip where docbroker is running>

third: you also need to define thedocbroker port:

example:

dfc.docbroker.host[0]=localhost

dfc.docbroker.port[0]=1489

Hi,

I have made the following entries in the dfc.properties

dfc.docbroker.host[0]=192.168.10.240
dfc.docbroker.port[0]=1489

dfc.globalregistry.repository=documentum
dfc.globalregistry.username=mstechnology
dfc.globalregistry.password=password

but i am still getting blank page "http://192.168.10.45:8080/webtop/"

error in the log file generated by tomcat.

Jul 8, 2009 3:01:29 PM org.apache.catalina.loader.WebappClassLoader validateJarFile
INFO: validateJarFile(C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps\webtop\WEB-INF\lib\servlet-api.jar) - jar not loaded. See Servlet Spec 2.3, section 9.7.2. Offending class: javax/servlet/Servlet.class

I am removed the above error but i am still getting blank page

following is the tomcat logs:-

Jul 8, 2009 3:05:02 PM org.apache.coyote.http11.Http11Protocol init
INFO: Initializing Coyote HTTP/1.1 on http-8080
Jul 8, 2009 3:05:02 PM org.apache.catalina.startup.Catalina load
INFO: Initialization processed in 906 ms
Jul 8, 2009 3:05:03 PM org.apache.catalina.core.StandardService start
INFO: Starting service Catalina
Jul 8, 2009 3:05:03 PM org.apache.catalina.core.StandardEngine start
INFO: Starting Servlet Engine: Apache Tomcat/5.5.9
Jul 8, 2009 3:05:03 PM org.apache.catalina.core.StandardHost start
INFO: XML validation disabled
Jul 8, 2009 3:05:30 PM org.apache.coyote.http11.Http11Protocol start
INFO: Starting Coyote HTTP/1.1 on http-8080
Jul 8, 2009 3:05:30 PM org.apache.jk.common.ChannelSocket init
INFO: JK: ajp13 listening on /0.0.0.0:8009
Jul 8, 2009 3:05:30 PM org.apache.jk.server.JkMain start
INFO: Jk running ID=0 time=0/31 config=null
Jul 8, 2009 3:05:30 PM org.apache.catalina.storeconfig.StoreLoader load
INFO: Find registry server-registry.xml at classpath resource
Jul 8, 2009 3:05:31 PM org.apache.catalina.startup.Catalina start
INFO: Server startup in 28516 ms

Thanks,

Nitin

Hi, Nitin. What you have in your log file is not an error (it is logged INFO). It is just telling you that servlet-api.jar will not be loaded as the servlet jars are already loaded by Tomcat when it starts up (take a look in <TOMCAT_HOME>/common/lib). This is not part of the webtop.war. Don't add it. It looks like you're using Tomcat 5.5.9. I would recommend upgrading to Tomcat 5.5.25, which is one of the endorsed versions of Tomcat for Webtop 6.5. Check your Java version to make sure it's Sun's JDK, version 1.5.x. If that doesn't work, make sure that you always clear out Tomcat's work folder (in Eclipse, you can right click on the server definition of the Servers view and select "Clean Tomcat Work Directory...") whenever you make a change that is resolving an error like this (i.e. mis-rendering of JSPs).

Also note that it's good practice to explicitly specify the port in dfc.properties, but it is supposed to default to 1489 if not present.

Hi David,

I have quick question. Is it possible to pass the password and username without encryption in the dfc.properties file or we have to encrypt the password and username.

Thanks,

Nitin Sengar

You don't have to encrypt the username, but the password must be encrypted. This is what the documentation states. From Documentum Content Server 6.5 Administration Guide:

Execute "java -cp dfc.jar com.documentum.fc.tools.RegistryPasswordUtils password_of_user". Modify dfc.properties: "dfc.globalregistry.password=encryped_password_of_user".

I left the typo of "encryped" in there in case you go searching in the doc for it. That's how it is in the doc.

http://192.168.10.45:8080/webtop/wdk/redirect.jsp?ReLoad=1247123868949&__dmfUrl=/webtop/component/main

Hi David,

Thanks for the great help.

I have added encrypted password in the dfc.properties file as you suggested.

dfc.docbroker.host[0]=192.168.10.240

dfc.docbroker.port[0]=1489

dfc.globalregistry.repository=documentum

dfc.globalregistry.username=barthur

dfc.globalregistry.password=omTjlp1cBtY=

Password= barthur(omTjlp1cBtY=)

But no progress, still blank page displayed on the following URL

To test the connection I have removed the Content Server from the network then I have got the following error:-

com.documentum.web.common.Trace - Preference repository is not available, reason: repository credentials are not valid

com.documentum.web.env.PreferenceRepository$DisabledException: repository credentials are not valid

at com.documentum.web.env.PreferenceRepository.initialize(PreferenceRepository.java:293)

at com.documentum.web.env.PreferenceRepository.<init>(PreferenceRepository.java:210)

at com.documentum.web.env.PreferenceRepository.<init>(PreferenceRepository.java:61)

at com.documentum.web.env.PreferenceRepository$ApplicationListener.notifyApplicationStart

David any idea what I am doing wrong.

Thanks,

Nitin Sengar

I think "=" may need to be escaped in properties files. Try:

dfc.globalregistry.password=omTjlp1cBtY\=

Hi David,

Still same problem, is there any way to test we are passing the right username and password.

Thanks,

Nitin Sengar

Why don;t you copy/paste form the DFC.properties file of your content server ? that should do the trick (it does for me)

You can test whether it's the correct username and password by using a desktop interface to connect to the content repository. Repoint, Sampson, or IDQL, for example. Use the username and password that you think are correct. Put them in a text document, copy and paste them into the text fields of your desktop app. Once you verify that it's correct, copy and paste the password into the password encrypting utility, then copy and paste the username and result into your dfc.properties. Note that the global registry user account is usually dm_bof_registry.

yeah but don't forget that in the dfc.properties file, the password is encrypted (can't remember the name of the java class to use to encrypt it though but is is in the documentation)

java -cp dfc.jar com.documentum.fc.tools.RegistryPasswordUtils password_of_user

Hi David and Francois,

I am using the same username and password as written in the dfc.properties file of the content server and i am able to connect with the content server repository using the repoint.

UserName and Password in the dfc.properties file of the Content Server:-

-------------------------------------------------------------------------------------------------------------

dfc.globalregistry.username=dm_bof_registry
dfc.globalregistry.password=KmYwfPemMrpphRf5Lwazxg\=\=

Default UserName and Password

-------------------------------------------------------------------------------------------------------------

dfc.globalregistry.username=barthur
dfc.globalregistry.password=omTjlp1cBtY\=

I am able to connect the repoint with the repositoryusing the above default username and password but not with my application.

Thanks,

Nitin Sengar

Can you check that the dm_bof_registry user is active in your docbase ?

Can you help how we can check active users in docbase.

In the Administration node of Webtop or in the Documentum Administrator

You should be using dm_bof_registry user for the global registry on both the content and the app servers. I'm not sure what the permissions are for "barthur". You can check whether a user is active or not through DA, as mentioned above, or you can use DQL:

select user_state from dm_user where user_name = 'dm_bof_registry"

I think the user_state is 0 for active users. Someboy can correct me if I'm wrong.