WARNING The GroupWise is the REQUIRED GroupWise client for the Riva New Zealand DST Module.

Transcription

1 GroupWise Collaboration Integration Suite New Zealand DST Module Setup and User Guide This Guide Welcome to Riva, the next generation engine for managing GroupWise information based on policies. Riva leverages the GroupWise Trusted Application Architecture and edirectory connectors to allow an administrator to create policies to manage GroupWise information. The Riva New Zealand DST Module provides a centrally managed solution to address the recent decision to adjust the New Zealand DST settings similar to changes implemented in North America. This guide provides information necessary to: Install the Riva application on a management Windows workstation Run the setup wizards to configure connection settings Modify existing connection settings Use the New Zealand DST module.. WARNING The GroupWise is the REQUIRED GroupWise client for the Riva New Zealand DST Module. Revised: September 24, Omni Technology Solutions Inc. Page 1 of 24

2 Table of Contents How Riva Works... 3 Installing Riva... 3 System Requirements... 3 How to Install Riva... 4 How to Start Riva... 4 How to Update Riva... 4 How to Establish System Connections... 8 How to Modify System Connections Modify Host IP Address or Port Value or Use SSL Use the New Zealand DST Module How the New Zealand DST Module Works Create a New Zealand Time DST Policy Execute a New Zealand DST Policy How to Schedule the Policy Best Practises for New Zealand DST Policies Support for Riva Support and Update Agreements Contacting Support Online Support Free Support Revised: September 24, Omni Technology Solutions Inc. Page 2 of 24

3 How Riva Works Riva is a combination of three key components that work together: 1. Riva Framework The Riva framework is the engine that permits centralized management of GroupWise account information using policies that are created using the Riva application. Riva is able to execute policies using a GroupWise Trusted Application Key and the Riva edirectory connectors. The GroupWise Trusted Application allows an administrator to update content in all mailboxes in a GroupWise system. 2. Riva Application The Riva application is used by the administrator to connect to one or more edirectory and GroupWise systems to create and execute policies. Policies are created by running policy wizards that are associated to modules. 3. Riva Modules Riva uses a set of policy and report modules to create policies and generate reports. The different policies perform mailbox update or management tasks. Each Module can be licensed individually. Riva s flexible licensing system allows customers to license different modules for different parts of the edirectory and GroupWise systems. There are four steps to install and configure Riva: Step 1 Install Riva Step 2 Connect Riva to the edirectory and/or GroupWise System and enable CSV support Step 3 Create and configure the New Zealand DST desired policies Step 4 Execute those policies Installing Riva System Requirements: Windows 2000 or XP workstation with latest service packs that will serve as the administrator workstation. The administrative workstation must have: o o o its Regional and Language Options set to (English) New Zealand (Control Panel - Regional and Language Options). The Riva New Zealand DST module will ONLY appear and be available to be configured if the workstation's Regional and Language Options setting is correctly configured to (English) New Zealand. Microsoft.NET 2.0 Framework installed AAB15C5E04F5&displaylang=en GroupWise Multi-language client installed which is the REQUIRED client for this module. GroupWise or higher GroupWise system running on NetWare, Windows server, or Linux server (the Primary Domain must be at least 6.5.2). LDAP context of an edirectory username and password with supervisor equivalence to configure the initial edirectory connection. LDAP context of the LDAP Server Group of the server that Riva will connect to. GroupWise administrator account to generate the GroupWise Trusted Application Key. GroupWise normal account and password to use with the GroupWise Trusted Application key. Revised: September 24, Omni Technology Solutions Inc. Page 3 of 24

4 How to Install Riva To install Riva, create a c:\program Files\Omni Omni\Riva folder. Extract the riva-latest.zip file and copy the contents of the \riva riva-latest folder to the c:\program Files\Omni Omni\Riva folder. You can also make a shortcut of the Riva.exe file to your desktop and label it as "Launch Riva". How to Start Riva Double-click the Launch Riva desktop icon, or double-click the Riva.exe file in the Riva installation directory. How to Update Riva Riva comes with a Check for Update feature which should be run immediately after installing Riva. You can confirm the installed version of Riva by double-clicking on the Riva icon in the top left corner of the Riva application. Click on an installed module to view the version information. Revised: September 24, Omni Technology Solutions Inc. Page 4 of 24

