Skip to main content
Z
ZithRob
Participant
October 5, 2009
Question

Clearly stated procedures for RoboHelp Server/Client installation and config?

  • October 5, 2009
  • 1 reply
  • 2325 views

I've been attempting to get RoboHelp Server and Client (Version 😎 installed in my environment for a few weeks now.  Every day I make a little more progress, but I need to get this thing up and running and move on to other things.

I would like a clearly documented methodology for the installation of these products.  I have found the included documentation to be close to useless, beyond setting up Tomcat and running the install from the disk.

I need something along the lines of the following:

1. After verification of the RoboHelp Server by going to http://<servername>:portname/robohelp, you will now need to set up the folder structures to support development, testing and production environment of help materials.

2. To setup the development folder, do the following...

3. To setup a testing environment, do the following...

4. To setup the production environment, do the following...

5. To set up access to these folders, you will need to address the security for each.

5.1. To set up a development environment, do the following...

5.2. To set up the testing environment, do the following...

5.3. To set up the production environment, do the following...

6. To set up a database using Microsoft SQL on your server, do the following.

7. You'll need to set up accounts for SQL database, following are minimum, and this is how it's done.

8. To access reports for RoboHelp, do the following...

9. To integrate users when when working with a Microsoft Active Directory, this is what you must do...

10. This is how to set up RoboHelp clients....

Honestly, I've spent over 40 hours looking all over the web on how to set up this product, and have found no concise methodology to do so. How 'bout some basic illustrations on how the communication is supposed to work?  I frequently get re-directed to my IT administrator when reading through the documentation - but I don't know what to ask them.

It may be a great product, but if you're coming to the Robohelp 8 environment without any previous Robohelp experience, you're in for a frustrating experience.

This topic has been closed for replies.

1 reply

johndaigle
johndaigle
Legend
October 6, 2009

Hi, ZithRob.

I can understand your frustration. No matter how useful server database applications may be, installation of any of them is not a trivial task. This is because of the complexity you so well articulated. I am decidedly not a network or database administrator. I am an author first, and work with servers and databases only occasionally. So, I too, had to confront the steps you did as a novice. I did successfully install RH Server 8 (and Tomcat) on two laptops (for testing) and one desktop. I documented my experience and am preparing an Adobe Captivate video(s) to show newcomers like you what I learned. Unfortunately the videos are not finished. If you email me at the address shown in my profile, I will share my "first draft" of the video which may help you sort some things out.


Meanwhile, I am not quite sure where you are in the process. After your hard work, what do you feel is left "undone" or that needs to be fixed. Or is it that you just want to make sure you've covered all the bases? If you will outline that, I will try to address it. Maybe my colleague, Colum McAndrew, will chime in as well (there is a link to his fine blog shown below.) I have spoken to Adobe engineers at various tech comm conferences and they are very committed to making the process easier, including more thorough documentation.

Meanwhile, thanks for your patience and I hope it will be rewarded soon.

Thanks

John Daigle

www.showmethedemo.com

No doubt you have already located some of these links, but here are the main ones in case you have missed any. First, server-related items and then some links to info regarding the authoring client:

Deploying Adobe RoboHelp Server on Windows (Online Help Topic)

http://help.adobe.com/en_US/RoboHelp/8.0/RoboHelpServer/WS5b3ccc516d4fbf351e63e3d11c0aaa9fd7-7ff4.html

Adobe RoboHelp Server 8 - Installation (Adobe Tech Comm Blog)

http://blogs.adobe.com/techcomm/2009/03/adobe_robohelp_server_8_installation.html

Colum McAndrews fine blog which has chronicled his success with Adobe Robohelp Server 8

http://notcolin.wordpress.com/2009/08/04/robohelp-server-8-areas-the-path-to-enligtenment/

As for the Adobe RoboHelp 8 authoring client, here are some resources to get you started:

  • Adobe RoboHelp 8 Reviewer’s Guide:  A major document highlighting all the new features of RoboHelp 8 and RoboHelp Server 8 and how they can be used to increase your productivity.
  • “Try it” exercises: These are a set of exercises that you can use to see for yourself the benefits of RoboHelp as described in the reviewer’s guide. An excellent way to familiarise yourself with the new features.
  • 7 x videos of the new RoboHelp features: A set of Captivate videos each of which describes a new feature of Robohelp 8.
  • RJ Jacquez’s blog: RJ is the Adobe Technical Communication Suite Evangelist and has lots of using information to hand. Also follow him on Twitter (rjacquez).
  • RJ’s Webinars: RJ frequently performs online training sessions that are recorded for later use. These are a great way to see the features of the Technical Communication Suite at your leisure.
  • Adobe Technical Communications Suite blog: Finally a blog with posts by the Adobe RoboHelp engineering team.
John DaigleAdobe Certified RoboHelp and Captivate InstructorNewport, Oregon
RoboColum_n_
RoboColum_n_
Legend
October 6, 2009

Hi. To add to what John has already offered, maybe the below may help with setting up areas on the server. This to me seems to be the key to what you need to achieve. We have adopted an approach where we have an area for each version of each product help file. For example for Product A Version 1 we have an area PRODAVER1, for Product A Version 2 we have an area PRODAVER2, for Product B Version 1 we have an area PRODBVER1, for Product B Version 2 we have an area PRODBVER2, etc. This satisfies the development, production environment issue. What we have also done is have a variable inside the application that points it to the relevant area on the server. That way the application just needs to be changed once to redirect the help call to the appropriate file location.

To set-up an area, logon to the RH Server Web Administrator. The top icon is used to create the users who will have access to the various areas. They are grouped. So the process is:

  1. Click Add next to the “Select a Group” field in the Users panel.
  2. Specify your group name (e.g. Department A) and click OK.
  3. Select your group in the “Select a Group” drop down.
  4. Enter a new user name in the “Add new User“ field and click Add.
  5. Click Yes in the resulting dialog and complete the username / password fields as required and click OK.
  6. Repeat steps 3 to 5 for other users.
  7. Click on the Areas icon (second one down).
  8. Click Add next to the “Select an Area” field.
  9. Specify an area name ensuring the “Protected” option is enabled.
  10. Next you need to add the group you specified in step 2 by clicking Add next to the “Add new Group” field.

That’s about it and you’ll find that area is available to specify in the WebHelp Pro single source layout properties in the RoboHelp client. You just specify the area and publish. Once published, the project is displayed in the Projects panel on the RH Server Web Administrator.

Hope this helps.

Read  the RoboColum(n) for a tips and tricks on Technical Communication Suite products.

Terms & ConditionsAccessibility statement
Using the community Terms of use Privacy Cookie preferences Do not sell or share my personal information ad choicesAdChoices