RapPort Installations

Previous page
Table of content
Next page

This section provides installation instructions and information about how to remove RapPort. Install RapPort by completing the following steps:

  • Review the server hardware and software requirements, including coexistence issues, outlined earlier in this chapter.
  • Create the RapPort server.
  • Create the template server.
  • Create the destination server.
  • Create the workspace templates.

The following sections provide detailed instructions on each of these steps.

Installing RapPort

You must create the RapPort server before creating the other servers. This section provides detailed instructions on each installation process.

Install the RapPort Server

This section describes the process of setting up the RapPort server.

If RapPort was previously installed on this computer, remove it before beginning the new installation. For more information, see Removing RapPort.

To set up a domain account as an administrator on the RapPort server:

  1. Log on with a user account that is an administrator on the server.

    You should use the same domain user account and password on each server in the RapPort deployment. This domain account must be a member of the local Administrators group on each server.

  2. On the Start menu, point to Programs, point to Administrative Tools, and then click Computer Management.
  3. Expand Local Users and Groups.
  4. Click the Groups node.
  5. Double-click Administrators on the details pane. The Administrators Properties dialog box appears.
  6. Click Add.
  7. In the Select Users or Groups dialog box, type the name of the appropriate domain account. Add domain\account_name to the local Administrators group on the server where domain is a valid Windows NT domain name and account_name is a valid account.
  8. Click Check Names.
  9. Click OK.
  10. Click OK to close Administrators Properties.
  11. Close Computer Management.

To confirm SharePoint Portal Server Web Storage System accessibility:

This step should be performed before proceeding with further installation.

  1. Open Internet Explorer.
  2. In Address, type http://server_name/public where server_name is the name of the RapPort server.
  3. If the public folder is not displayed and the computer stops responding, restart the computer and repeat steps 1 and 2. If the computer still does not respond, the Web Storage System may be corrupted. In this case, rebuild the computer and install SharePoint Portal Server.

To copy RapPort server files:

  1. Open Windows Explorer.
  2. Copy the RapPortServerFiles.zip file to the root of the local hard disk drive on which the RapPort server is to be installed.
  3. Extract all files from this zip file to the root of the local hard disk drive on which the RapPort server is to be installed.
  4. Close WinZip.

    Do not move or rename this folder or any subfolder/files.

  5. Verify that the following folders and files exist in the folder:

    RapPort

    RapPort\AutoSetup

    • Autosetup.exe

    RapPort\AutoSetup\Components

    • assignRoles.dll
    • SCM.dll
    • TemplateInst.dll
    • WrapperTemplateInst.dll

    RapPort\AutoSetup\Components\XSL

    • convert-dav-to-ddf.xsl
    • import-application-folder-documents.xsl
    • import-application-folders.xsl
    • import-categories.xsl
    • import-document-folders.xsl
    • import-portal.xsl
    • import-portal-content-folders.xsl
    • import-rapportresources-folders.xsl
    • import-schema.xsl

    RapPort\AutoSetup\Configuration

    • constants.xml
    • globalizedStrings.xml
    • Mails.xml
    • ServerConfig.xml

    RapPort\AutoSetup\Logs

    • No Files

    RapPort\AutoSetup\RegistryEntries

    • RapPortServerReg.reg

    RapPort\AutoSetup\Temp

    • No Files

    RapPort\AutoSetup\Utilities

    • addauthor.vbs
    • addcoordinator.vbs
    • addreader.vbs
    • RestartIIS.cmd
    • sleep.vbs

    RapPort\RapPortWeb

    • Default.htm
    • Global.asa

    RapPort\RapPortWeb\Configuration

    • RegionCodes.xml
    • RegionCodes.xsl
    • TemplateConfig.xml
    • TemplateConfig.xsl
    • todaysServers.xml

    RapPort\RapPortWeb\Content (The file list in this folder can change, as it contains the content files for the RapPort Web site, in addition to the files needed for the request creation wizard.)

    • BusDivPortal.htm
    • Customize.htm
    • DeptPortal.htm
    • FAQ.htm
    • MoreInfo.htm
    • Support.htm
    • Templates.htm
    • 1ptrans.gif
    • linenavdns.gif
    • new logo.bmp
    • ep.css
    • expendLeftNav.js
    • local.js
    • navscrpt.js
    • toolbar.js

    RapPort\RapPortWeb\Data

    RapPort\RapPortWeb\Data\CheckAvailability

    • No Files

    RapPort\RapPortWeb\Data\History

    • No Files

    RapPort\RapPortWeb\Data\TemporarySecurityData

    • No Files

    RapPort\RapPortWeb\Data\UserRequests

    • No Files

    RapPort\RapPortWeb\Images

    • pixel.gif
    • settingsicon.gif

    RapPort\RapPortWeb\Includes

    • CheckAvailability.cmd
    • CommonFunction.js
    • constants.asp
    • constants.inc
    • cust.css
    • ErrorPage.asp
    • errors.js
    • messages.inc

    RapPort\RapPortWeb\Pages

    • advanced.htm
    • advancedFrame.asp
    • checkURLAvailability.asp
    • checkUserRequests.asp
    • deleteUserData.asp
    • finishPage.asp
    • rapportSetup2.asp
    • rapportSetup3.asp
    • saveTemporarySecurityData.asp
    • saveUserData.asp
    • saveUserSecurity.asp
    • sendTemporarySecurityData.asp
    • statusbar.htm
    • workspaceRolesContainer.asp

    RapPort\RapPortWeb\Pages\AD

    • No Files

    RapPort\RapPortWeb\Pages\AD\COM

    • ActiveDir.dll

    RapPort\RapPortWeb\Pages\AD\Components

    • No Files

    RapPort\RapPortWeb\Pages\AD\Components\UserPicker

    • AddressBook.asp
    • CommonFunctions.js
    • UniCal.css
    • UserPicker.asp
    • UserPicker.css
    • UserPicker.js

    RapPort\RapPortWeb\Pages\AD\Images

    • No Files

    RapPort\RapPortWeb\Pages\AD\Images\UserPicker

    • Contact.gif
    • Group.gif

