This action might not be possible to undo. Are you sure you want to continue?
Information in this document, including URL and other Internet Web site references, is subject to change without notice. No part of this document may be reproduced or transmitted in any form or by any means for any purpose without the express written permission of Cerience Corporation. RepliGo is a trademark of Cerience Corporation. Microsoft®, Windows®, PowerPoint®, Excel®, Access™, Visio®, Outlook® and SharePoint® are registered trademarks of Microsoft Corporation. The names of actual companies and products mentioned herein may be the trademarks of their respective owners. © 2000-2007 Cerience Corporation. All rights reserved.
3307 South College Avenue, Suite 200 Fort Collins CO 80525 Phone: +1 (970) 282-3850 Fax: +1 (720) 528-8005 Email: email@example.com Web site: http://www.cerience.com
Phone: +1 (970) 282-3850 Phone: +1 (800) 403-1495 Email: firstname.lastname@example.org Cerience Support Center: http://support.cerience.com
Table of Contents
Introduction ................................................................................. 5 Overview .................................................................................. 5 Architecture .............................................................................. 6 Components of RepliGo Server ........................................................ 7 Planning...................................................................................... 8 System requirements ................................................................... 8 Determining disk space requirements................................................ 8 Deployment options ..................................................................... 9 Using Microsoft Office 2007 or the built-in converter ............................11 Installing ....................................................................................12 Installing a local RepliGo Server .....................................................12 Installing a remote RepliGo Server ..................................................14 Installing Microsoft Office 2007 for document conversion.......................16 Upgrading the server...................................................................18 Upgrading the client ...................................................................18 Uninstalling..............................................................................19 Backup & Restore and Migrating ........................................................20 Using the Backup tool..................................................................20 Backup & Restore.......................................................................21 Migrating .................................................................................21 Using the Administrator ..................................................................24 Accessing the server ...................................................................24 Changing the Administrator’s password ............................................25
Managing Users ............................................................................26 Overview .................................................................................26 Importing users .........................................................................26 Adding or modifying a user ...........................................................28 Deleting a user..........................................................................29 Assigning network access..............................................................29 Deploying the RepliGo Professional client..........................................29 Updating a user’s device ..............................................................30 Configuring RepliGo Server ..............................................................31 Configuring document storage and conversion ....................................32 Configuring email sending.............................................................33 Configuring fax sending ...............................................................34 Configuring browser and Microsoft SharePoint integration ......................35 Advanced Configurations.................................................................37 Architecture .............................................................................37 Standalone and clustered configurations ...........................................38 Guidelines for determining your configuration ....................................39 Installing a clustered RepliGo Server................................................41 Troubleshooting ...........................................................................44 Accessing server log files..............................................................44 Accessing server information .........................................................45 Frequently Asked Questions ..........................................................47 Technical Support resources..........................................................48
while giving your mobile workforce reliable and secure access to critical business information. . Restart the BlackBerry Controller Service on your BES machine.ppt*. .ods. . Choose a machine to install RepliGo Server on and verify that it meets the system requirements. It requires very little effort to install and maintain. .csv) Text files (.txt) OpenOffice.jfx) Corel® WordPerfect® (.pdf) Microsoft Word. . Deploy the RepliGo Professional Enterprise client to your users. . . taking the option to install the BlackBerry Enterprise Server extension only. 7. For Lotus Domino. 6. . you will need to restart your Domino Server.pdf.bmp.xls*. 4.wpd) Rich Text Format (RTF) files (. 5. RepliGo Server supports rich document and email attachment viewing of the following formats: • • • • • • • • • Adobe® PDF (. . Locate your BlackBerry Enterprise Server (BES) and make sure that BlackBerry Mobile Data Services/System (MDS) is running and enabled for each user that will utilize the solution. Use the RepliGo Server Administrator application to add or import users into RepliGo Server.org Calc.odt) Image files (. 1 Support for Office 2007 formats requires the installation of Office 2007. If you chose to install RepliGo Server on a separate machine from BES.dot*.Introduction Introduction Overview RepliGo Server brings true document viewing to your company’s BlackBerry users.jpg. 3. RepliGo Server can be installed entirely on your BES or you can offload it to another machine. . Log onto the RepliGo Server machine with local Administrator rights and install RepliGo Server. Excel and PowerPoint 2007 and earlier (.png. .tif) To get started you will perform the following tasks: 1.doc*.pps*) 1 Fax files (.tif.odp. .rtf) Comma Separated Value (CSV) files (.gif. . then you will need to run the installer on your BES machine as well. 2. Impress and Writer (. Currently. Office 2003 and earlier formats do not require the installation of additional software.
RepliGo Server Internet RepliGo Client Firewall Wireless Network BlackBerry Enterprise Server Email Servers Application Servers Figure 1 On the device side. the user simply selects ‘Open with RepliGo’ (see Figure 2) to open the attachment. Figure 2 . RepliGo Professional communicates securely over the MDS to retrieve bookmarks and pages down to the device. If a message contains an attachment that RepliGo Server understands. then the attachment is stored in RepliGo Server and a small link is appended to the message before it travels down to the device. When an email with an attachment is received on the device. RepliGo Professional Enterprise Edition integrates seamlessly with the BlackBerry email client to provide quick and convenient access to documents.Introduction Architecture RepliGo Server integrates directly with BES and processes messages as they are delivered to a BlackBerry device (see Figure 1).
the Worker and the BES Extension. All of these components can reside on the same machine—configured in a low cost. . The Controller and Worker is the core of RepliGo Server. The RepliGo Controller and Worker can be installed on your BES or on a dedicated machine. These three components work together to integrate with your BES. while the Worker performs the conversion of documents into the optimized RepliGo format. The Controller provides the management of documents and communication within the system. and to manage the RepliGo system (see Figure 3). convert documents to a format optimized for the BlackBerry device. BlackBerry Enterprise Server Extension RepliGo Controller RepliGo Worker Figure 3 The Extension is a lightweight DLL that provides the BES integration and is specifically design to minimize the impact on your BES.Introduction Components of RepliGo Server RepliGo Server is comprised of three server-side components: the Controller. The Extension must reside on the same machine as your BES. easy to administer configuration—or be deployed on a separate machines to allow higher performance and scalability.
performance and ease of administration. Example for calculating the required disk space Suppose you have 10 BlackBerry users. These options provide flexibility so that you can optimize your RepliGo solution in terms of cost.Planning The document cache is a temporary store used to hold copies of attachments that have been sent to users. In addition.230 MB 10 x 500 5000 MB 500 x 2 1. You can assign the caching period using the web browser-based Administrator application. The amount of space reserved per user can be assigned using the Administrator application as well. The document cache calculation would be: Size of Documents Processed over cache period (MB) Multiple Factor (x 2) Total The document storage calculation would be: Number of Users Disk Space per User Total The total disk space calculation would be: Item Installation Document Cache Document Storage Total Disk Space (MB) 230 +1.000 MB Deployment options There are several deployment options with RepliGo Server. The default value for this is 7 days. See the “Configuring document storage and conversion” section for more information. that on average. The default value for this is unlimited. and that you want to cache documents for 7 days (default) and allow 500 MB of personal document storage per user. See the “Configuring document storage and conversion” section for more information.000 6. The recommended disk space to reserve for the cache is one to two times the total attachment throughput of your BES for supported over the caching period. the total size of attachments processed through your BES over this seven day period is 500 MB. . The document storage space is used to persist documents your users have selected as saved documents.000 +5.
• • Most situations will operate effectively with the simplest configuration of RepliGo Server installed on the same machine as BES. Note When installing RepliGo Server on a separate machine from BES. The default ports for RepliGo Server are 4080 through 4083. If usage is limited to a small number of documents per hour. make sure that your BES machine has HTTP access to the RepliGo Server machine over the ports you chose during installation. Guidelines for determining your configuration Use the following guidelines to help in deciding which configuration will provide the best solution for your environment. If the document-processing load is not excessively high. you may wish to consider one of the other options. RepliGo Server has been designed to support the use of multiple dedicated machines. Multiple RepliGo Server machines For environments with a very large number of BlackBerry users. A single RepliGo Server should only service multiple BlackBerry Enterprise Servers if they are all geographically co-located and on the same physical network. Configuring the RepliGo Controller and Worker(s) to run on separate machines adds cost and administration. Multiple BlackBerry Enterprise Servers Some larger BlackBerry deployments may have multiple BES machines in a single location. • • . See the “Advanced Configurations” section for more information. increasing document response times. then the preferred solution is to use a dedicated machine for RepliGo Server. you need to make sure that your BlackBerry devices have similar access to the RepliGo Server machine. Using a RepliGo Server that is not on the same physical network as the BES will incur network delays. If your BES serves more than 250 users then you may benefit by moving RepliGo Server onto a dedicated machine. The choice you make depends on several variables including the anticipated usage level of the RepliGo Server solution and the amount of hardware investment you wish to make. a single RepliGo Server can be installed to service two or more of these BlackBerry Enterprise Servers. If usage is higher or your BES is making high use of the machine it is on. it is generally preferable to install RepliGo Server local to your BES. Furthermore. If the load on your BES is high. The load level depends on a number of factors such as the number of users and their level of activity.Planning Local or remote machine RepliGo Server can be installed on the same machine as your BES so that it is local to BES or on a separate machine so that it is remote to BES. This can be done by installing the Controller and Worker components on separate machines. This is generally only recommended for environments with 1000 or more users.
such as high performance and requiring no additional software. However. occasionally there are minor variances within the document from how they appear in Microsoft Office. RepliGo Server may not operate correctly with other language versions of Office. To support these XML-based file formats and avoid occasional minor variances. the English language version of Office 2007 must be installed.Planning Using Microsoft Office 2007 or the built-in converter The standard configuration of RepliGo Server includes a built-in converter for handling Office documents when creating RepliGo formatted files. . In addition. the built-in engine does not include support for the XML-based Office 2007 file formats. you can configure RepliGo Server to use Office 2007 in the conversion process so that the resulting document most accurately reflects what is seen in Office itself. In addition. In order to utilize Microsoft Office 2007 during document conversion. Office 2007 must be installed on the same machine that is performing the document conversion for RepliGo Server. This built-in converter has several advantages.
5. Note If you are installing RepliGo Server on a different machine than BES. Verify network access over the configured port from your BlackBerry device to the target RepliGo Server machine. Complete the following install screens.exe file. Screen License Agreement Values — Actions ► Read the License Agreement. Install RepliGo Server 4. 3. Install Options Install RepliGo Server Install only the BlackBerry Enterprise Extension Operation Mode Controller Worker Configuration Options Server Ports ► Click Install RepliGo Server. Verify that the target RepliGo Server machine meets the system requirements. ► Enter the first of four consecutive ports for RepliGo Server. skip to the section “Installing a remote RepliGo Server” below. ► Click I Agree. ► Enter the target folder for the installation. ► Enter the account information for the RepliGo Server Administrator application. 2. ► Click both Controller and Worker. Pre-installation 1.Installing Installing Installing a local RepliGo Server This section provides the instructions for installing RepliGo Server on the same machine on which your BES resides. User name and password Install Location C:\Program Files\RepliGo Server . close all other applications and run the Setup. Verify that your BES has BlackBerry Mobile Data Services/System (MDS) running and enabled for each user that will utilize the solution. On your BES machine.
For Lotus Domino. 9. you will need to restart your Domino Server.Installing Post installation 6. Install Microsoft Office 2007. See the “Installing Microsoft Office 2007 for document conversion” section. 7. if you have chosen that option. 8. Configure RepliGo Server using the Administrator application to add or import users and to assign settings. . See the “Deploying the RepliGo Professional client” section for more information. Deploy the RepliGo Professional client to your users. Restart the BlackBerry Controller Service on your BES machine. This must be done on each BES machine that RepliGo Server will be supporting.
3. ► Click I Agree. Operation Mode Controller Worker Configuration Options Server Ports ► Click both Controller and Worker. User name and password Install Location C:\Program Files\RepliGo Server .Installing Installing a remote RepliGo Server This section provides the instructions for installing RepliGo Server on a machine other than the one where your BES resides. Note If you are installing RepliGo Server on the same machine as BES. 2. ► Enter the first of four consecutive ports for RepliGo Server. Pre-installation 1.exe file to start the RepliGo Server Installation Wizard. Verify that your BlackBerry device has similar access to the RepliGo Server machine. ► Enter the account information for the Administrator application. Install RepliGo Server 4. inclusive. Close all other applications and run the Setup. ► Enter the target folder for the installation. refer to the section “Installing a local RepliGo Server” above. Verify that your BES has access using the first of the four RepliGo Server ports. b. Screen License Agreement Values — Actions ► Read the License Agreement. Complete the following install screens. 5. Verify network access over the configured port from your BES to the target RepliGo Server machine. This should be done on each BES machine that RepliGo Server will be supporting. Verify that your BES has BlackBerry Mobile Data Services/System (MDS) running and enabled for each user that will utilize the solution. Verify that the target RepliGo Server machine meets the system requirements. The default ports are 4080 through 4083. a.
11. close all other applications and run the Setup. On your BES machine. See the “Installing Microsoft Office 2007 for document conversion” section. Complete the following install screens. you will need to restart your Domino Server. and restart your BlackBerry Controller Service prior to configuring RepliGo Server and deploying the client. if you have chosen that option. Install only the BlackBerry Enterprise extension • RepliGo Server Host • RepliGo Server Port Post installation 8. ► Click I Agree. Install Microsoft Office 2007. 7. including the install of the extension.exe file. For Lotus Domino. 10. ► Enter the server host name and the first of the four assigned ports. Configure RepliGo Server using the Administrator application to add or import users and to assign settings. This must be done on each BES machine that RepliGo Server will be supporting. Deploy the RepliGo Professional Enterprise client to your users. Install Options Install RepliGo Server ► Click Install only the BlackBerry Enterprise extension. See the “Deploying the RepliGo Professional client” section for more information. 9.Installing Note You must complete the install of RepliGo Server. Install the BlackBerry Enterprise Server Extension 6. Screen License Agreement Values — Actions ► Read the License Agreement. . Restart the BlackBerry Controller Service on your BES machine.
select the Customize option. After assigning all of the above. Note The English language version of Office 2007 must be installed. ► Accept all defaults. ► Select Not Available. allow the install to complete.Installing Installing Microsoft Office 2007 for document conversion Install Office 2007 1. Once you have verified this. ► Select Not Available. ► Select Not Available. except Euro Currency Tools Euro Currency Tools Sample Files Outlook PowerPoint — Organization Chart Add-in for Microsoft Office programs — — — International Support | Japanese Font Microsoft Office Document Imaging | Microsoft Office Document Image Writer Actions ► Select Not Available. 3. . RepliGo Server may not operate correctly with other language versions of Office. On the “Choose the installation you want” screen. Note Not installing some options may cause one or more of the Office application not to function properly. 2. review the options to ensure that no component is set to “Install on First Use”. Publisher Visio Viewer Word Office Shared Features Office Tools ► Select Not Available. Program Access Excel Values — All Add-ins. On the Install Options screen. Be sure to install the options as specified above to ensure that RepliGo Server can successfully use Microsoft Office during document conversion. ► Select Run from My Computer. ► Select Not Available. ► Select Run from My Computer. ► Select Not Available. select the options for each program as listed in the table below. On the RepliGo Server machine that will be performing document conversion. close all other applications and run the Microsoft Office 2007 installer. ► Select Run from My Computer.
Restart RepliGo Server. click on the Tools tab. Excel and PowerPoint—to activate and initialize it. Manually launch each of the Office applications—Word. Install the Office 2007 “Save as PDF or XPS” add-in. Double click on the . In the “Sign up for Microsoft Update” screen. Click on this link to download the add-in installer. it is recommended that you select the “I don’t want to automatically update” option. 6. you should review updates as they become available to decide whether you should accept the update or not. . Set the “Document Conversion” value to “Convert documents on this computer using Microsoft Office 2007.exe and follow the instructions to install it. 5. and then click on the Document Handling icon. Instead.” 7.Installing Post installation tasks 4. In the Administrator application.
2. select the Save menu item. use the upgrade installer. they only need to select the Refresh menu from within RepliGo to restore access to their documents. 4. such as emailing and faxing. 3.0 . On their BlackBerry in the Messages application. This change enables advanced features such as emailing and faxing of documents. This provides the benefit of preserving access their saved document. Upgrading the client RepliGo 2. Over-the-air Installation If you are using an over-the-air (OTA) install to upgrade your users’ RepliGo client.0. because some new features. This upgrade installer will handle the upgrade from all previous versions of RepliGo Server.0 client.0 client as well. all you need to do is to send out a new deployment message using the Administrator application. Delete the document from their device. Desktop Manager installation Unlike the OTA deployment. regardless of software/hardware changes or upgrades. one of which is to save documents on the server instead of the device. any documents that users may have saved on their devices will be present in the 2. highlight the email and select “Open with RepliGo”.0 includes many changes.Installing Upgrading the server Upgrading has been simplified in RepliGo Server 2. documents saved device-side with the 1. In RepliGo. if users switch to a different device or have their device wiped. the RepliGo client will not run. so your users do not need to uninstall their existing client prior to installing the 2.x client will not work with these new features. installing via the Desktop Manager requires that any existing 1.x client is not uninstalled prior to installing the 2. Rather than using the standard installer. Email the original document as an attachment to their device. require access to the document on the server. The OTA install supports installing the new client on top of an existing client. In addition. Note If the 1. Because the 1. However. they should follow the steps below: 1. any documents your users may have saved on their devices will be deleted and no longer accessible in the RepliGo 2. If your users wish to use these features with existing documents.x client is being uninstalled.0 client.0.x client be uninstalled prior to installing the 2. When installing over the top of an existing client. This guarantees that your users will never lose access to any of their saved documents.
5. have the user email the original document as an attachment to their device. stop the BlackBerry Controller and the Windows Management Instrumentation service. See the “Configuring browser and Microsoft SharePoint Integration” section for more information on browser integration. Users who wish to preserve access to their saved documents can follow the steps below: 1. 2. Have the user note the documents saved on their device that they want to continue accessing. highlight the email with the attached document and select the “Open with RepliGo” menu item. Uninstall the RepliGo Professional 1. Highlight the document in the list and select the “Save” menu item. 3. 2. If you have configured RepliGo Server to run remote to your BES. On their device. 3. including RepliGo Server. you must modify your BES transcoder configuration file to revert to the default BlackBerry transcoder. On the remote machine you do not need to stop any services. Add the appropriate tags and click the “Save” button.Installing client. 4. Follow the steps below to uninstall RepliGo Server. Run the RepliGo Server uninstaller.x client. Uninstalling Uninstalling RepliGo Server is a simple process that requires minimal offline time of your BlackBerry Controller. Install the RepliGo Professional 2. 1. Note If you had previously enabled browser integration for RepliGo. For any documents they listed above.0 client. 4. prior to running the uninstaller. run the RepliGo Server uninstaller on that machine as well. Restart the BlackBerry Controller and the Windows Management Instrumentation service. . 6. On your BES machine.
Larger than this. If you wish to maintain user access to these documents on the new server. you should leave this option checked. optionally. and high-use periods in your organization. If the new RepliGo Server installation will have a different set of users than the existing one. To determine whether you should leave this option enabled. Periodically. check the size of the directory webapps\srvcore\WEB-INF\srv\data and its contents under the RepliGo Server installation directory. This information is also available in the Administrator application. on the Backup and Restore page. the archival time becomes long and it becomes more practical to transfer the directory structure manually. Stored documents are those that users have selected for long-term storage using the RepliGo Save command on their devices. then the cache should be copied after the settings archive . but are managed by the user allotted space assigned on the "Tools > Document Handling > Document Storage" page of the Administrator application. to minimize the amount of down time for RepliGo Server. These documents not affected by the aging period. Practical considerations In high usage installations. Document cache and user storage There are two options available on the first screen of the Backup wizard. then you may want to leave this option checked. then you should not transfer the document cache. If you decide to exclude document cache from the settings archive. and you wish to maintain their access to recent attachments that may be in their Inbox. This tool will archive all configuration settings and. entries older than the specified aging period are deleted. Guide your actions considering down-time. under the Tools tab. To determine out how large the document cache has grown. These options are for the document cache and the user document storage. the document cache and your users’ saved documents. network traffic. RepliGo Server may cache many MB of documents. please refer to the “Practical Considerations” section below. The Backup program can archive up to approximately 4 GB of cached document data. The document cache is temporary storage within RepliGo Server that holds copies of documents that passed through the BlackBerry Enterprise Server mail system while RepliGo Server is installed. Documents and their intermediate results from RepliGo conversion are stored here for quick access by BlackBerry devices.Backup & Restore and Migrating Backup & Restore and Migrating Using the Backup tool RepliGo Server provides a tool to ease the task of performing Backup & Restore and for migrating to a new machine. even GB quantities over the document cache-aging period. If the current set of users will be moved to the new RepliGo Server. and allow you to save or omit this data from the settings archive.
Any attachments that pass through your BES while RepliGo Server is stopped will not be viewable by RepliGo. 2. Migrating Use the Backup tool to migrate RepliGo Server to a new machine. Since the cache holds a snapshot of the current set of documents. Restoring RepliGo Server 1. This will create a single. stop RepliGo Server. On the RepliGo Server computer. Note Running the Backup tool requires stopping the RepliGo Server. Backing up RepliGo Server 1. Migrating RepliGo Server 1. and simply copy the directory structure in Windows Explorer over the network. On the new computer. See the “Installing” section for more information on installing RepliGo Server. Backup & Restore For the backup operation. 3. This will restore your saved settings onto the new computer. This should be done prior to restarting RepliGo Server. Restart RepliGo Server. stop RepliGo Server.exe” archive. Start the RepliGo Server Backup application. 2.exe”. have your users forward the email with the attachment to themselves. Run the “Restore RepliGo Server Settings. This is useful converting to new hardware or when reconfiguring RepliGo Server from local to remote to your BES. . self-extracting executable archive named “Restore RepliGo Server Settings. these are unlikely to be applicable at some future date.Backup & Restore and Migrating executable has been run on the new installation. One method to copy the cache would be to make the data directory on the new installation a network share. On the RepliGo Server computer. 3. To make these accessible to RepliGo. Restart RepliGo Server. run the RepliGo Server installer. it is recommended to disable the saving of the document cache. Please contact Cerience technical support for assistance if you have questions regarding moving RepliGo Server installations. This can be accessed by selecting “Start > All Programs > RepliGo Server > Backup”.
The extension must be update to point to the newly installed RepliGo Server.exe” archive.exe”. Note You must keep the same port value. If you are running RepliGo Server remote to your BES. 3. under the IT Policies. a. regardless of whatever ports you assigned in the new install. return to your BES machine and continue with steps 9 and 10. stop the newly installed RepliGo Server using the Windows Services control panel. where <hostname> is the hostname of the server and <port> is the first of the four ports assigned to RepliGo Server. On the new computer. If you are running RepliGo Server local to your BES. This will create a single. restart RepliGo Server. On the new computer. 7. Assign its values to <hostname>:<port>. . even if you delete it from the BES Administrator. self-extracting executable archive named “Restore RepliGo Server Settings. 5. This has the effect of instructing the RepliGo client to ignore this policy. 11. Once this policy has been pushed to the device. 8. which will overwrite whatever values you entered when installing the new RepliGo Server. b. This can be accessed by selecting “Start > All Programs > RepliGo Server > Backup”.Backup & Restore and Migrating 2. select the User Defined Items property and create a policy named “RepliGo Server”. This may need to be done for multiple groups to ensure that all RepliGo users are updated. it will remain on the device. See the “Change or delete IT policy rules for custom applications” section in the BES administrator’s guide for more information on creating IT policies. you should leave the policy defined and clear its value in the BES Administrator. you have completed the archive migration and should skip to step 11. In the BES Administrator application. stop RepliGo Server. 9. The default first port for RepliGo Server is 4080. On your BES machine. Run the “Restore RepliGo Server Settings. Restart your BES controller. You can optionally create a BES IT policy to make the RepliGo client aware of the new RepliGo Server machine. 4. Start the RepliGo Server Backup application. The configuration archive includes the port values from your previous install. Copy this archive to the new computer. On the existing RepliGo Server computer. 6. Modify the machine name portion of the “Server” value to specify the new RepliGo Server computer. If you decide at some future time that you no longer wish to use this policy. This will restore your saved settings onto the new computer. 10. open the registry and navigate to the key “HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerry Enterprise Server\Agents\Plugins\CerBESExt”.
.Backup & Restore and Migrating Note If you choose not to create the IT Policy. until a new attachment is opened by RepliGo. See the “Configuring browser and Microsoft SharePoint Integration” section for more information on browser integration. If you are also moving your BES and had previously enabled browser integration for RepliGo. Moreover. you must reconfigure the browser transcoder settings. saved documents will also not be accessible to users. 12. email attachments that were processed prior to the server migration will no longer be accessible.
monitor usage.Using the Administrator The Administrator is organized by the tabs along the upper portion of the page. Figure 5 . By clicking on the tabs you will be presented with pages that allow you to administer users. Changing the Administrator’s password The Change Password page allows you to change the account password for the Administrator application (see Figure 5). configure RepliGo Server. and find help and support information.
Managing Users Managing Users Overview Users must be added to RepliGo Server in order to access their documents. importing. which have been activated and have used the service (Activate). The Users page will also help you deploy the RepliGo Professional client to your users’ handhelds (see Figure 6). and PIN. and which have been added but not yet sent a deployment email (New). . The “Status” column shows which users have had a deployment email sent to their device (Deployed). Clicking on the “Import Users” button will display the first of two Import Users pages (see Figure 7). deleting and editing users. A user is identified by their name. email address. Figure 6 Importing users The Administrator provides a convenient method to import users directly from your BES user database. Click on the “Users” tab to access the Users page and perform operations such as adding. Your license will dictate how many users you can add to the system.
Configuring RepliGo Server Figure 7 Fill in the connection information and then click the “Continue” button to view the next page and select the users you want to import (see Figure 8). .
When you have finished choosing users.Managing Users Figure 8 Use the panel on the left to choose which users you wish to add to the RepliGo Server user list. email address or PIN (see Figure 9). You can select multiple users by using the SHIFT or CTRL keys. Adding or modifying a user Click the “Add” button to add a single user or click on a user’s name to modify their information. The “Available Users” list will only show you users that are not already in the system. If you mistakenly add a user. click the “OK” button and they will be added to the list of users on the Users page. This will display the Add User page that will allow you to edit their name. Highlight a user and click the “Add” button to copy them to the “Selected Users” list. . select them from the list and click the “Remove” button.
. and then click the “Go” button. Deploying the RepliGo Professional client Once you have added users to the system. In larger organizations. this list may be too large to display or too cumbersome to navigate. Click on the dropdown list and choose “Delete Selected”. Select the new users you have added by checking the checkbox next to their name. select the user by checking the checkbox next to their name. To change the network access for a user. This will display the Deploy page (see Figure 10). Assigning network access The Network Access column displays whether access to shared folders on the network is enabled for that user. check the checkbox next to their name. and then click on the “Go” button. the next step is to provide them with the RepliGo Professional client for their BlackBerry device. Note Enabling Network Access will display all computers in a domain or workgroup. This feature is only recommended for small to medium sized networks where these issues do not exist. Choose the “Deploy RepliGo to Device” from the dropdown list and then click the “Go” button. choose “Toggle Network Access” from the dropdown list.Configuring RepliGo Server Figure 9 Deleting a user To delete a user.
alx file and multiple . RepliGo Server utilizes MDS to push an html message to their Inbox. To enable RepliGo for their new device simply update the PIN value in the RepliGo Server Administrator and redeploy the client to them. This message contains simple instructions and a link to download and install the RepliGo Professional client software. You may customize this message with your own information if you wish. they can select the “Refresh” menu item in RepliGo to re-enable access to their saved documents.Managing Users Figure 10 When you deploy the client to users. The contents of this message are automatically generated for you based on the settings you entered during the installation of RepliGo Server. You may distribute these files to your users and have them install the client using the Application Loader in the BlackBerry Desktop Manager. After they have installed the RepliGo client. Updating a user’s device At some point. . you may have a user who is replacing or updating their device. Search the RepliGo Server folder tree for the RepliGo Professional client modules. which are a single .cod files. An alternative method is to have your users manually install the product on their devices.
These are accessed by clicking on the “Tools” tabs and then on the various items under the Options and System sections (see Figure 11).Configuring RepliGo Server Configuring RepliGo Server There are several features. such as fax support and document emailing. Figure 11 . which you can configure using the RepliGo Server Administrator.
See the “Determining disk space requirements” section for additional information on setting the document cache and storage size values. Together these settings allow you to control the disk space required by RepliGo Server (see Figure 12). Figure 12 .Configuring RepliGo Server Configuring document storage and conversion You can control how documents are stored and converted on the Document Handling page. RepliGo Server allows you to specify the period of time for documents to be cached and the disk space for each user’s permanent document storage.
Typically. this cannot be configured on a per-user basis.1. Using Microsoft Office has the advantage of providing the most accurate conversion of your Office documents as well as supporting the new XML-based Office 2007 formats. Utilizing multiple Worker machines can also allow you to scale your RepliGo solution as your needs grow. See the section entitled “Deployment options” for more information about these different configurations.Configuring RepliGo Server You can also set whether the conversion to the RepliGo document format is done on same machine or on a separate Worker machine. However. On the Email Configuration page check the “Enable email forwarding” checkbox to enable this feature for all of your users. Unlike the Network Access feature. Figure 13 . one or more separate Worker machines can be used to offload the document processing to ensure that your overall server response times are always fast.2 or higher is installed. RepliGo Server can be configured to allow your users to use the RepliGo client to compose emails on their devices and attach documents to send to other users (see Figure 13). conversion is done on the same machine as RepliGo Server since generally the document processing load is well below the server capacity. Configuring email sending Note This feature is only available if BlackBerry Enterprise Server 4. in cases where a large number of users are supported. In addition. RepliGo Server can be configured to use Microsoft Office 2007 during the conversion of Office formats or its own build-in converter.
this cannot be configured on a per-user basis. Please refer to the administrator’s guide of your fax server or service for information on the format required for their email-to-fax support. Figure 14 . you can allow your users to easily fax documents directly from their devices. On the Fax Configuration page you can assign whether to enable faxing through RepliGo Server. as well the email format required by your fax server or service and any special instructions for the user (see Figure 14). through either an internal fax server or an external service.2 or higher is installed.Configuring RepliGo Server Configuring fax sending Note This feature is only available if BlackBerry Enterprise Server 4. If your company supports email-to-fax.1. Unlike the Network Access feature.
0 for mobile access. it is recommended that you first make a backup copy. Depending upon your install configuration. To enable this feature there are three steps which must be performed: 1. In addition.2 or higher is installed. RepliGo Server can be configured to override the viewing of documents in your user’s device browser to use RepliGo Professional client instead.xml and open it with a text editor. Typically. it also provides access to supported document types that reside in your SharePoint system. that section will be something like this: . not just the users enabled for RepliGo Server.Configuring RepliGo Server Configuring browser and Microsoft SharePoint integration Note This feature is only available if BlackBerry Enterprise Server 4. This allows viewing of documents from internal web servers as well as the Internet in the RepliGo client. find the file named httpcontenttranscoderslist. as shown in your BlackBerry Manager application. Copy the RepliGo Server transcoder to BES Copy the file transcoderRepliGo. these may be on the same machine or different machines. please contact our Technical Support team to assist you in making these changes. this feature is not enabled and requires manual configuration before being available to your users. 1. Prior to editing this file. Note Enabling this feature substitutes the RepliGo Server transcoder for the default BES version.jar from your RepliGo Server install directory to the BlackBerry Enterprise Server\MDS\classpath directory on your BES machine. This file can be found under your BES install tree in the BlackBerry Enterprise Server\MDS\Servers\<HOST>\config directory where <HOST> is the name of your BES server. Restart MDS These steps are also available on the Brower Integration page of the Administrator application. If needed. By default. Copy the RepliGo Server transcoder to BES 2. If enabled. thus changing the behavior of the browser for all users on the BES server. any document link click on in the BlackBerry browser will open the document in RepliGo. because you can configure SharePoint 3. Configure the BES transcoder configuration file 3.1. Locate the section of the XML text that describes the transcoder. Configure your BES transcoder configuration file On your BES computer. 2. Users on the BES server that are not enabled for RepliGo Server will see an error message when viewing document links in their device browser.
Restart MDS After you have made the two changes above.rim.*</accept> </device-profile-pattern> </transcoder> Once found you should either delete or "comment" it such that it is no longer in effect.rim. At this point the configuration is complete.ucs</transcoder-class> <device-profile-pattern> <accept>http://www\.Configuring RepliGo Server <transcoder> <transcoder-name>UCS</transcoder-name> <transcoder-class>vnd.*</accept> </device-profile-pattern> </transcoder> --> Once deleted or commented.net/go/mobile/profiles/uapr of/. and you should be able to browse to document links in your device’s BlackBerry Browser and have the document open in the RepliGo Professional viewer.ucs</transcoder-class> <device-profile-pattern> <accept>http://www\.blackberry\. . save the file and exit the text editor. 3. place the proper XML comment lines around that section of text so it appears like this: <!-<transcoder> <transcoder-name>UCS</transcoder-name> <transcoder-class>vnd. To comment it. add the following XML text immediately below that section: <transcoder> <transcoder-name>RepliGo</transcoder-name> <transcoder-class>RepliGo</transcoder-class> <device-profile-pattern> <accept>http://www\.*</accept> </device-profile-pattern> </transcoder> After making those changes. restart the BlackBerry MDS Connection Service in the Windows Services control panel on your BES machine.blackberry\.net/go/mobile/profiles/uapr of/.net/go/mobile/profiles/uapr of/.blackberry\.
Extension BlackBerry Enterprise Server RepliGo Controller Extension BlackBerry Enterprise Server RepliGo Worker RepliGo Worker Figure 15 . you can install the components of RepliGo Server on a single machine or distribute them across multiple machines. There can be multiple RepliGo Worker. One major advantage of this architecture is that RepliGo Server can support several different deployment strategies. • RepliGo BES Extension Provides the integration with BlackBerry Enterprise Server. With these strategies. • RepliGo Worker Performs document conversion to the RepliGo format prior to transferring documents to the device.Advanced Configurations Advanced Configurations Architecture RepliGo Server has been designed with a modular architecture which allows you to optimize the solution for your environment—for cost. This component must reside on the same machine as BES. performance and ease of administration—and to scale as your needs demand. In this architecture there are three server-side components which work together to provide the RepliGo solution. allowing you to control the performance and cost of your RepliGo Server solution. • RepliGo Controller Handles the communication with both BES and the BlackBerry devices. There can be only a single RepliGo Controller.
If the document activity level is not too high. so regardless of whether you select the standalone or the clustered configuration. This allows document conversion to be performed without affecting the responsiveness of the other processing requests. you can configure a single RepliGo Server to support some or all of these BES machines. a separate machine—one that is remote to your BES—can provide you with the best results and performance.Additional hardware required 2 Servers Required 1 High number of documents processed or high BES usage High number of documents processed and high BES usage + Limited impact on BES machine + Faster document response time. The clustered configuration allows you to offload document conversion from the Controller onto one or more dedicated Worker machines. When the RepliGo Controller and Worker are installed on separate machines. Some environments contain multiple BlackBerry Enterprise Servers co-located on the same physical network. handles higher 2+ . Standalone and clustered configurations When RepliGo Server is installed in its standard configuration. it is referred to as a clustered configuration. you can optionally configure multiple RepliGo Workers to distribute the document conversion load (see Figure 15). For larger deployments. it is referred to as a standalone configuration. This allows you to scale your RepliGo solution as your needs grow.May impact BES during heavy document processing + No impact on BES . Below is a table that describes the different configurations supported for RepliGo Server. Configuration RepliGo Server on same machine as BES • Standalone Configuration • Local to BES RepliGo Server on different machine than BES • Standalone Configuration • Remote to BES RepliGo Controller on same machine as BES RepliGo Worker(s) on different machine(s) than Situation Limited number of documents processed per hour Pluses and Minuses + Minimum hardware required . with both the Controller and Worker on the same machine.Advanced Configurations Installing them together on a single machine reduces your cost and simplifies the administration. it may be beneficial to install them on separate machines. For environments with heavy document activity. however. Document conversion performed on the RepliGo Worker can be CPU intensive at times.
you may wish to consider one of the other options. it also increases the solution complexity and management. handles highest document loads + Allows scaling for any document processing levels (additional Workers) . See the “Installing Microsoft Office 2007 for document conversion” section for more information.Additional hardware required . Guidelines for determining your configuration Use the following guidelines to help in deciding which configuration to use. The load level depends on a number of factors such as the number of users and their level of activity. • .Additional hardware required . when the number of RepliGo users is less than 1000. • • Most situations will operate effectively in the simplest standalone configuration with RepliGo Server installed on the same machine as BES. you should install Office on each RepliGo Worker machine. In general. If the load on your BES is high.Multiple RepliGo Servers to administer RepliGo Controller on different machine as BES RepliGo Worker(s) on different machine than BES or RepliGo Controller • Clustered Configuration • Controller and Worker are remote to BES High number of documents processed and high BES usage + No impact on BES machine + Faster document response time.Advanced Configurations BES • Clustered Configuration • Controller is local to BES. If your BES serves more than 200 users then you may benefit by moving RepliGo Server onto a dedicated machine. Worker is remote to BES document loads + Allows scaling for any document processing levels (additional Workers) . you are better using one of the standalone configurations. While the clustered configuration gives you optimal performance and scalability.Multiple RepliGo Servers to administer 3+ If installing Microsoft Office 2007 for document conversion in a clustered configuration.
This will allow you to scale to whatever your document load levels require. please contact Cerience Technical Support to ensure that the solution is optimally designed for your environment. . If you are considering installing RepliGo Server using the clustered configuration. increasing document response times. • Note Most Blackberry environments can operate effectively using a single RepliGo Server. configured to run locally or remotely to BES. The clustered configuration is only recommended for Blackberry environments with very high document demands. Using a RepliGo Server that is not on the same physical network as the BES will incur network delays.Advanced Configurations • If you have very high document usage then you may want to consider using multiple RepliGo Workers. A single RepliGo Server should only service multiple BlackBerry Enterprise Servers if they are all geographically co-located and on the same physical network.
Advanced Configurations Installing a clustered RepliGo Server This section provides the instructions for installing RepliGo Server in a clustered configuration. ► Enter the account information for the RepliGo Server Administrator application. 2. ► Click I Agree. Verify network access over the configured port to the target RepliGo Server machines.exe file. The default ports are 4080 through 4083. This should be done on each BES machine that RepliGo Server will be supporting. Verify that your BES has access to the RepliGo Controller machine using the first of the four RepliGo Server ports. 5. Verify that the target RepliGo Server machines meet the system requirements. ► Click Controller. b. Complete the following install screens. c. 3. Verify that your BES has BlackBerry Mobile Data Services/System (MDS) running and enabled for each user that will utilize the solution. ► Enter the target folder for the installation. ► Click Install RepliGo Server. Screen License Agreement Values — Actions ► Read the License Agreement. Pre-Installation 1. Install Options . On the target RepliGo Controller machine.only if installing local to BES Operation Mode Install RepliGo Server Install only the BlackBerry Enterprise extension Controller Worker Configuration Options Server Ports ► Enter the first of four consecutive ports for RepliGo Server. Install the RepliGo Controller 4. a. inclusive. Verify that the RepliGo Controller has network access over the four configured ports to the target RepliGo Worker machines. Verify that your BlackBerry device has similar access to the RepliGo Controller machine. close all other applications and run the Setup. User name and password Install Location C:\Program Files\RepliGo Server .
On each RepliGo Worker. . Install the RepliGo Workers 6. Configuration Options Server Ports User name and password Install Location C:\Program Files\RepliGo Server 8. and restart your BlackBerry Controller Service prior to configuring RepliGo Controller and deploying the client. if you have chosen that option. Screen License Agreement Values — Actions ► Read the License Agreement. ► Click I Agree.Advanced Configurations Note You must complete the install of RepliGo Server. Complete the following install screens. including the install of the Extension. ► Enter the target folder for the installation. See the “Installing Microsoft Office 2007 for document conversion” section.exe file. install Microsoft Office 2007. On each target RepliGo Worker machine. ► Click Worker. 7. close all other applications and run the Setup. ► Enter the account information for the RepliGo Server Administrator application. ► Enter the first of four consecutive ports for RepliGo Server. Operation Mode Controller Worker Worker Configuration Controller Hostname Controller Port ► Enter the server name and the first port number assigned to the Controller server.
exe file to start the RepliGo Server Installation Wizard. Deploy the RepliGo Professional Enterprise client from your RepliGo Controller to your users using the Administrator application. Install Options Install RepliGo Server ► Click Install only the BlackBerry Enterprise extension. Add or import users and assign settings.” 13. Install only the BlackBerry Enterprise extension • RepliGo Server Host • RepliGo Server Port Post Installation 11. ► Enter the server host name and the first of the four assigned ports. a. Restart the BlackBerry Controller Service on your BES machine. For Lotus Domino. ► Click I Agree. See the “Deploying the RepliGo Professional client” section for more information. 10. Complete the following install screens. On your BES machine. close all other applications and run the Setup. This must be done on each BES machine that RepliGo Server will be supporting. You should not need to perform any configuration tasks on the RepliGo Worker(s). This must be done on each BES machine that RepliGo Server will be supporting. you will need to restart your Domino Server. 12. Screen License Agreement Values — Actions ► Read the License Agreement.Advanced Configurations Install the BlackBerry Enterprise Server Extension 9. set the “Document Conversion” value to “Convert documents on a separate RepliGo Server configured as a Worker. . b. Configure the RepliGo Controller using the Administrator application. On the “Tools > Document Handling” tab.
Troubleshooting Troubleshooting Accessing server log files The Troubleshooting page under the Tools tab provides access to the server log files that can useful when debugging. It allows you to export these log files and provides an easy method for uploading them to Cerience Technical Support personnel (see Figure 16). Figure 16 .
the Administrator’s Help Page contains information about your license and version of RepliGo Server. This page also contains contact information and links to important resources. . If you suspect your server is not functioning properly. including our extensive online Support Center and the most up-to-date Administrator’s Guide (see Figure 18). Figure 17 In addition to the Monitoring page. Use this page to verify the status of your server license and the number of users allowed. you should visit this page to diagnose the problem (see Figure 17). As users access documents from their devices.Troubleshooting Accessing server information The Monitoring page allows you to keep track of RepliGo Server’s activity. you will see a log of the traffic on this page.
Troubleshooting Figure 18 .
Users cannot download the RepliGo Enterprise client via the BlackBerry Browser Why can't my users download the RepliGo client via their BlackBerry Browser? 7. Users are unable to open Zip attachments on their devices Why don't Zip attachments open? 6. User error message that they are not registered with the server What causes the error message that tells users they are not registered with RepliGo Server? . Users are unable to open attachments on their devices Why do my users get an error message when they select "Open with RepliGo"? 5. Cannot deploy the RepliGo Professional client to my users Why do I get an error message on the Deploy page of the Administrator when deploying the client? Why do I get a "failed to notify" error for some of my users on the Deploy page in the RepliGo Administrator? What are the different methods for deploying the RepliGo client? 4. Cannot import users from the BES database How do I configure my SQL/MSDE database so RepliGo Server can import users from it? 3.Troubleshooting Frequently Asked Questions Below is a list of common issues and typical solutions. The RepliGo Professional client cannot access RepliGo Server Why can't the RepliGo client access RepliGo Server? 8. Clicking on the link below an issue will open the most up-to-date information regarding that topic on the Cerience Support Center. Cannot access the RepliGo Server Administrator Why can't I access the RepliGo Server Administrator? 2. 1.
Below is a subset of the information available on the Help page.cerience. you may want to refer to the Administrator’s “Help” page. contact information and links to important resources.com .Troubleshooting Technical Support resources If you are unable to find a solution to your problem in this section. The Administrator’s Help page contains information about your version of RepliGo Server. Phone: +1 (970) 282-3850 Phone: +1 (800) 403-1495 Email: email@example.com Cerience Support Center: http://support. including our extensive online Support Center and the most upto-date Administrator’s Guide.
This action might not be possible to undo. Are you sure you want to continue?
We've moved you to where you read on your other device.
Get the full title to continue reading from where you left off, or restart the preview.