Reuters WNE Client v.4.1 Installation Guide November 24, 2009 WNE v.4.1.10, 4.1.11
This page left intentionally blank
Table of Contents World News Express (WNE)...1 Installation...1 Installation Checklist...1 Installation Procedure...1 Post-installation review of your Administrative settings...5 Creating new user accounts...6 Restart your WNE PC...7 Post-installation validation checks...7 Verify File Direct application status...7 Verify status of required services...7 Appendix A: Description of all WNE Administrative settings...8 File Direct tab...8 Website...10 Playout...10 Advanced...10 Appendix B: Troubleshooting...11 Appendix C: Rollback...11 Appendix D: To uninstall WNE 4.1...12 Appendix E: To set your Copy Folder to a location on a network drivek drive...13 WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 i
This page left intentionally blank WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 ii
World News Express (WNE) Reuters World News Express (WNE) is a file-based video delivery system. In addition to delivering video stories (as Reuters journalists complete them), WNE also supplies video-related scripts which are accessible across the Newsroom, creating opportunities for collaboration. By permanently linking distribution rights, shot lists and script information to the file, WNE makes it easy to search, manage and store videos. WNE content is delivered via satellite to a Reuters supplied WNE caching PC. The WNE caching PC is able to forward WNE content to other client computer equipment at the receiving location via FTP, using a Reuterssupplied application called FTP Suite. Note: The new software will no longer use the HTTP service from IIS. As a result, this service is disabled by the WNE 4.1 installation. However, FTP in IIS will continue to work as normal. If you have made any customizations to your WNE PC that rely on this service and are concerned that the software upgrade may disrupt them please contact us as soon as possible so that we can provide assistance. Installation Installation Checklist Note: It is recommended that the PC on which you will be installing WNE 4.1 is running Windows XP Service Pack 3. If you do not have this service pack already installed, complete the installation in this document first, then install the Windows XP Service Pack 3. The installation of Windows XP Service Pack 3 will proceed much quicker if instruct all users of the WNE PC and WNE website to refrain from accessing the system during this service pack upgrade. Additionally, we recommend stopping the File Direct application during this service pack upgrade. If you using non Reuters-supplied hardware and are running Windows 2003 Server, you must ensure that Windows 2003 Server Service Pack 2 is installed on your WNE hardware before running the installation in this document. The following is a checklist of actions you should be sure to perform to complete the installation/upgrade of your WNE v.4.1 website. Ensure that your WNE PC has adequate anti-virus protection software installed on it and that that software has been properly updated Run the installation procedure using the wneinstaller-4.1.x.exe file (where X represents the version number of the installer that you are using). Review your WNE administrative settings as needed (different settings need to be reviewed depending on how you intend to use the WNE website). Create your user accounts (you can also create additional accounts if needed later). Restart your WNE PC. Post-installation validation checks. Installation Procedure This installation process requires you to run the wneinstaller-4.1.x.exe file (where X represents the version number of the installer that you are using). A copy of this installer file should have been provided to you. If you receive WNE content via satelleite, a copy of this installer file will already have been downloaded to the following directory on your WNE PC: C:\Program Files\SkyStream Networks\zBand Corporate Edition\Storage\Reuters Updates\WNE Client 4.1 If you have not received this installer file, contact your Reuters representative to obtain it. WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 1
If you have already installed WNE 4.1: If you have already installed WNE 4.1 on the PC where you plan run the WNE 4.1 installation, you must first un-install WNE 4.1, then reinstall it. For instructions on how to uninstall WNE 4.1, refer to Appendix D. 1. Login to the WNE PC as an Administrator. 2. Locate and make a backup copy of the Filedirect.ini file (located in C:\Program Files\Reuters\WNE Client\3.0.16\). Place a copy of this file in a location that is not on the WNE PC. This file contains your customer name and EMR IP address which you may later need to reference as part of the installation. 3. Shut down File Direct and the WNE Player service. To shut down File Direct, click the X button located on the upper right-hand corner of the File Direct application window (the File Direct application window contains traffic status lights). To shut down WNE Player service, right-click the orange Reuters icon in the application tray (bottom right of Windows) and select Exit from the menu 4. Locate the wneinstaller-4.1.xexe file and run it. 5. The Welcome page of the installation process will be displayed. Click Next. WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 2
6. The Select Installation Folder page will be displayed. It informs you of the location in which your WNE Client 4.1 files will be installed (C:\Reuters\WNE4\). You cannot change this location. Click Next. 7. The Ready to Install page will be displayed. Click Install. WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 3
8. The WNE installation will begin copying files to your WNE PC. Command line windows may be opened and closed during the installation to execute necessary commands (this is a normal part of the installation). 9. The following page will be displayed. Click Finish. 10. When you click Finish, the following page will be displayed. WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 4
Your WNE software is installed. Be sure to review and configure you WNE website administration settings and create all necessary user accounts. When done configuring these settings and creating your user accounts, restart your WNE PC. Note: If you will be using FTP Suite with your WNE website, be sure to install and configure FTP Suite. Post-installation review of your Administrative settings Note: If you are performing an upgrade to version 4.1 of WNE, your previous WNE administrative settings will be preserved (not overwritten) by the installation program. Depending on how you plan to use the WNE website, there are certain WNE administrative settings that you will need to review and potentially adjust. These settings are accessed via the Administration link in the upper right hand corner of the WNE website. Refer to the applicable instructions in the table below: WNE Usage Scenario If you will be extracting videos using playout via the Stradis card Actions to take 1. Login to the WNE client 2. Click the Administration link 3. Review the settings and save any changes. Reboot the WNE PC. For a full description of the WNE administrative fields, refer to the Appendix of this installation guide. WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 5
WNE Usage Scenario If you will be using: Automatic file transfer feature via FTP Suite or Copy to Folder feature via FTP Suite If you will be using the Copy to Folder feature (without FTP Suite) Actions to take Automatic transfer feature (via FTP Suite) 1. Login to the WNE client 2. Click the Administration link 3. Review the values of the Script Feed Directory, Video Feed Directory and Advisory Feed Directory fields. The values of these fields should be the same as the value you specify in the Local source directory during the FTP Suite configuration. For a full description of the WNE administrative fields, refer to the Appendix of this installation guide. In addition, be sure to run the FTP Suite installation procedure and FTP Suite Configuration (refer to the FTP Suite Configuration guide available at www.reuters.com/tvdocs). Select transfer Copy to Folder feature (via FTP Suite) 1. Login to the WNE client 2. Click the Administration link 3. Review the values of the Script Copy Directory and Video Copy Directory fields. The values of these fields should be the same as the value you specify in the Local source directory during the FTP Suite configuration. For a full description of the WNE administrative fields, refer to the Appendix of this installation guide. In addition, be sure to run the FTP Suite installation procedure and FTP Suite Configuration (refer to the FTP Suite Configuration guide available at www.reuters.com/tvdocs). 1. Login to the WNE client 2. Click the Administration link 3. Review the values of the Script Copy Directory and Video Copy Directory fields. For a full description of the WNE administrative fields, refer to the Appendix of this installation guide. Creating new user accounts Once you have completed the WNE 4.1 installation, create any user accounts you require. Any accounts created in WNE v.3.0.16 will not function in WNE v.4.1 and will need to be recreated. To create a WNE user account, use the procedure below: 1. Login to the WNE website as the Administrator account (you should already have the password). 2. Click the Administration link in the upper right hand corner of the page. 3. Select the User Management tab. 4. Click the Add New link next to Displaying Users. 5. Enter the user ID for the user account you are creating in the User Name field (e.g., jdoe). The user ID you enter must not exceed 15 characters. 6. Enter the password for the user account you are creating in the Password field. 7. Enter the name to be used for the user account (e.g., John D). This is the name that will appear on the top of the WNE website page when the user is logged in. 8. Click Save. The user account will be created. WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 6
If you want, you can test the account by logging in as that user to ensure that the account was created properly. Be sure to inform all of your users what their user IDs and Passwords are if they do not already know them. Restart your WNE PC Once you have completed the creation of your user accounts, restart your WNE PC. Post-installation validation checks Verify File Direct application status There should only be a single instance of File Direct running. The File Direct application window should appear as shown below: Note: It may take up to 30 minutes for the File Direct Traffic light to turn green (from yellow). Verify status of required services Access the Services window in Windows: 9. Click Start Control Panel in Windows. 10. Double-click Administrative Tools. 11. Double-click Services. WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 7
Verify that the services below are in the following states: Service Status Startup Type Apache2.2 Started Automatic MySQL Started Automatic WnePlayer Started Automatic World Wide Web Publishing Disabled Appendix A: Description of all WNE Administrative settings This section describes the Administrative settings within the WNE Client PC. These settings are divided into several categories: File Direct, Website, Player, Advanced. Each group of settings is accessed via a separate link on the Settings tab. These settings are accessed via the Administration link in the upper right hand corner of the WNE website. Note: After making changes to any of the settings on these tabs, you must click Save Settings. You may also be prompted to restart File Direct and/or the WNE player service. File Direct tab Field WNE Client Health Name IP Address of EMR MAC Address of EMR Beep on new video arrival Script Feed Directory Video Feed Directory Advisory Feed Directory Description Indicates state of the traffic lights running on the WNE PC [this is a displayonly field]. Name that has been assigned by Reuters to your WNE PC. This must exactly match the name that was supplied by Reuters. IP Address of the EMR device. This is the MAC Address of the EMR [this is a display-only field]. This field is used for troubleshooting purposes. Instructs WNE PC to produce an audible beep sound when a video is processed. Directory containing processed script files intended to feed another source (e.g. FTP). If you are using the Reuters FTP Suite with the WNE client, the value specified in this field much be identical to the value specified as the Local source directory in the FTP Suite configuration (e.g., E:\Reuters\Feed). Directory containing processed video files intended to feed another source (e.g. FTP). If you are using the Reuters FTP Suite with the WNE client, the value specified in this field much be identical to the value specified as the Local source directory in the FTP Suite configuration (e.g., E:\Reuters\Feed). Directory containing processed Advisory files intended to feed another source (e.g. FTP). If you are using the Reuters FTP Suite with the WNE client, the value specified in this field much be identical to the value specified as the Local source directory in the FTP Suite configuration (e.g., E:\Reuters\Feed) WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 8
Field Script Copy Directory Video Copy Directory Video Home Drive max percent used Days to keep Videos and Scripts Days to keep Advisories Days to keep files in Feed/Copy directories Days to keep Unprocessed Videos Days to keep to Playout History Description Destination directory for script (i.e., metadata related to the video) files which are copied when using the website copy function. If you do not specify a value in this field AND the Video Copy Directory field, the Copy function (including the Add Page to Copy folder and Add to Copy folder functions and the Copy History sub-tab) will not be available within your WNE client. If you are using the Reuters FTP Suite to move files that have been Copied to Folder with the WNE client, the value specified in this field much be identical to the value specified as the Local source directory in the FTP Suite configuration (e.g., E:\Reuters\Copy). Note: If you set this field to a location which resides on a network drive, refer to Appendix E for instructions on how to update your web server configuration to allow this. In addition, be sure to use UNC paths instead of mapped network drive paths when setting the value of the Script Copy Directory field. For example use: \\192.168.1.4\SharedFolder\Resource instead of Z:\ SharedFolder\Resource (where Z: is a network drive mapped to 192.168.1.4) Destination directory for video files which are copied when using the website copy function. If you do not specify a value in this field AND the Script Copy Directory field, the Copy function will not be available within your WNE client. If you are using the Reuters FTP Suite to move files that have been Copied to Folder with the WNE client, the value specified in this field much be identical to the value specified as the Local source directory in the FTP Suite configuration (e.g., E:\Reuters\Copy). Note: If you set this field to a location which resides on a network drive, refer to Appendix E for instructions on how to update your web server configuration to allow this. In addition, be sure to use UNC paths instead of mapped network drive paths when setting the value of the Video Copy Directory field. For example use: \\192.168.1.4\SharedFolder\Resource instead of Z:\ SharedFolder\Resource (where Z: is a network drive mapped to 192.168.1.4) This value is the maximum percentage of the drive (e.g., E:/) on which your Video Home Directory exists that may be used before the WNE client will automatically begin purging video and script files from the drive. The WNE client will only purge enough files to bring the hard disk utilization below the percentage value specified in this field. Note: If you have customized the drive used by WNE since installation, the disk space on this drive may be used by files unrelated to the WNE Client. As a result, the maximum percentage used threshold may be exceeded more quickly. The WNE client will only purge files related to itself (not other applications). Number of days for which to keep videos and scripts (before they are purged from the system). Note: The WNE client will allow you to potentially store videos and scripts for a longer period of time than specified here provided you have not yet exceeded your hard disk space maximum utilization percentage. Once you exceed that percentage, the WNE client will automatically purge files until you are below both the values set in the Days to keep Videos and Scripts and Video Home Drive max percent used fields. Number of days for which to keep Advisories (before they are purged from the system). Number of days for which to keep items (e.g., videos, advisories and scripts) in the Feed and Copy folders (specified via the applicable Administrator settings). Number of days to keep encrypted videos which you are not permissioned to decrypt. Encrypted videos older than the # of days specified here, will be purged from the Satellite Incoming Directory, Alternative Incoming Directory and CDN Incoming Directory locations. Number of days of Playout history maintained. WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 9
Field Days to keep to Copy History Website Field Max Stories per page Max Advisories per page Played/Copied column indicator Display Playout Show Video previews Playout Field Player Health Genlock Genlock Offset ARC Playout in 4:3 Playout Video Standard Show Waiting Video for Playout Description Number of days of Copy history maintained. Description Maximum number of stories per page on the Stories tab. Maximum number of advisories per page on Advisories tab. Defines which of two visual indicators will appear on the Stories tab. This can be either Played (i.e. manually played videos) or Copied (i.e. manually copied videos) to indicated which videos have been played or copied. Suppresses display of WNE Player and playout-related functions in the WNE Client. If you set this field to Disabled and your Playout mode is set to Auto or Loop, playout of video content will continue via the Stradis card but you will be unable to control playout behavior (e.g., number of videos in Loop Playout mode, changing Playout mode). Indicates whether a low resolution version of the selected video (as opposed to just a text description) will be available in the preview window Description Indicates state of the Stradis card playout from the WNE PC [display-only field]. The Genlock feature allows the linear video output of the WNE Player service to be synchronized to an external reference. To use this feature, a standard composite (PAL or NTSC) Black & Burst reference signal must be connected to the Genlock input connector of the WNE Player service. Note: If you will be utilizing Genlock, you must first install a patch to ensure the properly functioning of this feature. The patch file is named genlockpatch10262009.msi and can be found in the following directory on the WNE PC: C:\Program Files\SkyStream Networks\zBand Corporate Edition\Storage\Reuters Updates\WNE Client 4-1 To apply the patch, simply double-click the file (it will then install itself). Genlock offset allows the timing of the video output to be adjusted relative to the genlock external reference input. Automatically converts aspect ratio of all incoming format videos to 4:3. If this field is set to disabled, playout mode will use native Aspect Ratio for every video. Specifies the video standard to be used for playout (e.g., 525 or 625). You must ensure that the value set here matches the video standard of the files being received by the satellite. If you are unsure what standard you are using, please contact a Thomson Reuters representative before enabling the WNE Client. Plays out a waiting message via the Stradis card when no videos are being played. Advanced The settings on this page should not be edited on a routine basis. Please contact your Reuters WNE support representative if you have questions about a particular field on this page. Changing these settings can have an adverse effect on your WNE PC and therefore the WNE service overall. WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 10
Appendix B: Troubleshooting This section provides solutions for problems that may be encountered while running your WNE 4.1 installation program. Problem Potential Cause Possible Solutions Error message displayed about the StradisDecoder.dll WNE playout via the Stradis card is frozen. 1. Remove the Player.exe (located under Start Programs Startup) shortcut. 2. Stop the WNE Player service by right-clicking on its icon in your Taskbar (usually along the bottom right of your Windows desktop) and selecting Exit from the menu that appears. 3. Right-click on the Taskbar and select Task Manager from the menu. Ensure that player.exe is no longer running on the Processes tab. If it is, select it and click the End Process button. 4. Click Start Control Panel in Windows. Double-click Add or Remove Programs. Select the Stradis Decoder Driver and click Remove. 5. Reboot your WNE PC. 6. Begin the WNE 4.1 installation again. A window is displayed stating installation is waiting on File Direct in order to proceed. Installation program is unable to shut down the File Direct program. 1. If the File Direct window is being displayed (small window with Traffic light status indicators), close it. 2. Right-click on the Taskbar and select Task Manager from the menu. Ensure that filedirect.exe is no longer running on the Processes tab. If it is, select it and click the End Process button. 3. Proceed with the WNE 4.1 installation by clicking Retry. Appendix C: Rollback This section describes the actions you should take in the event that your WNE 4.1 installation failed to complete successfully. Be sure to refer to the Appendix B: Troubleshooting section of this document to verify that the problems encountered during the installation cannot be remedied. Contact your Reuters WNE representative for assistance. Note: The WNE 4.1 installation program creates an install.log file in the directory in which you ran the installation. This file can provide useful information to the Reuters technical staff when troubleshooting the cause of your problem with the WNE 4.1 installation. We therefore strongly recommend that you send a copy of this log file to your Reuters WNE representative prior to beginning the steps in the procedures below. Ensure that File Direct is not running 1. If the File Direct window is being displayed (small window with Traffic light status indicators), close it. 2. Right-click on the Taskbar and select Task Manager from the menu. Ensure that filedirect.exe is no longer running on the Processes tab. If it is, select it and click the End Process button. WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 11
Remove the WNE 4.1 program 3. Click Start Control Panel in Windows. 4. Double-click Add or Remove Programs. 5. Select World News Express and click Remove. Remove the new Stradis driver 6. Click Start Control Panel in Windows. 7. Double-click Add or Remove Programs. 8. Select the Stradis Decoder Driver 1.71 and click Remove. Enable IIS 9. Click Start Control Panel in Windows. 10. Double-click Administrative Tools. 11. Double-click Services. 12. Double-click World Wide Web Publishing. 13. Select Automatic from the Startup Type menu. 14. Click OK. Restore WNE 3.0.16 shortcuts 15. Browse to the C:\Program Files\Reuters\WNE Client\3.0.16\Scripts\Start Menu Items directory via Window Explorer. 16. Copy all of the shortcuts located in that directory (using the Windows clipboard) 17. Paste them into the Start Programs Startup menu. Re-register your WNE client.dll 18. Click Start Run. 19. Enter the following regsvr32 "C:\Program Files\Reuters\WNE Client\3.0.16\WNEClient.dll" in the Open field and click OK. The following message will be displayed. Reinstall the old Stradis driver 20. Contact your Reuters WNE representative and request a copy of the Stradis Decoder Driver 1.64. 21. Once you have obtained a copy of this driver, run it on your WNE PC. 22. Reboot your WNE PC. Appendix D: To uninstall WNE 4.1 As stated, if you have already installed WNE 4.1 on the PC where you plan run the WNE 4.1 installation, you must first un-install WNE 4.1, then reinstall it. To un-install WNE 4.1: 1. Make note of any WNE settings that you have customized via the WNE website. This includes settings configured via the Settings tab (e.g., Name, IP address of EMR). These settings will be deleted as part of the WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 12
WNE 4.1 un-installation process. You will also need to recreate any user accounts you have created via the WNE website, so be sure to note the user IDs and passwords of all of your WNE users. 2. Click Start Control Panel in Windows 3. Click Add or Remove Programs. 4. Select World News Express and click Remove. 5. When done, re-install WNE 4.1 using the steps documented in the Installation Procedure section of this document. 6. Recreate all of your WNE user accounts (refer to the Creating new user accounts section of this document) and reconfigure any settings that you may have customized in your previous version of WNE. Appendix E: To set your Copy Folder to a location on a network drivek drive Note: This appendix is only necessary if you are using the Copy to Folder option in WNE and have set the Script Copy Directory and Video Copy Directory fields (on the File Direct page of the Administrative Settings tab) to a location which resides on a network drive. Warning: Depending on the throughput capacity of your network and how often you plan to use the Copy to Folder function, implementing it in this manner may have an adverse affect on the performance of your WNE system. As a result, we advise that you consider copying to a local folder and using FTP Suite instead of copying to a network drive. Test to ensure that you can reach the network share (to which you plan to set your Copy Folder) from Windows Explorer on the WNE PC. In order to perform this procedure, you must have full read/write privileges on this network share. Depending on how your network has been configured, the network drive (on which this copy folder will reside) may also need to be on the same domain as your WNE PC. 1. Click Start Control Panel in Windows. 2. Double-click on Administrative Tools. 3. Double-click on Services. 4. Double-Click on Apache 2.2. 5. Select the Log On tab. 6. Select the This Account option. 7. Enter the Username and Password for Administrator account in the appropriate fields. Click OK. Note: A notification message may be displayed informing you that the Administrator account has been granted the Log on privilege as a Service Right. In addition, you may be prompted to restart the Apache2.2 service. 8. To restart the Apache service, right-click the Apache2.2 Service and select Restart from the menu that appears. WNE 4.1 Installation Guide WNE v.4.1.10, v.4.1.11 13