To remove the read-only attributes for the files:

  1. Open Windows Explorer on the RapPort server.
  2. Right-click the RapPort folder and then click Properties.
  3. On the General tab, select the Read-only check box. If the check box is already selected, go to step eight.
  4. Click OK.
  5. In Confirm Attribute Changes, click Apply changes to this folder, subfolders and files.
  6. Click OK.
  7. Right-click the RapPort folder and then click Properties.
  8. On the General tab, clear the Read-only check box.
  9. Click OK.
  10. In Confirm Attribute Changes, click Apply changes to this folder, subfolders and files.
  11. Click OK.

When editing the XML files, do not delete or change any of the node tags. Change only the text between the > and </ signs for the nodes.

Do not add any XML-sensitive special characters (such as &, <, > etc.) while editing the contents in the XML files. Always confirm that the XML file is valid by opening the edited XML file in Internet Explorer and confirming that the file opens without errors.

Incorrectly editing the registry may severely damage your system. Back up the current version of the registry before making any changes. You should also back up any valued data on the computer.

When editing the registry (.reg) files, you must enter a single \ as \\ when entering path names, for example, D:\\RapPort\\AutoSetup. Do not remove quotation marks.

To edit RegionCodes.xml:

  1. Open Windows Explorer, and then navigate to the following folder on the drive on which the RapPort server is to be installed:

    ..\RapPort\RapPortWeb\Configuration

  2. Open RegionCodes.xml in Notepad.
  3. Copy the XML node <region></region> and paste for each of the region entries you want to make.
  4. Edit each XML node <region></region> by adding the actual region name and a unique code for each region. For example, <region code="FE">Far East</region>.
  5. Save the file.
  6. Close Notepad.
  7. Double-click the file to open it in Internet Explorer to confirm that the XML formatting is correct. Internet Explorer should display the file without any errors.

To edit TemplateConfig.xml:

  1. In Windows Explorer, and then navigate to the following folder on the drive on which the RapPort server is to be installed:

    ..\RapPort\RapPortWeb\Configuration.

  2. Open TemplateConfig.xml in Notepad.
  3. Copy the XML node <template></ template> and paste a copy of this node for each of the workspace templates that should be available for copying.
  4. Edit the XML node <name></name> under each <template></ template> node by adding the display name of the template. RapPort presents this display name to the user when making a request from the RapPort Web site. For example, <name>Product Group – Portal</name>

    A long template name can distort the Web site user interface. It is recommended that you use a reasonable length for the template name. Although there is no limitation on the text for a template name length, 50 characters should be sufficient for displaying properly on the Web site user interface. After entering the name for the template in the XML file, check the Web site user interface for distortion. If the display name distorts, you should shorten the template name so that it can display correctly in the Web site user interface.

  5. Edit the XML node <url></url> under each <template></ template> node by adding the complete URL of the corresponding workspace template. For example, <url>http://Adventure-Works/portaltemplate</url>.
  6. Save the file.
  7. Close Notepad.
  8. Double-click the file to open it in Internet Explorer to confirm that the XML formatting is correct. Internet Explorer should display the file without any errors.

To edit ServerConfig.xml:

  1. Open Windows Explorer, and then navigate to the following folder on the drive on which the RapPort server is to be installed:

    ..\RapPort\AutoSetup\Configuration

  2. Open ServerConfig.xml in Notepad.
  3. Copy the XML node <entry></entry> and paste for each of the shared destination server entries.
  4. Edit the XML node <region></region> under each <entry></entry> node by adding the actual region code for the destination server name. For example, <region>FE</region>. Get the appropriate region code from the RegionCodes.xml file edited in the previous procedure.
  5. Edit the XML node <servername></servername> under each <entry></entry> node by adding the actual destination server name. For example, <servername>AdventureWorks</servername>.
  6. Edit the XML node <capacity></capacity> node under each <entry></entry> by entering the maximum number of workspaces that can be hosted on this destination server.
  7. Edit the XML node <current></current> under each <entry></entry> node by entering the current number of workspaces that are hosted on this destination server.
  8. Save the file.
  9. Close Notepad.
  10. Double-click the file to open it in Internet Explorer to confirm that the XML formatting is correct. Internet Explorer should display the file without any errors.

To edit Mails.xml:

  1. Open Windows Explorer, and then navigate to the following folder on the drive on which the RapPort server is to be installed:

    ..\RapPort\AutoSetup\Configuration.

  2. Open Mails.xml in Notepad.
  3. Edit the <smtpservername></smtpservername> node by adding the SMTP server name to be used for sending mail. Typically, this will be the same name as that of the RapPort server, otherwise specify the actual SMTP server name. For example, <smtpservername>AdventureWorks</smtpservername>.
  4. Search for the XML node <mail > in this file.
  5. Under this XML node, edit the <to><name></name></to> node by adding the e-mail account to whom the WINS registration entry is sent. For example, <to><name>operations@adventure-works.com</name></to>.
  6. Search for RapAdmin@adventure-works.com. Replace this account with the e-mail address for the administrator account from which the RapPort application will send e-mails.
  7. Search for RapSupport@adventure-works.com. Replace this account with the e-mail address for the RapPort Support account that receives mail regarding support.
  8. Save the file.
  9. Close Notepad.
  10. Double-click the file to open it in Internet Explorer to confirm that the XML formatting is correct. Internet Explorer should display the file without any errors.

