Version 13.0 Web/VRU/CSR Installation and Configuration. December 7, 2007

Transcription

1 Version 13.0 Web/VRU/CSR Installation and Configuration December 7, 2007

2 Table Of Contents Section Subject 1 Overview 2 Installation and Environment Considerations 3 Performing the Relius Administration 13.0 Web/VRU/CSR Installation 4 Web/CSR Installation Specifics 5 VRU Installation Specifics 6 Setting Up Initial Web/VRU Configurations 7 Setting Up Security Profiles and Web/VRU Settings 8 Running VRU Move and Testing the Servers Appendix A Converting Custom Files

3 1 Overview This document covers upgrading the Relius Administration 12.0 (or higher) VRU, Web, and CSR Servers to Relius Administration To install Relius Administration 13.0 on a workstation, please refer to the Relius Administration 13.0 Installation and Configuration document. All references to the Relius Administration 13.0 Voice Response Units powered by Edify will be hereinafter called RA VRU. All references to the Relius Administration 13.0 Internet Server will be hereinafter called RA Web. All references to the Relius Administration 13.0 Customer Service Representative module will be hereinafter called RA CSR. Only those modules for which you are licensed will be activated. Relius Administration Web/VRU is a universal installation that can be used to update an earlier version (version 12.0 or higher) or configure a new server. If updating an existing server, it must already be running Relius Administration 12.0 or higher before beginning. Additionally, Oracle 10g Client and the Relius Administration 12.0 Web/VRU Component CD must be installed If installing on a new server, Oracle 10g Client and the Relius Administration 12.0 Web/VRU Component CD should be installed before installing Relius Administration Important Note If you are using the Relius Administration Web, VRU, or CSR modules, you must already be running Relius Administration 12.0 or later, including workstations, database, Web, VRU, and CSR. If your systems are not yet running 12.0 or later, installing RA13.0 to the workstations may cause additional delays and downtime. If you have not already installed 12.0 or if you are unsure about the version you are currently running, please contact Technology Support for assistance.

4 The installation of RA Web/VRU/CSR involves the following basic procedures: 1) Read and understand the entire document before beginning. 2) Ensure Relius Administration 13.0 is installed and fully functional at each workstation and the databases have been successfully upgraded. 3) Ensure the Relius Administration Web/VRU/CSR Component CD is installed on your servers. 4) Ensure your database has been properly exported and backed up. 5) Install Web/VRU/CSR. 6) Configure and test the Web/VRU/CSR systems.

