Documentum: resolving variables in ucf.installer.config.xml for a Windows client

Webtop 6.8.2 on linux

resolving variables in ucf.installer.config.xml for a Windows client

For guidance, we are referring to the information in the "Configuring UCF client path substitution" section on p57 of the EMC Documentum Web Development Kit Version 6.8.2 Development Guide.

when we use the java system property user.home like this

it resolves without any problems. However, we want to change the directory location from C:/Users/ (which is what $java{user.home} resolves to) and instead use a user directory on a mapped network drive (e.g. H:/).

The problem we're having is that we're unable to resolve a java system variable if it occurs in the middle of a path string rather than at the start. Taking the example above, if we specify

we see the creation of a folder called "$java{user.name}" which is happening because the java variable is not being resolved (presumably because it is surrounded by double quotes as well as String path information (as we saw above, if the java variable occurs at the beginning of a path string, it resolves successfully even though it is within double quotes).

We have tried adding a user-defined java system property to JAVA_OPTS using -D and passing it in to the java process started in catalina.sh, then referring to it using the $java syntax, but we are unable to retrieve that at all.

We've also tried setting a linux environment variable (TESTDIR) and attempting to retrieve it using the $env syntax - e.g.

This does not work at all - we're not sure whether we have the $env syntax correct for retrieving a linux environment variable.

We've seen other similar posts but either they have no replies or the background does not quite match our own.

Has anyone else been able to resolve these problems?

Thanks

tom

Best Answer

  • I think we have figured it out. I thought I should provide you with a bit more info in the unlikely event that your interest has been piqued (if it has not, then you need read no further but please accept my apologies for bothering you).

    I was under the impression that all variable resolution was carried out on the linux (server) side rather than the windows (client) side so I completely misunderstood what was going on.
    we were trying to use linux environment variables but we should actually use windows environment variables (and we have tested this successfully) because all variables are evaluated on the windows (client) side. Similarly, since the java variables are evaluated on the client side, attempting to pass in something using JAVA_OPTS in catalina.sh (on the server) was never going to work either.

    I'm happy for this call to be closed.

Answers

  • PS the code fragments were lost in my original post, which I am unable to edit. I have added them in here:

    Webtop 6.8.2 on linux

    resolving variables in ucf.installer.config.xml for a Windows client

    For guidance, we are referring to the information in the "Configuring UCF client path substitution" section on p57 of the EMC Documentum Web Development Kit Version 6.8.2 Development Guide.

    when we use the java system property user.home like this

    <ucfHome value="$java{user.home}/Documentum/ucf" />

    it resolves without any problems. However, we want to change the directory location from C:/Users/ (which is what $java{user.home} resolves to) and instead use a user directory on a mapped network drive (e.g. H:/).

    The problem we're having is that we're unable to resolve a java system variable if it occurs in the middle of a path string rather than at the start. Taking the example above, if we specify

    <ucfHome value="H:/$java{user.name}/Documentum/ucf" />

    we see the creation of a folder called "$java{user.name}" which is happening because the java variable is not being resolved (presumably because it is surrounded by double quotes as well as String path information (as we saw above, if the java variable occurs at the beginning of a path string, it resolves successfully even though it is within double quotes).

    We have tried adding a user-defined java system property to JAVA_OPTS using -D and passing it in to the java process started in catalina.sh, then referring to it using the $java syntax, but we are unable to retrieve that at all.

    We've also tried setting a linux environment variable (TESTDIR) and attempting to retrieve it using the $env syntax - e.g.

    <ucfHome value="$env{TESTDIR}/Documentum/ucf"/>

    This does not work at all - we're not sure whether we have the $env syntax correct for retrieving a linux environment variable.

    We've seen other similar posts but either they have no replies or the background does not quite match our own.

    Has anyone else been able to resolve these problems?

    Thanks

    tom

  • I think we have figured it out. I thought I should provide you with a bit more info in the unlikely event that your interest has been piqued (if it has not, then you need read no further but please accept my apologies for bothering you).

    I was under the impression that all variable resolution was carried out on the linux (server) side rather than the windows (client) side so I completely misunderstood what was going on.
    we were trying to use linux environment variables but we should actually use windows environment variables (and we have tested this successfully) because all variables are evaluated on the windows (client) side. Similarly, since the java variables are evaluated on the client side, attempting to pass in something using JAVA_OPTS in catalina.sh (on the server) was never going to work either.

    I'm happy for this call to be closed.

TeamSite Developer Resources

  • Docker Automation

  • LiveSite Content Services (LSCS) REST API

  • Single Page Application (SPA) Modules

  • TeamSite Add-ons

If you are interested in gaining full access to the content, you can register for a My Support account here.
image
OpenText CE Products
TeamSite
APIs