To change the domain name for notifications:

  1. In Notepad, open Constants.xml.
  2. Modify the domain name in the following node as appropriate:

    <Constant const>@adventure-works.com</Constant>

  3. Save the file.
  4. Edit FinishPage.asp on the RapPort server.
  5. Search for the string "@adventure-works.com."
  6. Change the domain name as appropriate.
  7. Save the file.

To edit RapPortServerReg.reg:

  1. Open Windows Explorer, and then navigate to the following folder on the drive on which the RapPort server is to be installed:

    ..\RapPort\AutoSetup\RegistryEntries

  2. Right-click RapPortServerReg.reg, and then click Edit to open the file in Notepad.

    Incorrectly editing the registry may severely damage your system. Back up the current version of the registry before making any changes. You should also back up any valued data on the computer.

  3. Edit the line "Path"="drive:\\RapPort" and replace drive with the actual drive letter of the drive on which the RapPort server is installed. Do not remove the \\ in the path.
  4. Edit the value of "CommonAdmin"= "domain\\account_name" and replace it with the user account which is to be used as the administrator account on all RapPort computers.

    Use \\ instead of a single \ to specify the account name.

  5. Save the file.
  6. Close Notepad.

To import the RapPort server registry entries:

Incorrectly editing the registry may severely damage your system. Follow the instructions below very carefully. Back up the registry before making any changes.

  1. Open Windows Explorer, and then navigate to the following folder on the drive on which the RapPort server is to be installed:

    \RapPort\AutoSetup\RegistryEntries

  2. Double-click RapPortServerReg.reg to import the registry entries.
  3. Click Yes to add the information to the registry.
  4. Click OK.
  5. Close Windows Explorer.

To verify that registry entries have been successfully imported:

Do not change any values in the registry. Incorrectly editing the registry may severely damage your system. Back up the current version of the registry before making any changes. You should also back up any valued data on the computer.

  1. On the Start menu, click Run.
  2. Type regedit and then click OK.
  3. In Registry Editor, navigate to the node:

    My Computer\HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\RapPort

  4. Click this node and confirm that all the entries correctly display in the right pane.
  5. Close Registry Editor.

To register the RapPort DLLs:

  1. On the Start menu, click Run.
  2. Type regsvr32 drive:\RapPort\AutoSetup\Components\assignRoles.dll where drive is the drive letter for the drive where RapPort server is to be installed.
  3. Click OK.
  4. If the following message does not appear, repeat step 2 until the appropriate message appears:

    "DllRegisterServer in drive:\RapPort\AutoSetup\Components\assignRoles.dll succeeded."

  5. In the RegSvr32 dialog box, click OK.
  6. Repeat steps 1 through 5 for each of the following DLLs, typing the following in step 2:
    • regsvr32 drive:\RapPort\AutoSetup\Components\SCM.dll
    • regsvr32 drive:\RapPort\AutoSetup\Components\TemplateInst.dll
    • regsvr32 drive:\RapPort\AutoSetup\Components\WrapperTemplateInst.dll
    • regsvr32 drive:\RapPort\RapPortWeb\Pages\AD\COM\ActiveDir.dll

To create a new COM+ application:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Component Services.
  2. In Component Services, expand the Component Services node and its subnodes.
  3. Click COM+ Applications.
  4. Right-click COM+ Applications, point to New, and then click Application. The Welcome to the COM Application Install Wizard appears.
  5. Click Next.
  6. Click Create an empty application.
  7. Enter RapPort as the name of the new application, and then select Server application.
  8. Click Next.
  9. Click This User.
  10. In User, enter the name of the appropriate domain account such as domain\account_name.
  11. In Password and Confirm password, type the password for the account.

    You must change the password for this setting whenever the password for this account changes.

  12. Click Next.
  13. Click Finish.

To add components to the new RapPort COM+ application:

  1. Expand the RapPort node under COM+ Applications.
  2. Click Components under the RapPort node.
  3. Right-click Components, point to New, and then click Component. The Welcome to the COM Component Install Wizard appears.
  4. Click Next.
  5. Click Import Component(s) that are already registered.
  6. Select ActiveDir.Helpers from the list of components.
  7. Click Next.
  8. Click Finish.
  9. Repeat steps 1 through 8 above for each of the following components, replacing ActiveDir.Helpers with the following component names:
    • ActiveDir.QueryGC
    • AssignRoles.Roles
    • SCM.Manager
    • TemplateInst.CodeGenerator
    • WrapperTemplateInst.clsInstantiate.
  10. Confirm that all components are visible by expanding the Components node.
  11. Close Component Services.

To create a new virtual directory in the default Web site:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Expand the server name.
  3. Right-click Default Web Site, point to New, and then click Virtual Directory. The Welcome to the Virtual Directory Creation Wizard appears.
  4. Click Next.
  5. On the Virtual Directory E-mail account page, type RapPort in E-mail account, and then click Next.
  6. On the Web Site Content Directory page, click Browse, and then navigate to the RapPort\RapPortWeb folder on the drive on which the RapPort server is to be installed.
  7. Click the RapPortWeb folder, and then click OK.
  8. Click Next.
  9. On the Access Permissions page, click Next. Do not change the default access permissions.
  10. Click Finish.