5 To update Riva: 1. Click the Check for Updates link at the far right side of the menu bar. 2. In the Internet Connection window, click Yes. A Riva Updater Status window will open. Revised: September 24, Omni Technology Solutions Inc. Page 5 of 24

6 3. If no update is available click OK to close the window. 4. If available an Update Available window will open. Click Yes to update Riva. and click OK when done. 5. Once an update has completed, you will need to close Riva and restart it. You can then verify that the update has completed by double-clicking the Riva icon (top left) to open the About Riva window. Revised: September 24, Omni Technology Solutions Inc. Page 6 of 24

7 You can also verify the success of the update by checking the update log, found in the \Logs Logs\SelfUpdater folder. Revised: September 24, Omni Technology Solutions Inc. Page 7 of 24

8 How to Establish System Connections When you run Riva for the first time, system connections must be established. Establishing these connections will generate the required trusted GroupWise application key. To establish system connections: 1. Connect to edirectory: a. Click Setup and click edirectory System under Connection Wizards. b. This will start the edirectory Connection Wizard. Click Next. c. Specify the IP address or the DNS name of the edirectory LDAP host server and specify the port value. If Enable SSL is selected, the port value will change to 636 as the default SSL port for edirectory. Modify this value as required. Click Next. d. Enter the LDAP context and password for the edirectory user account that will be used to connect Riva to the edirectory system. The LDAP naming convention does not use a leading period and uses a comma (,) to separate the container objects rather than a period. e.g. cn=admin,ou=users,o=omni Revised: September 24, Omni Technology Solutions Inc. Page 8 of 24

9 Click Next >> to continue. e. Click the select>> link to open the edirectory Tree Browser window. Navigate and select the LDAP Group object for the server you specified in the previous Target Information window: Click OK >> to close the edirectory Tree Browse window and return to the LDAP Group Distinguished Name window. Revised: September 24, Omni Technology Solutions Inc. Page 9 of 24

10 f. At the Results for matched/not Matched Attribute List and map window, the number of mapped attribute objects will be displayed. If there are unmapped attribute objects, when you click Next. g. At the Results for matched/not Matched Class List and map window, the number of mapped class objects will be displayed. If there are unmapped class objects, when you click Next. h. At the edirectory connection successful window, you will see a summary screen. Ensure that the Launch GroupWise Connection Wizard is selected (checked) and click Finish. Revised: September 24, Omni Technology Solutions Inc. Page 10 of 24

11 2. Connect to GroupWise (Part One) the GroupWise Connection Wizard will start and lead into the Trusted Application Key Wizard. This requires access to the wpdomain.db file for the domain. a. At the introduction window, click Next. b. At the Trusted Application Key window, select Create a new trusted Application Key to generate a new key. This will automatically start the Trusted Application Wizard. 3. Create the Trusted Application Key a. At the Welcome to the Trusted Application Wizard window, click Next. b. At the Collect Trusted Application Parameters window, enter the: Domain Path: specify the UNC path or mapped drive path to the wpdomain.db file of the primary GroupWise Domain that Riva will connect to. You can manually type in the UNC path or use the Browse button to navigate and select the target folder through a mapped drive. Application Name: provide an Application Key Name. This should be unique if multiple trusted application keys will be used for different installations of Riva connecting to the same GroupWise system. Application Description: (Optional) this is an optional description field. IP Address: (Optional) this security setting should be used if you want to limit Riva to only be able to run from this specific workstation IP address. This prevents Riva from being able to run on a different workstation. Revised: September 24, Omni Technology Solutions Inc. Page 11 of 24

