IC5Notice: We have upgraded developerWorks Community to the latest version of IBM Connections. For more information, read our upgrade FAQ.
Topic
  • 11 replies
  • Latest Post - ‏2012-11-08T18:51:07Z by sumithar
sumithar
sumithar
115 Posts

Pinned topic Help in RDz

‏2012-06-21T18:26:01Z |
When I start RDz I get a pop-up saying "Help is not included when this software is installed, what would you like to do" with 2 buttons
Local Help Updater and Work Without Help

If I click the 1st button it takes me to a web page that is of no help. See attached.

What should I do to add local help? I'd like to be able to hit the F1 key to get context sensitive help instead of getting a "Topic Not Found" like I do right now.
Updated on 2012-11-08T18:51:07Z at 2012-11-08T18:51:07Z by sumithar
  • dcwilson
    dcwilson
    8 Posts

    Re: Help in RDz

    ‏2012-06-22T15:37:33Z  
    Hello Sumithar,

    When you click that first button to open up the Local Help Updater, on the left side of that web page should be a list of various IBM products. If you locate and click on the + next to Rational Developer for System z, it will expand to display several different versions. Click the + next to the version of RDz that you have installed to display the documentation options that are available for that release. There are usually only two options: the English docs, and the translations. Select one or both of the options and then click the 'Install' button located near the middle of the page.

    This will download the documentation to your RDz client so that it is installed locally. Once the download completes, you will have to restart RDz for the changes to take affect. Please let us know if you have any other questions.
  • sumithar
    sumithar
    115 Posts

    Re: Help in RDz

    ‏2012-06-22T17:58:45Z  
    • dcwilson
    • ‏2012-06-22T15:37:33Z
    Hello Sumithar,

    When you click that first button to open up the Local Help Updater, on the left side of that web page should be a list of various IBM products. If you locate and click on the + next to Rational Developer for System z, it will expand to display several different versions. Click the + next to the version of RDz that you have installed to display the documentation options that are available for that release. There are usually only two options: the English docs, and the translations. Select one or both of the options and then click the 'Install' button located near the middle of the page.

    This will download the documentation to your RDz client so that it is installed locally. Once the download completes, you will have to restart RDz for the changes to take affect. Please let us know if you have any other questions.
    I forgot to upload a bitmap which shows that I don't see anything on the LHS of the web page.
    Here it is.

    Would you know why I don't see anything?
    Thanks!
  • dcwilson
    dcwilson
    8 Posts

    Re: Help in RDz

    ‏2012-06-22T19:18:35Z  
    • sumithar
    • ‏2012-06-22T17:58:45Z
    I forgot to upload a bitmap which shows that I don't see anything on the LHS of the web page.
    Here it is.

    Would you know why I don't see anything?
    Thanks!
    Hi Sumithar,

    Here are a few suggestions:

    Delete the <RDzInstalldirectory>/help/work directory from the RDz install directory (not the shared directory) and then restart the product.

    The Work directory contains all of the plug-ins necessary for Local help to operate, including all doc plug-ins that have been or may have been downloaded. If something goes wrong with the help, this directory can be deleted and the next time the product starts, it is regenerated and the product will act as if help has never been installed locally. This is a quick way to start over with the helps without having to reinstall the whole product (and it usually fixes weird errors like this).
    If that doesn't work, another thing you can try is to manually add the help download site to the Local Help Updater page.

    At the top of the Local Help Updater page, click on the Green + sign to add a new connection.
    -For Site type, select Remote
    -Add a name for the connection
    -And for the URL, add one of the following URL's based on the version of RDz you have installed:
    RDz 7.6.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v7r6/site/site.xml
    RDz 8.0.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v8r0/site/site.xml
    RDz 8.5.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v8r5/site/site.xml
  • sumithar
    sumithar
    115 Posts

    Re: Help in RDz

    ‏2012-06-25T17:43:53Z  
    • dcwilson
    • ‏2012-06-22T19:18:35Z
    Hi Sumithar,

    Here are a few suggestions:

    Delete the <RDzInstalldirectory>/help/work directory from the RDz install directory (not the shared directory) and then restart the product.

    The Work directory contains all of the plug-ins necessary for Local help to operate, including all doc plug-ins that have been or may have been downloaded. If something goes wrong with the help, this directory can be deleted and the next time the product starts, it is regenerated and the product will act as if help has never been installed locally. This is a quick way to start over with the helps without having to reinstall the whole product (and it usually fixes weird errors like this).
    If that doesn't work, another thing you can try is to manually add the help download site to the Local Help Updater page.

    At the top of the Local Help Updater page, click on the Green + sign to add a new connection.
    -For Site type, select Remote
    -Add a name for the connection
    -And for the URL, add one of the following URL's based on the version of RDz you have installed:
    RDz 7.6.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v7r6/site/site.xml
    RDz 8.0.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v8r0/site/site.xml
    RDz 8.5.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v8r5/site/site.xml
    Hi,

    I tried the first step of deleting the entries in the folder. Now when I bring up RDz and get that message about help, and click on the button I get a different looking screen which is still empty.
    Then I click on the green plus on the top right and add a remote site like you told me to.
    http://imageshack.us/photo/my-images/802/rdzaddsite.jpg/

    But after this it looks like so
    http://imageshack.us/photo/my-images/191/rdzremotehelp.jpg/

    There was a plus to the left of the "Remote Help" but when I clicked it nothing really happened. There were some green bars that moved for a while as if to indicate something was going on and then nothing. I didn't have anything to click to move to the "RHS".

    Any thoughts?
  • dcwilson
    dcwilson
    8 Posts

    Re: Help in RDz

    ‏2012-06-28T14:42:45Z  
    • sumithar
    • ‏2012-06-25T17:43:53Z
    Hi,

    I tried the first step of deleting the entries in the folder. Now when I bring up RDz and get that message about help, and click on the button I get a different looking screen which is still empty.
    Then I click on the green plus on the top right and add a remote site like you told me to.
    http://imageshack.us/photo/my-images/802/rdzaddsite.jpg/

    But after this it looks like so
    http://imageshack.us/photo/my-images/191/rdzremotehelp.jpg/

    There was a plus to the left of the "Remote Help" but when I clicked it nothing really happened. There were some green bars that moved for a while as if to indicate something was going on and then nothing. I didn't have anything to click to move to the "RHS".

    Any thoughts?
    Hello,

    Does the machine that you are having issues with have outside access to the internet or is it configured to access the internet via proxies?
  • sumithar
    sumithar
    115 Posts

    Re: Help in RDz

    ‏2012-06-28T19:31:22Z  
    • dcwilson
    • ‏2012-06-28T14:42:45Z
    Hello,

    Does the machine that you are having issues with have outside access to the internet or is it configured to access the internet via proxies?
    Does the machine that you are having issues with have outside access to the internet or is it configured to access the internet via proxies?

    It has no problems accessing the internet but it is behind corporate firewalls. There are other apps on my PC that I have had to configure with this proxy information. Is that all I need to do? Not sure where in RDz that is configured tho.
  • sumithar
    sumithar
    115 Posts

    Re: Help in RDz

    ‏2012-06-28T21:35:36Z  
    • sumithar
    • ‏2012-06-28T19:31:22Z
    Does the machine that you are having issues with have outside access to the internet or is it configured to access the internet via proxies?

    It has no problems accessing the internet but it is behind corporate firewalls. There are other apps on my PC that I have had to configure with this proxy information. Is that all I need to do? Not sure where in RDz that is configured tho.
    I figured out the proxy settings and am currently installing the local help. thanks for the tip.
  • sumithar
    sumithar
    115 Posts

    Re: Help in RDz

    ‏2012-10-15T19:34:56Z  
    Problem resumed
  • sumithar
    sumithar
    115 Posts

    Re: Help in RDz

    ‏2012-10-15T19:37:15Z  
    • dcwilson
    • ‏2012-06-28T14:42:45Z
    Hello,

    Does the machine that you are having issues with have outside access to the internet or is it configured to access the internet via proxies?
    I have upgraded my RDz and am trying to get the help to work. I know I have the proxy set up right and it does about 40% of the installation and then c*&ps out with the message
    "Failed to install feature, an error occurred while installing the items"
  • dcwilson
    dcwilson
    8 Posts

    Re: Help in RDz

    ‏2012-10-16T16:40:29Z  
    • sumithar
    • ‏2012-10-15T19:37:15Z
    I have upgraded my RDz and am trying to get the help to work. I know I have the proxy set up right and it does about 40% of the installation and then c*&ps out with the message
    "Failed to install feature, an error occurred while installing the items"
    Hi Sumithar,

    I'm sorry to hear you are running into problems again. What version of RDz are you running now? One suggestion would be to try again what I mentioned above in my second response (Delete the <RDzInstalldirectory>/help/work directory) and then restart the product and try the help again. That acts as a reset for the help system and often times fixes many of the problems. Let me know if that does not work.

    Also, have you ever tried to access the help content Remotely instead of Locally?
    If you go to Window > Preferences > Help > Content, there should be two default connections.

    1.) Rational Developer for System z http://pic.dhe.ibm.com/infocenter/ratdevz/v8r5 (this URL varies by version, see below for the other URLs based on what version of RDz you have installed)
    2.) Local http://127.0.0.1:63650/help

    If you Enable the First connection (Remote help) and disable the Second connection (which is the Local help) and then restart the product, RDz will begin to pull the help content directly from the web and there is nothing to download. With this option, as long as you have an internet connection, you never have to worry about downloading updates because the Remote help will always be the most up to date version.
    RDz 7.6.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v7r6
    RDz 8.0.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v8r0
    RDz 8.5.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v8r5
  • sumithar
    sumithar
    115 Posts

    Re: Help in RDz

    ‏2012-11-08T18:51:07Z  
    • dcwilson
    • ‏2012-10-16T16:40:29Z
    Hi Sumithar,

    I'm sorry to hear you are running into problems again. What version of RDz are you running now? One suggestion would be to try again what I mentioned above in my second response (Delete the <RDzInstalldirectory>/help/work directory) and then restart the product and try the help again. That acts as a reset for the help system and often times fixes many of the problems. Let me know if that does not work.

    Also, have you ever tried to access the help content Remotely instead of Locally?
    If you go to Window > Preferences > Help > Content, there should be two default connections.

    1.) Rational Developer for System z http://pic.dhe.ibm.com/infocenter/ratdevz/v8r5 (this URL varies by version, see below for the other URLs based on what version of RDz you have installed)
    2.) Local http://127.0.0.1:63650/help

    If you Enable the First connection (Remote help) and disable the Second connection (which is the Local help) and then restart the product, RDz will begin to pull the help content directly from the web and there is nothing to download. With this option, as long as you have an internet connection, you never have to worry about downloading updates because the Remote help will always be the most up to date version.
    RDz 7.6.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v7r6
    RDz 8.0.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v8r0
    RDz 8.5.x = http://pic.dhe.ibm.com/infocenter/ratdevz/v8r5
    Hi Dana,
    I upgraded to 8.5. I did try the suggestion of deleting the contents of the work directory under help. But it still doesn't help with being able to use 'local help'.
    When I try to do local help updater it will show a progress bar in the browser till about 40-50% and then stop with a failure message.

    But yes, remote help works fine and since we have a reasonably good internet connection at work, it's acceptably quick. So I'll stick with that.

    Thanks for your continued help!