How to upgrade DFS 7.2 to DFS 23.2

Hi,

We have written custom DFS 7.2 code and we want to upgrade it to DFS 23.2.

How do I start upgrading?

Kindly help me with this.

Answers

  • I guess you could start by re-compiling your code using the DFS 23.2 libraries as dependencies instead of the 7.2.

    If it compiles without error, it should work fine and if it doesn't compile, the errors you get should point you to where the code needs to be modified….

  • Hi Francois,

    Ok, I will check it and let you know incase of any issues/challenges.

  • Hicham Bahi
    Hicham Bahi E Member

    As a starting point, you should probably read the release notes + checkout the Documentum System CE 23.2 - Upgrade and Migration Guide. There is a chapter on migrating DFS customizations.

  • Hi Hicham,

    I have gone through the chapter 'migrating DFS customizations', but it only talks about DFS.NET. productivity layer.

    I have not understood how I will start upgrading my custom DFS code based on Java.

    I would appreciate it if you could guide me step by step.

  • Hicham Bahi
    Hicham Bahi E Member

    If nothing in the manual applies to your customisations, follow @Francois Dauberlieu 's suggestions : update dependencies and Java runtime and optionally fix any deprecated APIs.

  • Hi,

    While I am trying to re-compile our existing custom code using the DFS 23.2 libraries (EMC Composer 23.2), getting below error:-

    [generateArtifacts] Documenting WSDL for C:\Users\****\AppData\Local\Temp\dfs-sdk-11308518109331883522-server-artifacts-generator\wsimport\wsgen\wsdl\com.webservices.ws\DMSAPIService.wsdl ....
    [generateArtifacts] Completed WsGenTask....
    [generateArtifacts] Running WsImportTask....
    [generateArtifacts] 11:32:25.993 [main] ERROR com.documentum.fc.common.impl.logging.LoggingConfigurator - Problem locating log4j configuration
    [generateArtifacts] DFSTracer invoking ConfigurationBuilder
    [generateArtifacts] ConfigurationBuilder buildConfiguration started
    [generateArtifacts] ConfigurationBuilder buildConfiguration done
    [generateArtifacts] DFSTracer invoking ConfigurationBuilder done
    [generateArtifacts] fdir.getAbsolutePath() = C:\Users\****\AppData\Local\Temp\dfs-sdk-11308518109331883522-server-artifacts-generator\wsimport\wsgen\wsdl\com.webservices.ws
    [generateArtifacts] || Task execution failed. Please add "-verbose" to your Ant command line for additional details
    [generateArtifacts] || Message: Failed generating a full set of DFS service artifacts for model file: "C:\DFS_23_2_workspce\DMSAPIService\Web Services\bin\gen-src\services-DMSAPIService-service-model.xml"
    [generateArtifacts] || Caused by: Failed generating a full set of DFS service artifacts for model file: "C:\DFS_23_2_workspce\DMSAPIService\Web Services\bin\gen-src\services-DMSAPIService-service-model.xml"
    [generateArtifacts] || Caused by: Failed generating client side JAXWS artifacts for service: "com.webservices.ws.DMSAPIService"
    [generateArtifacts] || Caused by: defaultAuthfile

    BUILD FAILED
    C:\DFS_23_2_workspce\DocumentumCoreProject\dfs23.2\dfs-build.xml:192: Failed generating a full set of DFS service artifacts for model file: "C:\DFS_23_2_workspce\DMSAPIService\Web Services\bin\gen-src\services-DMSAPIService-service-model.xml"

  • Hi All,

    Kindly help to resolve the above build issue.

  • Hi All,

    Can someone help fix the build issue mentioned above?

  • I see in the logs you show us the line:

    [generateArtifacts] || Task execution failed. Please add "-verbose" to your Ant command line for additional details

    Did you try that and do you get more info about the error ?

    Have you checked in your code and the DFS 23.2 doc that you don;t use/do something you shouldn't?

    How did you migrate your composer project from the earlier version to the latest? Did you just import the existing project or di you create a new project and just import your code?

    Asking because it could be that when opening an existing older project, it doesn't upgrade the dependencies properly (seen weirder stuff happening in my days…), if you create a new project and just import your code, then all should be setup correctly.

    Maybe it's worth giving it a shot.

  • Hi Francois,

    I have created a new project and imported the existing code. I am trying to recompile using Composer version 23.2 with OpenJDK 11. While recompiling the code, I encountered the errors mentioned above.

    Please suggest.

  • Hi All,

    Can someone help me with this?

  • Michael McCollough
    Michael McCollough E Community Moderator

    Compiling as suggested with the verbose option should provide better insight on the error. If this is urgent, you could open a support ticket. We have a lot of customers that have moved from DFS to Rest so there may not be as many familiar with DFS to answer the question.

    Any idea what "defaultAuthFile" is. I do not see any internal references to this, is it custom? Not saying this is not in OOTB DFS, I just don't see anything similar to this in intenral knowledge bases I can search (support has a bit more at their fingertips than I do though).

  • Ram_Kishan_Maitry
    edited November 19 #14

    Hi Michael,

    Thanks for your response. I have enabled the verbose option and find the below errors in composer console;-

    Any idea what "defaultAuthFile" is. I do not see any internal references to this, is it custom?

    I have checked "defaultAuthFile" and did not find anything related to this in code.

    BUILD FAILED

    C:\DFS_23_2_workspce\DocumentumCoreProject\dfs23.2\dfs-build.xml:192: Failed generating a full set of DFS service artifacts for model file: "C:\DFS_23_2_workspce\TCLDMSFANServiceProject_232\Web Services\bin\gen-src\services-TCLDMSFANService-service-model.xml"

    at com.emc.documentum.fs.tools.GenerateArtifactsTask.executeTask(GenerateArtifactsTask.java:90)

    at com.emc.documentum.fs.tools.impl.ChainedExceptionReportingTask.execute(ChainedExceptionReportingTask.java:17)

    at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:299)

    at jdk.internal.reflect.GeneratedMethodAccessor8.invoke(Unknown Source)

    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)

    at java.base/java.lang.reflect.Method.invoke(Method.java:568)

    at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:99)

    at org.apache.tools.ant.Task.perform(Task.java:350)

    at org.apache.tools.ant.Target.execute(Target.java:449)

    at org.apache.tools.ant.Target.performTasks(Target.java:470)

    at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1401)

    at org.apache.tools.ant.Project.executeTarget(Project.java:1374)

    at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExecutor.java:41)

    at org.eclipse.ant.internal.launching.remote.EclipseDefaultExecutor.executeTargets(EclipseDefaultExecutor.java:34)

    at org.apache.tools.ant.Project.executeTargets(Project.java:1264)

    at org.eclipse.ant.internal.launching.remote.InternalAntRunner.run(InternalAntRunner.java:464)

    at org.eclipse.ant.internal.launching.remote.InternalAntRunner.main(InternalAntRunner.java:143)

    Caused by: com.emc.documentum.fs.tools.ServiceCreationException: Failed generating a full set of DFS service artifacts for model file: "C:\DFS_23_2_workspce\DMSFANServiceProject_232\Web Services\bin\gen-src\services-DMSFANService-service-model.xml"

    at com.emc.documentum.fs.tools.impl.artifact.DfsArtifactGenerator.generate(DfsArtifactGenerator.java:114)

    at com.emc.documentum.fs.tools.impl.DependencyGenerateArtifactsTask.execute(DependencyGenerateArtifactsTask.java:49)

    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)

    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)

    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)

    at java.base/java.lang.reflect.Method.invoke(Method.java:568)

    at com.emc.documentum.fs.tools.GenerateArtifactsTask.executeTask(GenerateArtifactsTask.java:86)

    ... 16 more

    Caused by: com.emc.documentum.fs.tools.ServiceCreationException: Failed generating client side JAXWS artifacts for service: "com.test.webservices.ws.DMSFANService"

    at com.emc.documentum.fs.tools.impl.artifact.jaxws.WsImportList.execute(WsImportList.java:190)

    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)

    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)

    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)

    at java.base/java.lang.reflect.Method.invoke(Method.java:568)

    at com.emc.documentum.fs.tools.impl.artifact.jaxws.Wsimport.execute(Wsimport.java:136)

    at com.emc.documentum.fs.tools.impl.artifact.DfsArtifactGenerator.generate(DfsArtifactGenerator.java:83)

    ... 22 more

    Caused by: java.lang.NoSuchFieldError: defaultAuthfile

    at com.emc.documentum.fs.tools.impl.artifact.jaxws.impl.DfsNewImportTool.buildWsdlModel(DfsNewImportTool.java:363)

    at com.emc.documentum.fs.tools.impl.artifact.jaxws.impl.DfsNewImportTool.run(DfsNewImportTool.java:79)

    at com.emc.documentum.fs.tools.impl.artifact.jaxws.impl.DfsNewImportTool.run(DfsNewImportTool.java:51)

    at com.emc.documentum.fs.tools.impl.artifact.jaxws.impl.DfsWsImport2.execute(DfsWsImport2.java:644)

    at com.emc.documentum.fs.tools.impl.artifact.jaxws.WsImportList.generateWsImportArtifacts(WsImportList.java:225)

    at com.emc.documentum.fs.tools.impl.artifact.jaxws.WsImportList.execute(WsImportList.java:184)

    ... 28 more

    Total time: 11 seconds

  • Ram_Kishan_Maitry
    edited November 25 #15

    Hi All,

    I successfully recompiled the existing code with Java 17. But while running the code, I got the following error:-

    Service "com.emc.documentum.fs.services.core.QueryService" is not available at url: "http://172.16.xx.****:7001/services/core/QueryService?WSDL". org.glassfish.gmbal.ManagedObjectManager

    Also, I checked and I am able to access the URL http://172.16.xx.****:7001/services/core/QueryService?WSDL via browser.

  • Runtime issue is vastly different to compile time issue. While related the solutions are different. HENCE please

    • share the details of your solution, (so others can avoid your pain)
    • create a new post with details of this new runtime problem

    Brian Dinneen
    Documentum Designated Support Engineer

    It is at least 15 years since I did Webtop development, but as there are still development requests ...

    When developing something new, I searched for something similar in webtop, to see how that was put together.

    When I was a Webtop developer I created a source code reference from:

    • unzip webtop.war
    • decompile the java in from webtop war
    • unzip the unstripped.jar from webtop war

      • It is easier to read and use well formatted and commented code
    • unzip wdk.war over above

      • again It is easier to read and use well formatted and commented code
    • unzip any source code from wdk.war

    There are development and reference guides, but nothing beats source code.

    Documentation and software (wars files and patches) can be downloaded from product pages in support portal