12 Click Next to continue. c. At the Collect Trusted Application Options window, select to Overwrite a Trusted Application Key with the same name as this one (choose this option if you are recreating a new trusted application key). Click Next. d. (Optional) To view the registration of the trusted application, 0pen a server remote console session to a post office console screen of one of the post offices in the domain that is being configured with the trusted application. Set logging to Verbose. When the trusted application is registered in the step e, you will see the following message in the post office screen: Server Time: 31F ADM: Completed: Update object in post office Trusted Application on (Domain: Name of domain). Set the log level back to normal on your post office. e. At the Generation Successful screen, it is recommended that you save the trusted application key information to a file. This will allow you to re-use this key if you want to reinstall Riva at a later date or install Riva to run the same policies from another workstation. Click Save to disk... and save the file to the desired location. Note that any person with this key can run any application that is configured to use this trusted application key. This key should be stored in a secure location. f. Click Finish to complete the process. Revised: September 24, Omni Technology Solutions Inc. Page 12 of 24

13 Depending on how busy your GroupWise system is, it might take up to five minutes for the Trusted Application Key to be registered on your system. If you have followed the Optional Step e above, you will have seen the successful registration of the key. If you see the following error message when you select Finish, the Trusted Application Key has not had time to be registered on your system: Click OK and click Finish again. 4. GroupWise Connection Wizard (Part 2) after the trusted application key has been created and registered in the GroupWise system, the next steps are to configure and confirm the operation of the Trusted Application Key. a. At the Trusted Application Key test screen, the Trusted Application Credentials will be displayed. Specify the: Server Address: DNS name or IP address of the server hosting the Post Office of the GroupWise account that will be using Riva Port: 1677 is displayed by default. Modify this value to match the port value of the Post Office b. Account Name: specify the GroupWise login name of the account that will be used by the key. This can be the name of any user. The account does not require supervisor rights. Revised: September 24, Omni Technology Solutions Inc. Page 13 of 24

14 Click Next. Riva must successfully connect to a post office connected to the primary domain. If you see the following error message: the DNS name or IP address for the Server Address: dress: field, the Port: value or the Account Name; value may be incorrect. Make necessary changes and click OK, and click Next again. c. At the Choose detection type screen, click Next. d. At the Choose an edirectory Connection screen, select the appropriate edirectory trees and click Next. Revised: September 24, Omni Technology Solutions Inc. Page 14 of 24

15 e. At the GroupWise Connections Detected screen, highlight any connections to Domains or Post Offices that you do not want to have trusted access to and click the Remove button. Click Next to continue. f. At the Automatic Configuration Results window, click Finish. The Riva Setup screen will display the configured edirectory and GroupWise system objects. Revised: September 24, Omni Technology Solutions Inc. Page 15 of 24

16 How to Modify System Connections Modify Host IP Address or Port Value or Use SSL If the IP Address of a GroupWise Domain or Post Office is changed, then the respective connection settings must be manually modified. 1. In the Setup (Manage your Connections) page in Riva, double-click the GroupWise Domain or Post Office object that needs to be modified. A Connection Edit window will open for the connection object. DO NOT make any changes to the General page of any connection object (unless directed by Omni technical support staff). 2. Choose Connection Targets. Revised: September 24, Omni Technology Solutions Inc. Page 16 of 24

17 3. Option 1 Modify an Existing Connection - if you need to modify the IP address or port value of an existing connection, highlight the connection, modify the existing Host: and/or Port: values, check Use SSL (if the Post Office is being switched to SSL only), and click Update. 4. Option 2 Add an Additional Connection if you need to add a connection to an existing object to support non-ssl and SSL connections, highlight Add New Target, add in the values for Host: and Port:, check Use SSL, select domain-mtp mtp (for a Domain) or client (for a Post Office), and click Update. 5. Click Save >> to save the connection settings and close the Connection Edit window. 6. Close and restart the Riva application to use the modified connection settings. Revised: September 24, Omni Technology Solutions Inc. Page 17 of 24