To configure properties for the Default Web Site:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Expand the server name.
  3. Right-click Default Web Site, and then click Properties.
  4. On the Web Site tab, select (All Unassigned) from IP Address.
  5. In TCP Port, type 80. Do not change any other settings.
  6. Click the Directory Security tab.
  7. In Anonymous access and authentication control, click Edit.
  8. In the Authentication Methods dialog box, clear all check boxes except for the Integrated Windows authentication check box.
  9. Click OK.
  10. If the Inheritance Overrides dialog box appears, click RapPort under Child Nodes, and then click OK. If the RapPort child node is not displayed in the list, click OK without selecting anything.

    After clicking OK, view the properties of the RapPort virtual directory to ensure that only the Integrated Windows Authentication is specified for the directory security.

  11. Click the Home Directory tab.
  12. Under When connecting to this resource, the content should come from, click A redirection to a URL.
  13. In Redirect to, type /RapPort.
  14. Under The client will be sent to, click the A directory below this one check box.
  15. Click OK to close the Default Web Site Properties dialog box.

To configure properties for the Active Directory virtual directory under RapPort:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Expand the server name. Typically, the server name is the computer name.
  3. Expand the RapPort node under Default Web Site in IIS, and then expand the Pages Web directory.
  4. Right-click the AD node, and then click Properties.
  5. On the Directory tab, click Create under Application Settings. Keep other settings at the default values.
  6. After creating the Active Directory application, click Configuration.
  7. In the Application Configuration dialog box, click the App Options tab.
  8. On the App Options tab, change the ASP Script timeout value to 600 seconds.
  9. Click OK to close the Application Configuration dialog box.
  10. Click OK button to close AD Properties.

To configure properties for the RapPort virtual directory:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Expand the server name.
  3. Right-click the RapPort node under Default Web Site, and then click Properties.
  4. In the RapPort Properties dialog box, click the HTTP Headers tab.
  5. Click the Enable Content Expiration check box.
  6. Click Expire Immediately.
  7. Click OK to close RapPort Properties.

To configure the default SMTP virtual server:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Expand the server name.
  3. Right-click Default SMTP Virtual Server, and then click Properties.
  4. Click the Access tab.
  5. Under Relay restrictions, click Relay. The Relay Restrictions dialog box appears.
  6. Click All except the list below.
  7. Select the Allow all computers which successfully authenticate to relay, regardless of the list above check box.
  8. Click OK to close the Relay Restrictions dialog box.
  9. Click the Delivery tab, and then click Advanced.
  10. In Smart host, type the name of the smart host relay server. Do not change any other settings.
  11. Click OK to close the Advanced Delivery dialog box.
  12. Click OK to close the Properties page.
  13. Close Internet Information Services.

To create a new scheduled job for AutoSetup.exe:

  1. On the Start menu, point to Settings, and then click Control Panel.
  2. Double-click Scheduled Tasks.
  3. In the Scheduled Tasks dialog box, double-click Add Scheduled Task. The Scheduled Task Wizard appears.
  4. Click Next.
  5. Click Browse. The Select Program to Schedule dialog box appears.
  6. Navigate to the \RapPort\AutoSetup folder on the drive where the RapPort server is to be installed.
  7. Select AutoSetup.exe, and then click Open to close the Select Program to Schedule dialog box.
  8. Type RapPort AutoSetup as the name of the task.
  9. Click Daily, and then click Next.
  10. In Start time, enter 12:00AM.
  11. Click Every Day.
  12. In Start date, enter the current date, and then click Next.
  13. Enter the user name of the appropriate domain account, such as domain\account_name.
  14. In Password and Confirm password, type the password for the account.

    You must change the password when the password for this account changes.

  15. Click Next.
  16. Ensure that the "Open advanced properties for this task" check box is not selected.
  17. Click Finish.
  18. Ensure that there is only one task scheduled for AutoSetup.exe.
  19. Close Scheduled Tasks.

    The default script host should be changed to cscript for executing the Microsoft Visual Basic® Scripting Edition (VBScript) files, which have the extension .vbs. This suppresses any dialog boxes shown by wscript due to use of the echo command.

To specify the default script host:

  1. On the Start menu, point to Programs, point to Accessories, and then click Command Prompt.
  2. Type wscript //H:cscript and then press ENTER.
  3. Click OK to close the Windows Script Host dialog box.
  4. Close Command Prompt.

You must configure the proxy settings for SharePoint Portal Server to use fully qualified domain names (FQDNs). You need to perform the following procedure only once.

To configure the proxy settings:

  1. On the Start menu, point to Programs, point to Accessories, and then click Command Prompt.
  2. Change to the SharePoint Portal Server \Bin directory. For example, if you installed SharePoint Portal Server in the Installation directory on drive E, change to E:\Installation\Bin. If you installed SharePoint Portal Server on drive D under Program Files\SharePoint Portal Server, change to D:\Program Files\SharePoint Portal Server\Bin.
  3. Type proxycfg –d –p proxy_server_name:port_number"*.local.domain.name;<local>" and then press ENTER.

    For example, if your proxy server name is Proxy1, the port number is 80, and the domain is adventure-works.com, type proxycfg –d –p Proxy1:80 "*.adventure-works.com;<local>"

  4. Verify that the correct settings were entered by typing proxycfg.exe
  5. Close Command Prompt.

To restart the server:

  1. Wait for 5 minutes to allow IIS to save settings.
  2. Restart the server.
  3. Repeat steps in "To check SharePoint Portal Server Web Storage System accessibility" whenever the server is restarted.

Install Template Server

This section describes the process of setting up the RapPort template server.