5 2 Installation and Environment Considerations 2.1 Installation Methods The Oracle 10g Client and the Component CD must still be installed to your servers before beginning this update. Relius Administration 13.0 Web/VRU/CSR is only available via download from the SunGard Relius support web site ( Downloading the installation to a local drive is recommended and supported. Other methods of installing (installing directly from the SunGard Relius web site, push or ghost technology, Z.E.N. Works, Zip Drives, etc.) are not supported or recommended. If a network drive is used to install, it must be mapped with a drive letter assigned. Running the installation from a network drive accessed by browsing with Network Neighborhood will fail. 2.2 Software fixes via Internet Fixes, support files, and updated documents will be generally distributed via the Internet at Users must have Internet capability to receive these fixes. Visit our web site ( and click Subscribe to receive notification of new fixes by . SunGard Relius does not send patches and updates through the mail. SunGard Relius strongly urges that all users subscribe to this service. 2.3 Virus Scanners Although SunGard Relius does not endorse, support, or recommend any particular method, virus protection is encouraged on servers and workstations. The two most popular are Symantec s Norton Anti-Virus and McAfee VirusScan by Network Associates. You should update your virus definition files regularly. Norton's Script Blocking option can cause problems on web servers. Clients using Norton with Script Blocking turned on should test the functionality of RA Web application to determine whether script blocking is affecting our Active Server Pages. Certain versions of the Anti-Virus programs also install a Web Filter or Web Security. If this option is set too high it can cause serious connectivity errors and web lockups for your clients. The Web Filters or Web Security portions of the files are not supported because they emulate a firewall environment. Software firewalls are not supported by SunGard Relius and should be disabled during installation. If the security settings are too high, the web server may not work correctly. Exercise caution when implementing this manner of security.

6 Some virus scanners if active during the installation can interfere with a successful installation. Symptoms include an error message stating that a file cannot be overwritten. Temporarily disable virus scanning before starting the installer. 2.4 Windows 2000/2003 Server Considerations Web/CSR: Windows Server 2003 (Web, Standard, and Enterprise Editions) is now the only supported version for Web and CSR. The Relius Administration 13.0 Web/VRU/CSR installation will fail on Web/CSR servers upgraded from Windows 2000 Server. ASP.NET: Microsoft s ASP.NET must be installed and enabled on Web/CSR servers. Open a Windows Command Prompt and set your directory to C:\Windows\Microsoft.NET\Framework\ v From the Command Prompt, type ASPNET_REGIIS i enable <Enter> VRU: The VRU server must remain on Windows 2000 until further notice. The Windows 2000/2003 Server local Administrator must run the installation. SunGard Relius requires the use of the default local Administrator. For more information, please call Technology Support. The Relius Administration Web/VRU/CSR Server cannot be configured as a primary or backup domain controller (PDC or BDC). It must be a member server of a workgroup or domain. If the server is configured as a PDC or BDC, the Web/VRU/CSR products will not correctly install, configure, or function. The only solution in these circumstances is to format the server and re-install the operating system and Relius Administration products. The use of virtual environments and connections, such as Microsoft Virtual Server or VMWare, are not supported by SunGard Relius. If a virtual environment is detected, the installations will abort. For additional technical information regarding this topic, please contact Relius Administration Technology Bit Platforms Presently, no Relius products are supported on 64-bit servers, workstations, and operating systems. Clients will receive special notification when certification is complete, including which products are capable of running on 64-bit platforms and at what version.

7 2.6 Upgrading from a Previous Version The only version from which you can run this installation is Relius Administration 12.0 or later Web/VRU/CSR. If your system is at an earlier version, you must first upgrade your server to RA Web/CSR servers previously running Windows 2000 Server must format the drive and install Windows Server 2003 fresh before beginning. Web/CSR Servers that have been upgraded from Windows 2000 Server will neither install nor run Relius Administration 13.0 Web/CSR. Please note that if you have SSL, custom graphics, and other non-standard settings on your existing Windows 2000 Web Server, you must export/backup this information to a safe location before formatting your drive. SunGard Relius cannot be held responsible for lost data. 2.7 Firewall and DMZ Considerations Clients need their Internet environment to be as secure as possible. Although SunGard Relius recommends the use of firewalls and other security measures, SunGard Relius cannot assist clients in the implementation and maintenance of such technology. Firewalls should not be of the software variety. This is due to software firewalls being less secured than hardware firewalls. Hardware firewalls are more secure but require more knowledge of the system in setting up the connectivity and ports. By default, a hardware firewall is setup and installed between the client trying to access your website and the web server itself. In this case, the only port that should be opened on the Hardware Firewall should be port(s) 80 or These ports are the default web ports for networks worldwide. Opening these ports will only allow data to pass through these ports when clients access the web site. DMZ environments are complicated to design and implement and therefore are NOT supported by SunGard Relius. In a DMZ environment, the firewall is between the Web Server and the Database Server on your network. The firewall must support Oracle Port Redirection. For more information, please contact Relius Administration Technology Support at

8 2.8 Hardware and Software Requirements All hardware requirements are specified on our web site ( Web: Windows Server 2003 (Web, Standard, or Enterprise Edition) with Service Pack 1 may be used for the Web Server only. VRU: Windows 2000 Server with Service Pack 3 or higher. TCP/IP Network Protocol for multi-user systems. The database server must have a static IP address. Internet Information Services must be installed and set up (Web/CSR). Edify 8.0 must be installed on VRU servers. Minimum video resolution of 800 x 600 with 256 colors. 2.9 Post-Installation Configuration Many enhancements have been placed in Relius Administration 13.0 Web/VRU/CSR. After the installation, users will need to make several configuration changes to their servers. Most of the documentation containing detailed instructions on configuration can be obtained from Relius Administration Software Support Edify Security Considerations Once Edify is properly installed and configured, you must not change the machine name of your Edify server or the password of the user that installed Edify. Edify s Electronic Workforce Administrator depends on a consistent machine name and UserID/Password configuration to run properly Cascading Style Sheets Cascading Style Sheets (CSS) are used to attach a style (colors, fonts, etc.) to a web site. In Relius Administration Web 13.0, the CSS structure and the page structure have been modified to more closely conform to current web design standards. If you have customized CSS files, please review Appendix A before proceeding.

9 3 Performing the Relius Administration 13.0 Web/VRU/CSR Installation Pre-installation Notes: a) This installation is valid for Windows 2000 Server with Service Pack 3 or higher for VRU Servers and Windows Server 2003 (Web, Standard, or Enterprise Edition) for Web/CSR Servers. Any other operating system is not valid or supported. b) Relius Administration 13.0 must be installed and fully functional (including database upgrade scripts) at each workstation before beginning this installation. c) Be sure no screen saver will become active during the installation. If a screen saver is to be used after the installation, the default logon and the blank screen savers use the fewest resources on the server. d) The installation process takes approximately 1 hour to complete. The process of upgrading the databases may take longer, depending on the amount of data in the databases. e) Ensure you have a valid backup of your server(s) and a valid database export before proceeding. SunGard Relius cannot be held responsible for the integrity of your data or servers. f) Unless otherwise noted, all activity is conducted from the server(s) being upgraded. 3.1 Ensure you have run the Web/VRU Component Install CD. 3.2 Download the self-extracting installation program from the SunGard Relius FTP Site ( and copy it to an easily accessed location, preferably a local drive on each server. In these instructions, D:\Temp will be used. 3.3 Remove any icons or shortcuts from the StartUp folder. Services (such as real-time virus scanning) that may impede or interfere with the installation should be stopped and set to Manual before proceeding. Additionally, programs that are set to launch when Windows is started can also be specified in C:\WINDOWS\WIN.INI. Please edit this file using Notepad. Temporarily remark the entries RUN= and LOAD= by placing a semi-colon ( ; ) in front of the line (if programs are specified), then Save and Exit the WIN.INI file. Example of remark: ;RUN=EXAMPLE.EXE

10 3.4 Re-start the computer. Windows or other programs may have locked some files that need to be overwritten during the upgrade process. 3.5 VRU Servers: Open Control Panel. Double click Services. If Electronic Workforce is not started, start the service before running the installation. Edify must be up for a successful installation. 3.6 Temporarily disable all virus protection. 3.7 Click Start, then Run and type D:\Temp\ReliusAdminWebVruCsr13.exe in the command box, then click OK. 3.8 Because this installation is a self-extracting executable, several files will extract and copy to temporary locations for the installation process.

11 3.9 The Relius Administration 13.0 Web/VRU/CSR Installation Welcome screen appears. Click Next to continue. Upgrade installations will skip to Step New installations will prompt for the ClientID. Enter the six-character ClientID provided by SunGard Relius and click Next.

12 3.11 New installations will also be prompted whether they want a Typical or Custom installation. Choosing Typical skip Step New installations will be prompted for the location of the program files. The default is C:\Program Files\Relius\Admin. When you have entered your desired path, click Next.

13 3.13 New web installations where Custom was chosen will see choices for the path and virtual directory names of two web sites that will be created. The defaults are ReliusWeb (using the directory of C:\InetPub\WWWRoot\ReliusWeb) and RACsrWeb (using the directory of C:\InetPub\WWWRoot\RACsrWeb).

14 3.14 New installations will skip to Step If you have already installed this release, you will be prompted to continue. There is usually no harm in continuing, but it is not always necessary. Special circumstances may dictate reapplying this update, such as troubleshooting and maintenance, or at the recommendation of Support You may be prompted whether you are using VRU databases. If you are uncertain, select No. No changes will be made to your databases or connectivity if this is a new installation For updates, database update scripts will need to be run against your VRU databases You will be prompted to ensure your databases are backed up.

15 3.19 You will also be asked to verify that all users are disconnected from the system Note the database names that reflect the database being updated. Please be patient and do not interrupt the process At this point, the installation will proceed according to your server s configuration. Web installations continue with Section 4. VRU installations continue with Section 5.

16 4 Web/CSR Installation Specifics 4.1 Internet Information Services will stop automatically. Windows Server 2003 may take some time to stop IIS under the installation. Do not interrupt the process. 4.2 Files will copy to your server. 4.3 Servers upgrading from version 12.x: Before each web site directory is updated, you will be asked to back it up. SunGard Relius urges a backup of each directory to preserve any customization that may need to be restored.

17 4.4 Relius Administration Web/CSR 13.0 will configure its settings and update the applications. 4.5 When finished, you may need to reboot the server. Be certain that Yes, I want to restart my computer now is selected. Click Finish. Continue with Section 6.

18 5 VRU Installation Specifics 5.1 Existing Edify applications will first uninstall. 5.2 Files will copy to your server. 5.3 Relius Administration 13.0 VRU will configure its settings.

19 5.4 The new Edify applications will install, configure, and submit job requests. You may see DOS windows flash in the background. This is normal and expected. Do not interrupt. 5.5 When finished, you may need to reboot the server. Be certain that Yes, I want to restart my computer now is selected. Click Finish. Continue with Section 6.

20 6 Setting Up Initial Web/VRU Configurations After installing Relius Administration 13.0 Web/VRU/CSR, you will need to initialize the options, which are now stored in the database. The Web Options and Web Utilities files no longer exist on Web and VRU servers. 6.1 If action was taken in Step 3.3, restore the icons or shortcuts that were temporarily removed from the StartUp group or folder and remove the remark from the RUN= and LOAD= statements from WIN.INI. Restart any services that were temporarily set to Manual and if necessary place them back in Automatic mode. 6.2 You will need to initialize your databases. Click Start Run, then type C:\Program Files\Relius\Admin\InitializeDatabases.exe and click OK. 6.3 Enter the information for your database connectivity for each database. The default databases are RADB, RAV1, and RAV The default Usernames and Passwords are SYSADM. After entering the information for each database, click Test Connection. If the connection is successful, you will see the screen below. Click OK.

21 6.5 Once you have a successful connection, click Save Settings, which will no longer be grayed out. When the entries have been saved, you will see a check mark beside the button. 6.6 If you are using VRU databases, check the option stating so and repeat the process for each VRU database. When you have saved each VRU database setting the Run Scripts button will enable. 6.7 If you haven t already run Web/VRU scripts against your VRU databases, click Run Scripts. This will take a few minutes, and the process will inform you when complete. Close the Database Initialize tool.

22 6.8 To configure your settings, Click Start Programs Relius Admin Web/VRU Configuration. Your Configuration program will look like what you see below.

23 6.9 Choose one of the Applications listed on the left side of the Configuration window. In many cases, clients are installing Relius Administration 13.0 Web to a fresh operating system where no previous RA Web applications existed. If no applications exist, click File New Web Site to create one. (If no application exists on your VRU, you will be prompted for a location automatically.) Choose the directory where your web site (or voice clips for VRU) was installed and click OK. The default for Web is C:\InetPub\WWWRoot\Reliusweb, and the default for VRU is C:\Qtech You may be prompted for database information again. Enter in your database connection string and click Test. If the connection was successful, click OK If no default text exists for that particular web site (or it is outdated), you will be prompted to import new text. Click Yes. If you are licensed for multilingual web, you may be prompted a second time.

24 6.12 Make the changes appropriate to your particular settings. Each description must be unique. Be sure to include a full address in the URL field Click File Save Repeat this process for each Application on each VRU and Web server. If you are installing RA CSR on a fresh operating system, you may need to create another Web Site directory. Create the folder C:\InetPub\WWWRoot\RACsrWeb. Then copy all files from C:\Program Files\Relius\Admin\ReliusWebSrc (the source folder). Repeat steps 6.9 through Part of the validation process on the VRU is to check for unrecorded voice clips. If voice clips are not recorded, the VRU may produce erroneous information or inadvertently hang up. If you receive a list of clips that have not been recorded, please record them before testing your VRU on participant information Clients who have customized their Cascading Style Sheets (CSS) must propagate those changes into new CSS files provided by SunGard Relius. See Step 2.11 for more information.

25 7 Setting Up Security Profiles and Web/VRU Settings Because security profiles in Relius Administration have been fine-tuned during the upgrade to 12.0, you will need to adjust your profiles. The default for new and adjusted profiles is No Access. To enable a user for certain modules, you must adjust the security profiles. All tasks in this Section must be performed at a Relius Administration workstation. 7.1 Open Relius Administration and sign on as a user with rights to System Administration. From the main menu, click Utilities System Administration System Administrator Update.

26 7.2 From the System Administration menu, click the Security Profiles tab. Double click the profile you wish to edit. Change the level of security (specifically, checking Customer Service Module, VRU Options, Web Menu Customization, Web Messages Customization, Web Options, and any other settings you deem appropriate for that profile) to your desired settings and click Modify. Repeat this process for each security profile you wish to change. 7.3 From the Relius Administration Main Menu, click Utilities VRU / Web Administration Web Options.

27 7.4 Select the site you wish to adjust, click Load, make adjustments to your site, then save your changes. Repeat this process for each site. Click Exit. 7.5 From the Relius Administration Main Menu, click Utilities VRU / Web Administration VRU Options. Make your adjustments to the VRU, save your changes, and click Exit. 7.6 From the Relius Administration Main Menu, click Utilities VRU / Web Administration Custom Text. You will be asked to choose which site s custom text you wish to edit.

28 7.7 Using tree branch browsing, select the text you wish to customize. When you have finished, click File Save, then File Exit. 7.8 You can change your Logo on the top of your web site by adjusting the settings in Custom Text General ASP Messages LeftBannerLogo. To eliminate the logo on the right, adjust the settings in Custom Text General ASP Messages LeftBannerLogo and change the file name listed therein to transparent.gif.

29 8 Running VRU Move and Testing the Servers 8.1 From a Relius Administration 13.0 workstation, open Relius Administration and enable your plans, participants, and plan sponsors (if applicable) to access your web server. Setting up plans must be completed before running VRU Move. For more help within Relius Administration, click Help Contents or press the <F1> key. 8.2 From a Relius Administration 13.0 workstation, execute VRU Move (normally C:\Program Files\Relius\Admin\UVRUMOVE.EXE) twice. To review the log generated by VRU Move, browse to C:\QtTemp and look for the most recent log file, starting with the name VRUMove. 8.3 Workstations accessing CSR must have Microsoft Internet Explorer 6.0 or higher.

30 8.4 Web servers can now be set to use the same site for both Web and CSR You may have to adjust IIS at the Web Server by adding Csr.aspx to the ReliusWeb Virtual Directory s settings and placing it second only to Default.aspx. 8.5 Log on to the Web/CSR Server using the URL assigned to it (i.e., or or call your VRU. Enter a test UserID and Password. For troubleshooting, please call Support at , Option 3.

31 Appendix A Converting Custom Files Several enhancements have been made to the design and layout of the Relius Web application. The look and feel has been modernized, and newer programming has been implemented. The Cascading Style Sheet (CSS) files that are installed as part of the stock Relius Web product have already been updated for you. If your Web site is using custom CSS files, they must be converted to be compatible with version The conversion should occur immediately after you have upgraded to version 13.0 and before you turn the site back on for participant and plan sponsor use. Web Clients Who Use Custom Style Sheets Please follow the steps below for completing this task: Locate and copy your custom CSS files from the Web server, usually located in C:\InetPub\WWWroot\ReliusWeb\CSS-Files, to a Relius Administration Workstation. Within Relius Administration 13.0, click Utilities VRU/Web Administration Web Customization Screen Styles. Click File Open and browse to the location of custom CSS file.

32 Once the file has been opened two messages will appear indicating that both the Internet Explorer and Netscape versions of the CSS files have been converted to version The conversion is complete. Repeat these steps for any other custom CSS files you may have. Copy the two files back to your Web Server. Custom Web Clients If you contracted with SunGard Relius to customize your Web site, do not upgrade to Version 13.0 at this time. You will require a special edition of the 13.0 Web/VRU/CSR Upgrade that contains your customized files. Please us at rawebcustom@relius.net to request your custom Web upgrade and schedule availability. Please provide as much notice as possible to give us the best opportunity to meet your projected installation date.

33 Disclaimers and Copyright Notices Copyright SunGard. All rights reserved. This document and the software it describes may not be reproduced, in whole or in part, in any form whatsoever without the written permission of SunGard Inc. All other products and product names mentioned herein are the copyright of their respective company(ies). This document is provided as is without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. This document could include technical inaccuracies or typographical errors. Changes are periodically added to the information herein. These changes will be incorporated in new editions of the document. SunGard may make improvements and/or changes in the product(s) and/or the Program(s) described in this document at any time. Any third-party programs included herein are subject to a restricted use license and can only be used in conjunction with this application.