Installing the RCS-Browser add-on

Installing the RCS-Browser add-on

Top Previous Next

RCSBrowser is installed on the CS-RCS server by the CS-RCS administrator. You may skip this chapter if you are not the CS-RCS administrator.

For best performance, it is recommended to install the RCSBrowser on the server that physically hosts the CS-RCS Repository. If this is not possible, make sure the server has a high-speed access to the Repository.

Microsoft Internet Information Services (IIS) must be running on the server where RCSBrowser is to be installed. Before you start, make sure you are able to access the server by entering the server URL in your Internet browser, e.g. http://localhost.

Notes:

IIS is supplied with Windows 2000 and XP. In order to install it, enter the Windows Control Panel and double click on 'Add/Remove Programs'. From the dialog which appears, click on 'Add/Remove Windows Components'. Select 'Internet Information Services (IIS)' from the list and press 'Next' to complete the installation.

If you use Windows XP SP2, you must disable the Firewall feature. This will allow other workstations to access the server. In order to disable it, enter the Windows Control Panel and double click on 'Windows Firewall'.

To install the RCSBrowser add-on, follow these steps:

Activate the CS-RCS Properties and switch to the Add-ons tab.

Select 'RCS-Browser' and click Install.

CS-RCS will download and install the add-on. By default, the RCSBrowser add-on is installed to the folder 'C:\RCSBrowser'. This folder contains the RCSBrowser program (about 5 MB). It also contains a copy of all files edited by users on remote workstations and which have not yet been checked-in. If you do not have enough space on the server C drive and wish to install it in another folder, define the registry entry below. Then re-open the CS-RCS Properties. For example, to install the RCSBrowser add-on to R:\\CS-RCS\RCSBrowser, define:

[HKEY_LOCAL_MACHINE\SOFTWARE\ComponentSoftware\CS-RCS]

"WebRoot"="R:\\CS-RCS\\RCSBrowser"

After the RCSBrowser add-on is installed, the RCS Site Definitions dialog appears:

The general format to access the RCSBrowser server is: http://ServerName/VirtualDir. (You may use https if you wish to use secured communication and your server supports the SSL protocol.) For Example, the access URL of the ComponentSoftware RCSBrowser demo projects, is: http://www.ComponentSoftware.com/RCSBrowser. Use this dialog to define the server name and the virtual directory.

This dialog contains the following fields:

'Existing Web Sites' - Lists websites, i.e. IP addresses, defined in the server IIS. Select the site where you wish to have RCSBrowser run.

'RCSBrowser virtual directory' - Directory name for RCSBrowser. This will be the URL where the user accesses RCSBrowser using their web browsers. Default value should be used when possible.

'Mapped to folder' - Location of the RCSBrowser add-on installation folder (read-only).

Click on 'Create' to define the RCSBrowser virtual directory in the selected web-site.

The RCSBrowser self-test window will appear automatically. For more information, see Self Test.
Notes:

Due to a Microsoft related limitation, an error screen stating "Action Cancelled" may appear. Extra security permissions will then have to be defined for the file MFC42.dll (For more information, see

http://support.microsoft.com/?scid=kb;en-us;842329&spid=3042&sid=global )

For more information on troubleshooting in IIS, please see:

http://support.microsoft.com/default.aspx?scid=kb;en-us;309051