To configure the appropriate domain account as an administrator:

  1. Log on with a user account that is an administrator on the server.

    You should use the same domain user account and password on each server in the RapPort deployment. This domain account must be a member of the local Administrators group on each server.

  2. On the Start menu, point to Programs, point to Administrative Tools, and then click Computer Management.
  3. Expand Local Users and Groups.
  4. Click the Groups node.
  5. Double-click Administrators on the details pane. The Administrators Properties dialog box appears.
  6. Click Add.
  7. In the Select Users or Groups dialog box, type the name of the appropriate domain account.
  8. Click Check Names.
  9. Click OK.
  10. Click OK to close Administrators Properties.
  11. Close Computer Management.

To configure appropriate domain account as a coordinator on all template workspaces:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click SharePoint Portal Server Administration.
  2. Click to expand the server, and then select the workspace template.
  3. Right-click the workspace template, and then click Properties.
  4. Click the Security tab, and then click Add.
  5. In the Select Users or Groups dialog box, type the name of the appropriate domain account.

    You should use the same domain user account and password on each server in the RapPort deployment. This domain account must be a member of the local Administrators group on each server.

  6. Click Check Names.
  7. Click OK.
  8. In User or Group, select the appropriate domain account.
  9. In Role, click Coordinator.
  10. Click OK.
  11. Repeat steps 3 to 10 for each workspace template.
  12. Close SharePoint Portal Server Administration.

Install the Destination Server

This section describes the process of setting up the destination server.

To add the appropriate domain account to the local Administrators group on the server:

  1. Log on with a user account that is an administrator on the server.
  2. On the Start menu, point to Programs, point to Administrative Tools, and then click Computer Management.
  3. Expand Local Users and Groups.
  4. Click the Groups node.
  5. Double-click Administrators in the details pane. The Administrators Properties dialog box appears.
  6. Click Add.
  7. In the Select Users or Groups dialog box, select the appropriate domain account.

    You should use the same domain user account and password on each server in the RapPort deployment. This domain account must be a member of the local Administrators group on each server.

  8. Click Check Names.
  9. Click OK.
  10. Click OK to close the Administrators Properties dialog box.
  11. Close Computer Management.

To confirm SharePoint Portal Server Web Storage System accessibility:

  1. Open Internet Explorer.
  2. In Address, type http://server_name/public where server_name is the name of the destination server.
  3. If the public folder is not displayed and the computer stops responding, restart the computer and repeat steps 1 and 2. If the computer still does not respond, the Web Storage System may be corrupt. In this case, rebuild the computer and install SharePoint Portal Server.

To copy destination server files:

  1. Open Windows Explorer.
  2. Copy the RapPortDestinationServerFiles.zip file to the root of the local hard disk on which the destination server is to be installed.
  3. Extract all files from this zip file to the root of the local hard drive on which the destination server is to be installed.
  4. Close WinZip.

    Do not move or rename this folder or any subfolders or files.

  5. Verify that the following folders and files exist in the folder:

    RapPort

    • AssignCoordinatorRole-Script.vbs
    • ExecutionPermission-Script.vbs
    • CreateVirtualServer.asp
    • Createworkspace.asp

    RapPort\Components

    • RemoteWS.dll
    • RapPortVServer.dll

    RapPort\Logs

    • No Files

    RapPort\RegistryEntries

    • DestinationRegistryEntries.reg

    RapPort\VirtualServers

    • No Files

To remove the read-only attributes for the files:

  1. Open Windows Explorer on the destination server.
  2. Right-click the RapPort folder, and then click Properties.
  3. On the General tab, select the Read-only check box. If the check box is already selected, go to step eight.
  4. Click OK.
  5. In the Confirm Attribute Changes dialog box, click Apply changes to this folder, subfolders and files.
  6. Click OK.
  7. Right-click the RapPort folder, and then click Properties.
  8. On the General tab, clear the Read-only check box.
  9. Click OK.
  10. In the Confirm Attribute Changes dialog box, click Apply changes to this folder, subfolders and files.
  11. Click OK.

To edit DestinationRegistryEntries.reg:

Incorrectly editing the registry may severely damage your system. Back up the current version of the registry before making any changes. You should also back up any valued data on the computer.

When editing the registry (.reg) files, you must enter a single \ as \\ when entering path names, for example, D:\\RapPort\\AutoSetup. Do not remove quotation marks.

  1. Open Windows Explorer, and then navigate to the RapPort\RegistryEntries folder on the drive on which the destination server is to be installed.
  2. Right-click DestinationRegistryEntries.reg, and then click Edit to open the file in Notepad.

    Do not double-click the file, because this imports the unedited registry entries contained in this file into the registry.

  3. Edit the line "Domain"="domain_name" and replace it with the actual domain for this computer.
  4. Edit the line "IP"="192.168.114.201" and replace the IP address with the actual static IP address for this computer.
  5. Edit the line "Proxy"="proxy_server" and replace the proxy server name with the actual proxy server name.
  6. Edit the line "ProxyPort"="80" and replace the proxy server port value with the actual proxy server port value. Do not change if the proxy server port is 80.
  7. Edit the line "AppPath"="D:\\RapPort" and replace D: with the actual drive letter of the drive on which the destination server is installed. Do not remove the \\ in the path.
  8. Edit the line "VirtualServersPath"="D:\\RapPort\\VirtualServers" and replace D: with the actual drive letter of the drive on which the destination server is installed. Do not remove the \\ in the path.
  9. Edit the line "LogPath"="D:\\RapPort\\Logs" and replace D: with the actual drive letter of the drive on which the destination server is installed. Do not remove the \\ in the path.
  10. Save the file.
  11. Close Notepad.

To import the RapPort server registry entries:

Incorrectly editing the registry may severely damage your system. Back up the current version of the registry before making any changes. You should also back up any valued data on the computer.

  1. Open Windows Explorer, and then navigate to the \RapPort\RegistryEntries folder on the drive on which the destination server is to be installed.
  2. Double-click DestinationRegistryEntries.reg to import the registry entries.
  3. Click Yes to add the information to the registry.
  4. Click OK.
  5. Close Windows Explorer.

To verify that registry entries have been successfully imported:

  1. On the Start menu, click Run.
  2. Type regedit and then click OK.
  3. In Registry Editor, navigate to the node:

    My Computer\HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\RapPort

  4. Click this node and confirm that all the entries are correctly shown in the right pane.
  5. Close Registry Editor. Do not change any values in the registry.

To register the RapPort DLLs:

  1. On the Start menu, click Run.
  2. Type regsvr32 drive:\RapPort\Components\RapPortVServer.dll where drive is the drive letter for the drive where destination server is to be installed.
  3. Click OK.
  4. If the following message is not displayed:

    DllRegisterServer in drive:\RapPort\Components\RapPortVServer.dll succeeded

    then repeat step 2 until the appropriate message displays. Where drive is the drive where RapPort Server is being installed.

  5. Click OK on the RegSvr32 dialog box that displays.
  6. Repeat steps 1 to 5 above for the following DLL:

    regsvr32 drive:\RapPort\Components\RemoteWS.dll

    where drive is the drive letter for the drive where destination server is to be installed.

To create a new COM+ application:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Component Services.
  2. In Component Services, expand the Component Services node and its subnodes.
  3. Click COM+ Applications.
  4. Right-click COM+ Applications, point to New, and then click Application. The Welcome to the COM Application Install Wizard appears.
  5. Click Next.
  6. Click Create an empty application.
  7. Enter RapPort as the name of the new application, and then select Server application.
  8. Click Next.
  9. Click This user.
  10. In User, enter any appropriate domain account that is a member of the local Administrators group.
  11. In Password and Confirm password, type password for the account.

    You must change this password whenever the password for this account changes.

  12. Click Next.
  13. Click Finish.

To add components to the new RapPort COM+ application:

  1. Expand the RapPort node under COM+ Applications.
  2. Click Components under the RapPort node.
  3. Right-click Components, point to New, and then click Component. The Welcome to the COM Component Install Wizard appears.
  4. Click Next.
  5. Click Import component(s) that are already registered.
  6. On the Choose Components to Import page, click RapPortVServer.CreateVServer from the list of components.
  7. Click Next.
  8. Click Finish.
  9. Repeat steps 1 through 8 above, replacing RapPortVServer.CreateVServer with RemoteWS.clsCreateWS.
  10. Confirm that all components are visible by expanding the Components node.
  11. Close Component Services.

To change the domain name for notifications:

  1. Edit CreateWorkspace.asp on the destination server
  2. Search for the string "@adventure-works.com".
  3. Change the domain name as appropriate.
  4. Save the file.

To specify logging properties for the WWW Service:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Right-click the server name, and then click Properties.
  3. On the Internet Information Services tab, in Master Properties select WWW Service.
  4. Click Edit. The WWW Service Master Properties dialog box appears.
  5. On the Web Site tab, select the Enable Logging check box.
  6. In Active log format, select W3C Extended Log File Format, and then click Properties.
  7. In the Extended Logging Properties dialog box, click the Extended Properties tab.
  8. Under the Extended Properties tree, select the Referer (cs(Referer)) check box.
  9. Click OK.
  10. If the Inheritance Overrides dialog box appears, click Select All, and then click OK. This dialog box will not appear in all cases.
  11. Click OK to close the WWW Service Master Properties dialog box.
  12. Click OK to close Properties page.

To create a new virtual directory in the Default Web Site:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Expand the server name.
  3. Right-click Default Web Site, point to New, and then click Virtual Directory. The Welcome to the Virtual Directory Creation Wizard appears.
  4. Click Next.
  5. On the Virtual Directory E-mail account page, type RapPort in the E-mail account text box, and then click Next.
  6. On the Web Site Content Directory page, click Browse, and then navigate to the \RapPort folder on the drive on which the Destination server is to be installed.
  7. Click the RapPort folder, and then click OK.
  8. Click Next.
  9. On the Access Permissions page, click Next. Do not change the default access permissions.
  10. Click Finish.

To configure properties for the Default Web Site:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Expand the server name.
  3. Right-click Default Web Site, and then click Properties.
  4. On the Web Site tab, select (All Unassigned) from IP Address.
  5. In TCP Port, type 80.

To configure properties for the RapPort virtual directory:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Expand the server name. Typically, server name is same as the computer name.
  3. Right-click the RapPort node under Default Web Site of IIS, and then click Properties.
  4. In the RapPort Properties dialog box, click the HTTP Headers tab.
  5. Select the Enable Content Expiration check box.
  6. Click Expire Immediately.
  7. Click the Virtual Directory tab.
  8. Click Configuration.
  9. In the Application Configuration dialog box, click the App Options tab.
  10. On the App Options tab, change the ASP Script timeout value to 3600 seconds.
  11. Click OK to close the Application Configuration dialog box.
  12. Click the Directory Security tab.
  13. In Anonymous access and authentication control, click Edit.
  14. In the Authentication Methods dialog box, clear all check boxes except for the Anonymous access and Integrated Windows authentication check box.
  15. Click OK.
  16. If the Inheritance Overrides dialog box appears, click Select All, and then click OK. This dialog box may not display in all cases.
  17. Click to close RapPort Properties.