18 Use the New Zealand DST Module How the New Zealand DST Module Works The New Zealand DST Module policy wizard allows administrators to push a query folder to user s GroupWise client that the user can use to locate and examine calendar items that fall within the differential weeks between the old and new DST settings. Create a New Zealand DST Policy To create a New Zealand Time Zone Correction policy: 1. In the Policies page, click the New Zealand DST Module wizard link. 2. Provide a short name and description for the policy. 3. Click add >> to open the edirectory browse window. Select the desired edirectory user, group, or container, or GroupWise resource, post office or domain objects to identify the users who will receive the DST query folder. (Selecting edirectory objects provides much better performance than selecting GroupWise objects.) One or more destination objects can be selected for this policy. Revised: September 24, Omni Technology Solutions Inc. Page 18 of 24

19 Click OK>> to save the destination objects. Revised: September 24, Omni Technology Solutions Inc. Page 19 of 24

20 4. Select Options to configure the destination options. The From: and Subject: fields and the reminder note message text area can be configured. Keywords %NAME% and % % can be used (keywords are case sensitive). 5. Select General and verify that Enabled is checked to enable the policy. Only enabled policies can be executed. 6. Click Save>> to save the policy. Execute the New Zealand DST Policy To execute the policy: 1. In the Policies page, select the Time Zone Correction Policy and click Execute Selected Policies. Revised: September 24, Omni Technology Solutions Inc. Page 20 of 24

21 2. The Monitor page will open and display the status of the policy as it executes. 3. When the policy has finished executing, a Policy Execution Summary Logs window will appear. Highlight the report and click Show >> to open the report. Revised: September 24, Omni Technology Solutions Inc. Page 21 of 24

22 How to Schedule the Policy Schedule a Policy You can schedule one or more Riva Policies using Windows Task Scheduler. To schedule Riva: 1. Open the policy and ensure that Scheduled has been checked. 2. Run the Add Scheduled Task wizard (Start > Programs > Accessories > System Tools > Scheduled Tasks). Click Next > and click Browse... to navigate to and select the RivaApp.exe file. Specify the frequency to run this task and click Next >. > Complete the wizard. 3. Open the task and modify the Run: value C:\Program Files\Omni Omni\Riva Riva\\Riva.exe Riva.exe to read "C:\Program Files\Omni Omni\Riva Riva\\Riva.exe Riva.exe" execute Place double-quotation marks around the path to the Riva.exe file and add execute to the end of the line. Revised: September 24, Omni Technology Solutions Inc. Page 22 of 24

23 . Click OK or Apply to save the changes to the task. Best Practices for New Zealand DST Policies Here are recommended best practices: Test, test, and test. When creating a new policy, use a sample group or container as a destination to ensure that the destination options are working as desired. Once the policy is confirmed, the destination objects can be changed to identify the desired set of users. Use edirectory objects for destination. Although Birthday Reminder policies allow the use of GroupWise objects (post offices and domains), this support is for those environments that create GroupWise accounts without creating corresponding edirectory accounts. Using edirectory accounts as source and destination objects will provide significantly faster policy execution. Revised: September 24, Omni Technology Solutions Inc. Page 23 of 24

24 Support for Riva The Riva on-line support forum ( ) is always the best place to start. Before contacting your regular Novell support channel, we recommend you refer to the "Riva Tips" support forum section to see if a resolution is already available for the problem. All support for the Riva New Zealand DST module is available through the standard Novell support channels. Bugs and product enhancement requests can be submitted using the online "Contact-Us" form at Information can also be sent by to support@omni-ts.com. Please include the word Riva in the subject line. Online Resources Online resources for Riva include: Product Documentation: Go to select Support, follow the link for Documentation and select Messaging Documentation Riva Flash Tutorials: will be added to /quicktours Support Forum: Go to /Forum and: o o Select the Riva for GroupWise ~ Installing, Using, Support forum Riva Tips available at is a collection of forum articles to provide troubleshooting and advanced management steps Product FAQ: Go to and select Frequently Asked Questions Revised: September 24, Omni Technology Solutions Inc. Page 24 of 24