To configure properties for the Default Web Site/SharePoint Portal Server/ Applications virtual directory:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Expand the server name.
  3. Expand Default Web Site.
  4. Expand the SharePoint Portal Server virtual directory node.
  5. Click the Applications virtual directory node.
  6. Right-click Applications, and then click Properties.
  7. In the Applications Properties dialog box, click the Directory tab.
  8. In Execute Permissions, select Scripts only.
  9. Click OK to close the Applications Properties dialog box.
  10. Close Internet Services Manager.

The default script host should be changed to cscript for executing the VBScript (.vbs) files. This suppresses any dialog boxes shown by wscript due to use of the echo command.

To specify the default script host:

  1. On the Start menu, point to Programs, point to Accessories, and then click Command Prompt.
  2. Type wscript //H:cscript and then press Enter.
  3. Click OK to close the Windows Script Host dialog box.
  4. Close Command Prompt.

You must configure the proxy settings for SharePoint Portal Server to use fully qualified domain names (FQDNs).

To configure the proxy settings:

  1. On the Start menu, point to Programs, point to Accessories, and then click Command Prompt.
  2. Change to the SharePoint Portal Server \Bin directory. For example, if you installed SharePoint Portal Server in the Installation directory on drive E, change to E:\Installation\Bin. If you installed SharePoint Portal Server on drive D under Program Files\SharePoint Portal Server, change to the following directory:

    D:\Program Files\SharePoint Portal Server\Bin

  3. Type proxycfg –d –p proxy_server_name:port_number "*.local.domain.name;<local>" and then press ENTER.

    For example, if your proxy server name is Proxy1, the port number is 80, and the domain is adventure-works.com, type proxycfg –d –p Proxy1:80 "*.adventure-works.com;<local>".

  4. Verify that the correct settings were entered by typing proxycfg.exe.
  5. Close Command Prompt.

To restart the server:

  1. Wait for 5 minutes to allow IIS to save settings.
  2. Restart the server.
  3. Repeat steps in "To confirm SharePoint Portal Server Web Storage System accessibility" whenever the server is restarted.

Creating Workspace Templates

This section provides tips for creating workspace templates and describes the elements of the workspace that RapPort copies during the portal provisioning process.

A workspace template is a SharePoint Portal Server workspace that contains some content. RapPort replicates this workspace so that other workspaces may benefit from the thought and effort put into designing the original content. Although you can use any actual workspace as a template, consider generalizing the content before using it as a template so that the material applies to a more general audience than the original workspace. It is recommended that you limit the number of people with coordinator or author privileges on a workspace template to a small number of people.

A workspace template is stored on the template server. When a user requests a new portal, the RapPort server copies the following elements of a workspace:

  • Categories. All categories, and associated metadata
  • Schema. All profiles, attributes, and dictionary values
  • Folder Structure. All of the following folders and subfolders:

    http://server_name/workspace_name/Documents

    http://server_name/workspace_name/Portal Content

    http://server_name/workspace_name/Portal/Resources/RapPort

    http://server_name/SharePoint Portal Server/Public/Applications/workspace_name.

    RapPort does not maintain approval routes on folders. You must reapply approval settings on all folders.

  • Security Settings. RapPort assigns coordinators, authors and readers at the workspace level based on the information provided by the person requesting the portal.
  • By default, folders inherit security from the parent folder. Therefore, these settings apply throughout the workspace. It is not recommended that you apply security at the document or individual folder level when creating a template because role settings can vary according to each group's needs.

    RapPort does not copy individual document or folder security settings when replicating a template.

  • Documents. RapPort copies only the latest version of all documents stored in the folders listed previously.

    Version history is not copied.

    RapPort identifies all documents as checked-in or published preserving the setting from the workspace template. If a published document is checked out in the template workspace, RapPort copies the latest published version. If a checked-out document in the template workspace was never published, then RapPort copies the last checked-in version. If a document in the template workspace was never checked in, RapPort copies the checked-out version but marks it to checked-in in the new workspace.

  • Dashboard site and Web Parts. RapPort copies all dashboards and related Web Parts.

    RapPort does not copy content source settings. Most organizations do not need to crawl the same content from multiple portals. For more information about using content sources to crawl content, see Chapter 6, Planning a Deployment. RapPort also does not copy discussions or subscriptions because the users for the new workspace can differ than those from the template.

To create a workspace template:

  1. On the template server, create a new workspace or copy an existing workspace from another SharePoint Portal Server computer.
  2. Customize the workspace to reflect the appropriate settings for the template. This may include customizing the dashboard site, creating a category structure, or adding specific content. If you copied an existing workspace, remove all inappropriate content, verify that you checked in, or published all documents, and specifying security at the top of the workspace and modifying inheritance.

For more information about creating workspaces and customizing them, see Appendix B.

Removing RapPort

This section describes the process of removing the RapPort application from your computer.

Remove the RapPort Server

You must log on with the appropriate domain account to perform the following procedures.

To delete the RapPort AutoSetup scheduled job for AutoSetup.exe:

  1. On the Start menu, point to Settings, and then click Control Panel.
  2. Double-click Scheduled Tasks.
  3. In the Scheduled Tasks window, right-click the scheduled job RapPort AutoSetup, and then click Delete.
  4. In the Confirm File Delete dialog box, click Yes.
  5. Close Scheduled Tasks.

To delete the RapPort COM+ application:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Component Services.
  2. In Component Services, expand the Component Services node and its subnodes.
  3. Right-click the RapPort application node, and then click Delete.
  4. In the Confirm Item Delete dialog box, click Yes.
  5. Close Component Services.

To unregister the RapPort DLLs:

  1. On the Start menu, click Run.
  2. Type regsvr32 -u drive:\RapPort\AutoSetup\Components\assignRoles.dll

    where drive is the drive letter for the drive where RapPort server is installed.

  3. Click OK.
  4. In the RegSvr32 dialog box, click OK.
  5. Repeat steps 1 through 4 for each of the following DLLs, typing the following in step 2:
    • regsvr32 -u drive:\RapPort\AutoSetup\Components\SCM.dll
    • regsvr32 -u drive:\RapPort\AutoSetup\Components\TemplateInst.dll
    • regsvr32 -u drive:\RapPort\AutoSetup\Components\WrapperTemplateInst.dll
    • regsvr32 -u drive:\RapPort\RapPortWeb\Pages\AD\COM\ActiveDir.dll

To delete the virtual directory for RapPort in the default Web site:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Expand the server name.
  3. Expand Default Web Site.
  4. Right-click the RapPort virtual directory, and then click Delete.
  5. In the Internet Services Manager dialog box, click Yes to confirm the delete.
  6. Close Internet Information Services.

To delete the RapPort server registry entries:

Incorrectly editing the registry may severely damage your system. Back up the current version of the registry before making any changes. You should also back up any valued data on the computer.

  1. On the Start menu, click Run.
  2. Type regedit and then click OK.
  3. In Registry Editor, navigate to the node:

    My Computer\HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\RapPort

  4. Right-click the RapPort node, and then click Delete.
  5. In the Confirm Key Delete dialog box, click Yes.
  6. Close Registry Editor.

To restart the server:

  1. Wait five minutes to allow IIS to save settings.
  2. Restart the server.

To delete the RapPort folder:

  1. Open Windows Explorer.
  2. Navigate to the RapPort folder on the drive on which the RapPort server is installed.
  3. Right-click the RapPort folder, and then click Delete.
  4. In the Confirm Folder Delete dialog box, click Yes.
  5. Close Windows Explorer.

Remove the Template Server

There is no procedure for removing the template server. You can remove the administrator account from each workspace and from the local Administrators group on the template server. You assigned this account to the role of coordinator for the workspace when setting up the template workspace. There is no technical requirement to remove this account.

Remove the Destination Server

This section describes the process of removing RapPort from a destination server.

Removing RapPort from a destination server does not remove any workspaces or virtual servers already created on the destination server.

To delete any RapPort-created site, first delete the virtual server associated with the Web site, and then delete the workspace associated with the Web site.

To delete the virtual server associated with this workspace, use Internet Services Manager.

To delete the workspace created by RapPort, use SharePoint Portal Server Administration. For more information about deleting RapPort-created Web sites, see "Delete a workspace and associated virtual server."

When removing RapPort from a destination server, you must manually configure the Home directory redirection property for all existing virtual servers. This is because the folder that contains the redirection default.asp pages for the RapPort created virtual servers is deleted when you remove RapPort. For more information about how to manually configure the redirection, see Chapter 12, Deploying SharePoint Portal Server in an Extranet Environment.

This section assumes that you installed the Destination server in accordance with the preceding installation instructions.

You must log on with an administrator account to perform the following procedures.

To delete the RapPort COM+ application:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Component Services.
  2. In Component Services, expand the Component Services node and its subnodes.
  3. Right-click the RapPort application node, and then click Delete.
  4. In the Confirm Item Delete dialog box, click Yes.
  5. Close Component Services.

To unregister the RapPort DLLs:

  1. On the Start menu, click Run.
  2. Type regsvr32 -u drive:\RapPort\Components\RapPortVServer.dll

    where drive is the drive letter for the drive where destination server is installed.

  3. Click OK.
  4. In the RegSvr32 dialog box, click OK.
  5. Repeat steps 1 through 4 for the following DLL, typing the following in step 2: regsvr32 -u drive:\RapPort\Components\RemoteWS.dll

To delete the virtual directory for RapPort in the default Web site:

  1. On the Start menu, point to Programs, point to Administrative Tools, and then click Internet Services Manager.
  2. Expand the server name.
  3. Expand Default Web Site.
  4. Right-click the RapPort virtual directory, and then click Delete.
  5. In the Internet Services Manager dialog box, click Yes to confirm the delete.
  6. Close Internet Information Services.

To delete registry entries:

Incorrectly editing the registry may severely damage your system. Back up the current version of the registry before making any changes. You should also back up any valued data on the computer.

  1. On the Start menu, click Run.
  2. Type regedit and then click OK.
  3. In Registry Editor, navigate to the node:

    My Computer\HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\RapPort

  4. Right-click the RapPort node, and then click Delete.
  5. In the Confirm Key Delete dialog box, click Yes.
  6. Close Registry Editor.

To restart the server:

  1. Wait five minutes to allow IIS to save settings.
  2. Restart the server.

To delete the RapPort folder:

  1. Open Windows Explorer.
  2. Navigate to the RapPort folder on the drive on which the Destination server is installed.
  3. Right-click the RapPort folder, and then click Delete.
  4. In the Confirm Folder Delete dialog box, click Yes.
  5. Close Windows Explorer.

Previous page
Table of content
Next page
Microsoft Sharepoint Portal Server 2001 Resource Kit
Microsoft SharePoint(TM) Portal Server 2001 Resource Kit (Examples & Explanations Series)
ISBN: 0735615624
EAN: 2147483647
Year: 2001
Pages: 231
Authors: Microsoft Corporation
BUY ON AMAZON
Beginning Cryptography with Java
Data Structures and Algorithms in Java
Service-Oriented Architecture (SOA): Concepts, Technology, and Design
Microsoft VBScript Professional Projects
The Lean Six Sigma Pocket Toolbook. A Quick Reference Guide to Nearly 100 Tools for Improving Process Quality, Speed, and Complexity
User Interfaces in C#: Windows Forms and Custom Controls
flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net
Privacy policy