Novar™ 6.0.x - Imagine Communications
Transcription
Novar™ 6.0.x - Imagine Communications
Installation Guide Novar™ 6.0.x Remote Office and MediAExec™ 3.3 March 2015 Delivering the Moment Publication Information © 2015 Imagine Communications Corp. Proprietary and Confidential. Imagine Communications considers this document and its contents to be proprietary and confidential. Except for making a reasonable number of copies for your own internal use, you may not reproduce this publication, or any part thereof, in any form, by any method, for any purpose, or in any language other than English without the written consent of Imagine Communications. All others uses are illegal. This publication is designed to assist in the use of the product as it exists on the date of publication of this manual, and may not reflect the product at the current time or an unknown time in the future. This publication does not in any way warrant description accuracy or guarantee the use for the product to which it refers. Imagine Communications reserves the right, without notice to make such changes in equipment, design, specifications, components, or documentation as progress may warrant to improve the performance of the product. Trademarks Product names and other brands are trademarks or trade names of Imagine Communications or its subsidiaries. Microsoft® and Windows® are registered trademarks of Microsoft Corporation. All other trademarks and trade names are the property of their respective companies. Contact Information Imagine Communications has office locations around the world. For locations and contact information see: http://www.imaginecommunications.com/contact-us/. Support Contact Information For support contact information see: Support Contacts: http://www.imaginecommunications.com/services/technical-support/ eCustomer Portal: http://support.imaginecommunications.com © 2015 Imagine Communications Corp. Proprietary and Confidential Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Contents Contents Pre-Installation .......................................................................................................... 5 Overview.................................................................................................................5 Before You Begin ....................................................................................................5 Minimum Requirements ........................................................................................6 Third Party Software Requirements ..........................................................8 Backing Up the System ...........................................................................................8 MediAExec Client.......................................................................................8 Remote Office Web Site (RSS, RAS, MediAExec) .......................................8 Restricting User Access During Installation ............................................................9 Running the Pre-Installation...................................................................................9 Verify Novar Database Settings - SQL Server 2000 ...................................9 Verify Novar Database Settings - SQL Server 2005 .................................10 Installation .............................................................................................................. 12 Overview...............................................................................................................12 Installing on the Novar Database Server ..............................................................12 Run the Data Initialization Scripts ...........................................................12 Set Novar System Configuration Settings................................................13 Set Up Scheduled Jobs.............................................................................14 Installing on the Web Server ................................................................................15 Create Remote Office / Media Exec Website & Virtual Directory ..........15 Install and Configure MediAExec Web Service .......................................21 Remote Office Website Installation continued .......................................26 New Installation of MediAExec Client .....................................................45 Upgrading MediAExec WebService and Client ........................................45 Configuring the System ........................................................................................50 MediAExec Order Review Process...........................................................50 Remote Office / MediAExec User Permissions........................................51 AE Groups and User Groups ....................................................................52 © 2015 Imagine Communications Corp. Proprietary and Confidential Page i of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Contents Remote Office Configuration Settings .....................................................54 Installing on the Client..........................................................................................55 New Installation of MediAExec 3.3 .........................................................55 Upgrading MediAExec Client to 3.3 from 3.1 or an older version ..........59 Upgrading to MediAExec Client 3.3 from version 3.2 or later ................60 Post-Installation ...................................................................................................... 61 Overview...............................................................................................................61 Installation Verification ...........................................................................61 Notifying Imagine Communications of Installation .................................63 Troubleshooting ...................................................................................................... 64 Possible Issues ......................................................................................................64 Contacting Support...............................................................................................67 Data Flow Diagram .................................................................................................. 68 Additional Reference Material ................................................................................. 69 Novar Installation Documents ..............................................................................69 How to verify the MDAC Version .........................................................................69 How to Install Internet Information Services (IIS) ................................................70 Appendix A - Scheduling a Job .................................................................................. 74 Microsoft SQL Server Enterprise Manager 2000 ..................................................74 Microsoft SQL Server Management Studio 2005 .................................................78 Appendix B - Stored Procedures and Functions Used by MediAExec .......................... 81 Appendix C - Obsolete MediAExec Items .................................................................. 83 Appendix D - Obsolete Remote Office Items ............................................................. 86 Appendix E - Special Installations ............................................................................. 87 Create ODBC connection if Alternate Port is used for SQL Server .......................87 SMTP Email Server must be set up if web server is client hosted........................88 Install Verification Form ........................................................................................... 91 © 2015 Imagine Communications Corp. Proprietary and Confidential Page ii of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Pre-Installation Pre-Installation Overview This document is an installation guide for Remote Office applications (Remote Sales System (RSS) and Remote Accounting System (RAS)) and MediAExec™ 3.3. Some troubleshooting information has also been included. It is assumed throughout this document that the installed Novar release is 6.0.x or higher. Imagine Communications recommends reading through the entire document to familiarize yourself with the entire installation process before beginning. Before You Begin 1. Gather the information required for the Installation and Configuration: Install media or share path ________________________________________________ Path where installed on Server ______________________________________________ Website Description (text) _________________________________________________ Http Server Name (Host Header) ____________________________________________ (This name must be added to the DNS.) SQL server name & IP Address ______________________________________________ SQL Server user ID (usually sa) _____________________________________________ SQL Server sa password __________________________________________________ SQL Server Novar DB name ________________________________________________ Local machine user with Admin access, for COM+ _______________________________ SMTP Server, for e-mail delivery _____________________________________________ NOTE Custom Logo.gif file is provided by client and must be 250w x 77h in 256 colors. For MediAExec web server: Http Virtual Directory Alias ________________________________________________ (This is usually similar to D:\Remoteoffice\MEPP30WS) 2. Determine if installation is a new installation or an upgrade. 3. Determine exactly what will be installed. Is this a complete installation of Remote Office (RSS and RAS) and MediAExec? © 2015 Imagine Communications Corp. Proprietary and Confidential Page 5 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Pre-Installation 4. For new installations of MediAExec, determine the Order Review Process that the client requires. 5. Prior to installing MediAExec, request and complete a Preparation Checklist and return it to Novar Support. This must be done several days in advance of installation so that the customized files can be delivered on the CD that contains the software. NOTE The software for Remote Office and MediAExec is delivered on the same disc as the core Novar software. 6. The Novar database must be upgraded before beginning the installation of Remote Office or MediAExec. *This is accomplished by running the Novar Database Upgrade Script. 7. The Novar software and stored procedures must be installed or upgraded to the latest version before beginning the installation of Remote Office or MediAExec. The Remote Office and MediAExec stored procedures will be in the same directory as the standard Novar stored procedures. When UtilRep.exe is run to install the Novar stored procedures, the Remote Office and MediAExec stored procedures will also be installed. Minimum Requirements This section covers hardware requirements for sites that are self-hosting web servers for the Novar Remote Office systems: Remote Sales System (RSS) and Remote Accounting System (RAS) and MediAExec. Remote Office and MediAExec applications are based on Microsoft IIS and require: Microsoft Windows Server 2003 (SP2) with IIS 6 Web Server Software FX – Chart FX 2000 IE Graphics Software (single CPU license) Crystal Reports Professional V 9.0 or higher (for RAS only) There are varying computer hardware requirements for remote-office operations. The primary metric used to scale the hardware is the user count. Your account representative may modify these base recommendations to help you achieve optimal performance. Basic remote-office sizing categories include: Small (Less than 20 users) Large (20 or more users) © 2015 Imagine Communications Corp. Proprietary and Confidential Page 6 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Pre-Installation Remote Office Web Server Requirements Type Hardware Software Operating System Description 10 GB Hard Disk RAID Level 1 Drive Array (net of Raid) Network Interface Card - Gigabit Ethernet For Small Systems (less than 20 users): o P4 3.0 Ghz o 1GB RAM For Large Systems (20 or more users): o 2 processor P4 3.0 Ghz o 2 GB RAM Note: The use of the word processor is not intended to be interpreted as meaning strictly physical CPUs. Multi-core CPUs are acceptable. (For example: 2 dual-core CPUs = 4 processors) Software FX - Chart FX 2000 IE Graphics Software (single CPU license) SMTP (Email) Server This is not required to be on the same server as IIS. Special handling is required. MDAC 2.8 can be downloaded from this link: http://www.microsoft.com/downloads/details.aspx?FamilyID=6c05 0fe3-c795-4b7d-b037-185d0506396c&DisplayLang=en Microsoft Windows Server 2003 SP2 with IIS 6 Microsoft Internet Explorer (IE) version 5 or later ASP.NET 1.1.4322 Client PC Requirements Type Hardware Software Description Operating System Microsoft Internet Explorer (IE) version 5 or later .NET Framework Version SP11.1.4322.2032. Pre-SP1 1.1.4322.573 is not supported. To determine the version, view file properties under the Version Tab for this file: C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322\mscorlib.dll Update for SP1 may be found at the following Microsoft site: http://www.microsoft.com/downloads/details.aspx MDAC 2.8 can be downloaded from this link: http://www.microsoft.com/downloads/details.aspx?FamilyID=6c05 0fe3-c795-4b7d-b037-185d0506396c&DisplayLang=en Windows 2000 or XP © 2015 Imagine Communications Corp. Proprietary and Confidential Page 7 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Pre-Installation Third Party Software Requirements Clients are required to acquire proper licensing for the following products: Crystal Reports Crystal Reports is used for Remote Accounting System (RAS) reports such as Aging and Month End. Sites will need: Crystal Reports Pro 8.5 Crystal Reports Enterprise Crystal Reports Professional V 9.0 or higher (for RAS only) The current license (key code) information can be obtained by opening Crystal Reports and selecting the Help menu and About option. For more information on this application, click http://crystalreports.com/. ChartFX IE 2000 Server 4.0 ChartFX 2000 is used for AIMS graphs in Remote Sales System (RSS). Software FX – Chart FX 2000 IE Graphics Software (single CPU license) For information contact: SoftwareFX at www.softwarefx.com or 800-392-4278 for license information. (Proof of purchase may be required) To obtain current licensing information navigate to C:\Program Files\CfxIE4\License\CfxIE.lic. HTMLDoc The (GNU General Public License) will be needed to generate PDF output for RAS reports such as Aging and Month End, and RSS reports such as Monthly Revenue, Payment Summary, Contract Summary, Sales Confirmation, etc. This software is included with the Remote Office application. Backing Up the System MediAExec Client It is not necessary to back up the local .cds files before upgrading. They will be rebuilt by the Install New Novar Data Files process after the upgrade is complete. If desired, they can be zipped and placed in another directory during pre-installation for safekeeing. Remote Office Web Site (RSS, RAS, MediAExec) Files pertaining to existing web sites should be backed up prior to the upgrade. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 8 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Pre-Installation Restricting User Access During Installation While the core Novar system can normally be used during a Remote Office / MediAExec installation and upgrade process; Remote Office and MediAExec cannot be used by anyone while they are being upgraded. Please plan these upgrades when users will not be accessing the system. Running the Pre-Installation Verify Novar Database Settings - SQL Server 2000 1. Using SQL Server Enterprise Manager, select the client’s database and right mouse click to view its properties. Under the Options tab, verify Compatibility Level is set to “Database compatibility level 80”. Click OK to accept changes. 2. From the SQL Server Enterprise Manager menu, select SQL Query Analyzer Tools. 3. Select Options under the Tools menu. 4. Select Connection Properties tab, and verify the Set quoted identifier checkbox is cleared (shown next). Click OK to accept changes. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 9 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Pre-Installation Verify Novar Database Settings - SQL Server 2005 1. Open SQL Server Management Studio and connect to the server. 2. Select the Novar database and right mouse click to view its properties. 3. On the Options page, verify Compatibility Level is set to “SQL Server 2000 (80)”. 4. Select the Novar database and right mouse click. Select New Query. 5. Select Options under the Tools menu. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 10 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Pre-Installation 6. Open Query Execution SQL Server ANSI and verify the SET QUOTED IDENTIFIER checkbox is cleared. Click OK to accept changes. (shown next) © 2015 Imagine Communications Corp. Proprietary and Confidential Page 11 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation Installation Overview Remote Office is a web site that contains three main sections: RSS - Remote Sales System RAS - Remote Accounting System MediAExec The MediAExec installation includes: MediAExec Proposal Plus (the Dashboard), which is a locally installed user application; the MediAExec section of Remote Office; and a web service that is used to access the Novar database from the Dashboard. The RSS, RAS, and MediAExec applications are each licensed separately; however, most MediAExec clients are also licensed for RSS. Installing on the Novar Database Server Run the Data Initialization Scripts To ensure that the database structure is correct for this release, the Novar Database Upgrade Script must be run before running any of these scripts. 1. For MediAExec, initial data needs to be loaded using the following scripts* from MEPP/Install folder. *These are scripts, not stored procedures. Open each one in a SQL Query Analyzer Tool Query window and run it. InitializeTableME_AE_Columns.sql InitializeTableNCE_Client_Config.sql InitializeTableNCE_Key2Table.sql InitializeTableNCE_Replace_Tvalues.sql InitializeTableNCE_Table_Column_Info.sql InitializeTableNCE_Table_Config.sql InitializeTableNCE_TableID.sql InitializeTableOrderReviewProcess.sql InitializeWebME_valuesTableAreaAndAreaAction.sql 2. For Remote Office, initial data needs to be loaded using the following stored procedures and scripts from the C:\RemoteOffice\Install folder on the web server. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 12 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation For RSS, the RSS_Update_Area_Tables Novar stored procedure (NSP) needs to be run. NOTES There are some permissions that did not exist in older releases of Novar. Therefore, after running the RSS_Update_Area_Tables NSP, these permissions will need to be set up in Operator Setup* for the appropriate people. *Until the RSS_Update_Area_Tables NSP is run, these permissions will not exist and therefore cannot be set up from the Operator Setup window. a. Drag the RSS_Update_Area_Tables procedure into a query window. b. Highlight the "drop proc RSS_Update_Area_Tables" in the stored procedure and run the command. Verify nothing else is highlighted in the stored procedure and click Execute to create the new version of this stored procedure on the database. Once complete, close the query window. c. Open a new query window and run the command: exec RSS_Update_Area_Tables '', '' Each parameter is two single apostrophes, not double quotes. Each parameter is an empty string with a single quote at the beginning and at the end. NOTES Steps 2a. – 2b. only need to be run once after an upgrade to install the latest version of the stored procedure. Step 2c. may be run multiple times, but once should be sufficient, in most cases. For RAS, the RAS_Update_Area_Tables script needs to be run. Open the RAS_Update_Area_Tables script in a query window, verify nothing else is selected, and run it. Set Novar System Configuration Settings Use SystemConfig in the Novar™ application to change the following settings as applicable. Set MediaExec = True. Set MediaExecRSS to the URL for Remote Office / RSS (e.g.: http://RemoteOffice.com/RSS) or leave blank when not applicable. MediaExecRateCardSyncPageSize is created by one of the installation scripts with a default value of zero (0). Leave setting at zero if rate cards are not used – or when only a relatively small number of rate cards will be created. Set to 50000 if rate cards are used and a relatively large number will be created. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 13 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation This new setting will be used the next time the nightly scheduled task for NSP: nsp_RateCardME_MakeView runs (shown in the next section). This setting may be changed at any time to optimize performance. Set MediaExecCRM with URL (e.g.: http://www.SalesNet.com) or leave blank when not applicable. MediaExecCRM is no longer supported by Imagine Communications. The information has been left in the document for reference – in case some clients are still using it. The setting should not be changed. Set Up Scheduled Jobs Schedule the following jobs on the Novar Database. Each job will be run at least once. For more detailed information on setting up these scheduled jobs, please see Appendix A – Scheduling a Job. The first three jobs are used to load data for the AE Scheduling Exceptions report. The fourth job creates the Rate Card Sync table if it does not exist, and loads rate-card data into it***. *This table must exist whether or not rate cards are used. **If rate cards are not used, the recurring scheduled job will not be necessary; however, the command must still be run once to ensure the Rate Card Sync table is created. Job to be Scheduled Frequency Notes nsp_IN_AdcopyStatus Nightly, 5 PM Loads ad copy exceptions into the LineException table declare @WeekNum smallint set datefirst 1 select @WeekNum = convert(smallint, (datepart(yy,getdate())%100)*100 + datepart(wk,getdate())) exec nsp_IN_ASExceptions 0, 0, @WeekNum Run after scheduling process, Nightly, M-F, 8 PM Loads non-ad copy exceptions into the LineException table nsp_LineExceptionClean Weekly, Sun, 3 PM Removes line exceptions older than the current week. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 14 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation Job to be Scheduled Frequency Notes The first parameter = Last Mod Date. (It is typically set to '01/01/1900') nsp_RateCardME_MakeView '01/01/1900', 52 Nightly, 9 PM* The second parameter = Number of weeks of rate cards to retrieve, starting with the current week. (It is usually set to 15 or 52) *When rate cards are not used, run the scheduled job one time and then disable it. Installing on the Web Server The installation steps will differ when doing a new install of Remote Office or MediAExec versus an upgrade. There are several additional sections that must be completed when installing the Remote Office or MediAExec applications for the first time. Create Remote Office / Media Exec Website & Virtual Directory 1. Copy the Remote Office folder from the Novar Install CD or directory to the web server, such as C:\RemoteOffice. 2. If MediAExec is also being installed, also copy the MEPP30WS folder from the Novar Install CD to the C:\RemoteOffice folder. 3. Create the Website. a. Right click on My Computer and choose Manage, or Open Internet Information Services (IIS) Manager if a menu or desktop item has been created. b. Expand Services and Applications Internet Information Services (IIS) Manager, right click on Web Sites and select New Web Site… (Shown next) © 2015 Imagine Communications Corp. Proprietary and Confidential Page 15 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation c. Click Next to create the website using the Web Site Creation Wizard. d. On the Web Site Description window, enter a description for the new website and click Next. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 16 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation e. On the IP Address and Port Settings window, Verify Enter the IP address to use… list box = (All Unassigned). TCP Port… = 80. Enter*** Host header… value such as ImagineCommunications1.dennovar1.com or RSS.client.com and click Next. *This field must not be left blank. **If unknown, please contact the local IT department to have a DNS entry created to point to the correct server. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 17 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide f. Installation On the Web Site Home Directory window, enter or browse* to the path where the Remote Office files were copied and click Next. *It is recommended that Browse… is used to ensure the path name is inserted correctly and not misspelled. g. On the Web Site Access Permissions window, select the Run scripts (such as ASP) check box and click Next. h. Click Finish to complete the website installation. 4. Install the virtual directory for the new website. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 18 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation a. Right click on My Computer and choose Manage, or Open Internet Information Services (IIS) Manager if a menu or desktop item has been created. b. Expand Services and Applications Internet Information Services (IIS) Manager Web Sites, right click on the newly created website name (RemoteOffice) and select New Virtual Directory… (Shown next) c. Click Next to create the virtual directory using Virtual Directory Creation Wizard. d. On the Virtual Directory Alias window, enter Common in the Alias: field and click Next. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 19 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation e. On the Web Site Content Directory window, browse to, or enter, the path to the Common Files folder in the Remote Office path and click Next. f. On the Virtual Directory Access Permissions window, select the Run scripts (such as ASP) check box and click Next. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 20 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation g. Click Finish to complete the virtual direction section of the installation. Install and Configure MediAExec Web Service If this site will also be using the MediAExec addon application, the MediAExec web service must be installed and configured now as part of the Remote Office installation. 1. Copy MEPP30WS folder to the folder created for Remote Office (C:\RemoteOffice). 2. Create virtual directories for these two folders. MEPP30WS (Virtual Directory) Common Files (Virtual Directory) © 2015 Imagine Communications Corp. Proprietary and Confidential Page 21 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 3. Right click MEPP30WS folder and select Properties. 4. On the Directory tab, click the Create button. Note that MEPP30WS now displays in the Application name: field. 5. Click OK. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 22 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 6. Repeat steps 3 – 5 to set up the Directory properties for the Common Files folder. 7. Create virtual applications for the following MediAExec (ME) features: AESetup AlternateApprover OrderPromoteCodes OrderReview CheckAvails a. Right click on My Computer and choose Manage, or Open Internet Information Services (IIS) Manager if a menu or desktop item has been created. b. Expand Services and Applications Internet Information Services (IIS) Manager Web Sites RemoteOffice ME Config, right click on the first ME application (AESetup) and select Properties. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 23 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation c. Click Create button. Note that virtual application (AESetup) now displays in the Application name: field d. Click OK to complete. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 24 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation e. Repeat for the remaining ME application folders: AlternateApprover OrderPromoteCodes OrderReview CheckAvails NOTE Virtual directories and applications are represented with a Cog icon. 8. Set the ASP Script Timeout to 900 seconds. a. Expand Services and Applications Internet Information Services (IIS) Manager Web Sites RemoteOffice, right click and select Properties. b. Selecting Home Directory tab, and click Configuration… button. c. On the Options tab, change ASP Script Timeout to 900 seconds. Click OK. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 25 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation Remote Office Website Installation continued Once the MediAExec web service is configured, continue the Remote Office installation. 1. Right click on My Computer and choose Manage, or Open Internet Information Services (IIS) Manager if a menu or desktop item has been created. 2. Expand Services and Applications Internet Information Services (IIS) Manager Web Sites RemoteOffice, right click and select Properties. 3. Select the Documents tab and verify index.asp is displayed at the top of the default content page list in the top box. a. If index.asp is not in the list, click Add. b. Enter index.asp in the Default content page field, and click OK. The index.asp option is now displayed in the top box. 4. Select index.asp and click Move Up to move the entry to the first item in the list. 5. Click OK to exit the Properties window. 6. Click Web Service Extensions folder to verify ASP.NET displays. If ASP.NET does not display, it must be enabled. All Remote Sales System (RSS) websites use ASP.Net 1.1.4322. If this version of ASP.NET does not show in the ASP.NET Version list box on the Website Properties ASP.NET tab, verify that it is installed by navigating to the C:\WINDOWS\Microsoft.NET\Framework folder and looking for the subfolder named v1.1.4322. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 26 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation a. If it exists, register it. Go to Start Run and type C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322\aspnet_regiis.exe –i (The exact path may differ in some installations, but this is a typical path.) NOTES The properties tab displays these values: In order for Remote Office to function properly, Active Server Pages, ASP.NET v1.1.4322 and ASP.NET v2.0.50727 must be enabled / allowed. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 27 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation (If other applications are being run on this web server, other extensions may also be enabled.) b. Once it is registered, enable it. To enable the extension, right click ASP Extension Name, and click Allow. 7. From Programs Administrative Tools, select Component Services. 8. Expand Component Services My Computer, right click COM+ Applications to select New Application. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 28 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 9. Click Next to use the COM+ Application Install Wizard to install. 10. Select Create an empty application. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 29 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 11. Enter the name Remote Office in the Enter a name… field. Click Next. The name for the new application must be “Remote Office” because the “name” entered here is used throughout the application. 12. Ensure Interactive User is selected, click Next. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 30 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 13. On the Add Application Roles window, click Next. NOTE Selecting the Interactive User option requires that a user with network access be logged in at all times. Local Service may be required. 14. On the Add Users to Roles window, click Next. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 31 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 15. Click Finish to complete the COM+ Application setup. Configuring Remote Office Components Once the COM+ application has been set up, the components need to be configured. 1. From the COM+ Application, navigate to Remote Office Components and right click to select New Component. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 32 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 2. Click Next to use the COM+ Component Install Wizard to install. 3. Click Install new component(s). NOTE When multiple websites are hosted on one server, users will need to create a generic folder off of the root drive to hold these component files. Copy the Component folder to the new folder and browse to that new folder. 4. Browse to the location of the Remote Office Component folder. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 33 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 5. Select all files in the folder, click Open. 6. Click Next to install the new component files. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 34 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 7. Click Finish. The Remote Office applications are now displayed in the Components folder. (shown next) Configuring Remote Office Security To set up security for the Remote Office application: 1. To change Security settings, navigate to Remote Office Properties window and select the Security tab. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 35 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 2. In the Authorization section, verify the Enforce access checks for this application check box is cleared. Click OK. Starting the Remote Office Website To start the website application, navigate to Com+ Applications Remote Office, right click and select Start. (shown next) NOTE If the Catalog Error displays, change the Identity settings. Changing Identity Settings To change Identity settings, navigate to Remote Office Properties window and select Identity tab. 1. On the Account region, click System Account and the Local Service – built in service account radio buttons. (shown next) © 2015 Imagine Communications Corp. Proprietary and Confidential Page 36 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 2. In the This user: field, installers may need to enter a local-machine administrator’s user profile. This will typically be IUSR_machinename user profile. 3. Restart the Remote Office Com+ applications and verify it is running. Modifying Host Headers / Web Site names If the website Host Headers were not set up properly initially, they will need to be modified with the correct name(s) for this configuration. 1. From the main Internet Information Services (IIS) screen, right click Remote Office website, select Properties. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 37 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 2. Select Web Site tab, click Advanced button. 3. To add a new website name, click Add, or click Edit to modify an existing name. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 38 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation NOTES The name entered in the Host Header value field must be registered in the DNS or in the Hosts file on a local machine accessing the server. Website names will need to be added to the local DNS in order for clients to be able to connect. Websites hosted by Imagine Communications will need to have a DNS entry created for new websites. Please contact Novar support to request web hosting. Configuring Event Log Access Sync-error reporting is placed in the MediaExec section of the Event Log. This section must exist prior to using MediAExec. To configure installers will need to use the Impersonate Administrator function to create the MediAExec Event Log section. NOTE This is a one-time setup that will only be necessary for new MediAExec Web Service installations. Existing installations will not need to set this up. 1. Create a new computer user from Control Panel Users (uid: MedExUsr pw: MediaExec123) 2. Add the new user to the Admin User Group. 3. Using Windows Explorer, open file: C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322\CONFIG\ machine.config in notepad. 4. Find/search for "impersonate" to find the section of the file shown in the example below. 5. Change these values in the last line of the identity attributes section of the file: a. Verify Impersonate = true b. Username = newly created Username (MedExUsr) c. Password = newly given password (MediaExec123) <!-identity Attributes: impersonate="[true|false]" - Impersonate Windows User © 2015 Imagine Communications Corp. Proprietary and Confidential Page 39 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation userName="Windows user account to impersonate" | empty string implies impersonate the LOGON user specified by IIS password="password of above specified account" | empty string --> <!--<identity impersonate="false" userName="" password=""/>--> <identity impersonate="true" userName="MedExUsr" password="MediaExec123"/> 6. Delete the currently cached process aspnet_wp.exe from Task Manager Processes. The latest will automatically start up on first request. Install HTMLDOC for PDF Capability 1. From the main Internet Information Services (IIS) screen, right-click Remote Office website, select Properties. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 40 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 2. Select Home Directory tab, click Configuration button. 3. To add .asp extension type, click Add, or click Edit to modify an existing name. . © 2015 Imagine Communications Corp. Proprietary and Confidential Page 41 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 4. Copy the executable path, and Click Cancel button. 5. On the Add/Edit Application Extension Mapping tab, paste the executable path (refer previous step) under Executable and enter ‘.pdx’ under Extension. Click OK. 6. Make sure that there is a C:\tmp folder on the server. All the users must have 3 privileges to this folder. 7. Open make_pdf.pdx with notepad from the RemoteOffice /Common Files folder. 8. Change the paths for HTMLtxt and PDF to correspond to the location of the tmp folder: 9. Make sure the owsh.run path equals the drive and the placement of the file which has been executed. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 42 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 10. Replace with the below path: WSH.Run "C:\RemoteOffice\Make_PDF\HTMLDOCD.exe --webpage -f " & PDF & " " & HTMLtxt, 1, true NOTE Correct the path to match the path where Remote Office has been installed. 11. From Make_PDF folder, run HTMLDoc.exe and install it on the server. 12. Click Finish to complete the HTMLDOC installation. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 43 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 13. To install the HTMLDOC to a different folder, click Browse and select the appropriate Program folder. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 44 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation Installing Chart FX To install http://www.hallogram.com/chartfx/net/#lic, the client must purchase or have existing license. Run setup.exe from the ChartFX CD and follow the installation instructions. Installing Crystal Reports To install Crystal Reports Pro 8.5, follow the prompts and use the defaults. Note: If Chart FX and Crystal Reports are being installed after the rest of RSS has been installed, these processes require the ending of IIS services. New Installation of MediAExec Client Place these files in the \MEPP30WS\bin directory. CompressDataSet.dll ME_CDS.dll ME_Data_Common.dll ME_Sync_Revert.dll MEPP30WS.dll MEPP_Sync_Engine.dll Novar_Encrypt.dll Upgrading MediAExec WebService and Client 1. Stop the Remote Office website in IIS Manager. 2. Shut down the COM+ services. 3. Save the old website folder and files to a Zip file. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 45 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 4. Save a copy the RSSConfig.cfg and Make_pdf.pdx file from the Common Files folder for future reference, or use when the new files and folders are copied. 5. Copy in the Replacement files and folders. 6. Replace the files in the \MEPP30WS\bin directory with the new versions of the files from the disc. 7. Generally, Download Software Updates would be used to upgrade the client machines. a. Copy all the files (except the Data folder and its files) from the \MEPPClient\program files\Imagine Communications Software Systems\MEPP\ directory on the disc to the \MEPP30WS\Updates folder. b. The \MEPP30WS\Updates folder should always be empty or should have all the latest software files stored in it. There can be as many as 51 files. NOTES The Download Software Updates process compares the file versions in the \MEPP30WS\Updates directory with the file versions on the client machine. It assumes that all the software files in the \MEPP30WS\Updates directory are the most recent versions and need to be downloaded to the client machine if the versions are different. This is true even if the user just did a completely new install using the Setup.exe and has more recent versions of the software files than the \MEPP30WS\Updates directory. Therefore, the \MEPP30WS\Updates directory should be emptied of all files except UpdateInfo.xml if all MediAExec Client upgrades are to be done using the Setup.exe (doing uninstall and reinstall) instead of using Download Software Updates. 8. If necessary, modify the RSSConfig.cfg file to reflect the proper website name, server name or IP address. 9. If the RSSConfig.cfg and Make_pdf.pdx files were copied before, and no folder structures were changed, they can be re-inserted into the Common Files folder at this time. 10. Refresh the folders by right clicking on the Remote Office website and selecting Refresh. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 46 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 11. On the RemoteOffice(Stopped) Properties, select Home Directory tab. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 47 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 12. Open Home Directory and select RemoteOffice. Click OK. 13. Then Click Apply on the Properties screen © 2015 Imagine Communications Corp. Proprietary and Confidential Page 48 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 14. On the Inheritance Overrides window, click Select All and click OK. 15. Click OK to exit the Website Properties. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 49 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 16. Restart Component Services 17. Restart the Remote Office Website through IIS Manager.. Configuring the System MediAExec Order Review Process One of the installation scripts sets up the default Order Review Process. The Order Review Process can be changed by the client at any time. Request the client to review the Order Review Process for new installations 1. Open the Remote Office / Media Exec website. 2. From the Media Exec Main menu, click Order Review Process in the Configuration section. 3. Verify that the process is set up as desired. Change it if necessary. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 50 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation Remote Office / MediAExec User Permissions There are some user permissions that did not exist in old releases.These permissions will need to be set for the appropriate people using Novar Operator Setup. This must be done by a Novar System administrator. Verify that user permissions for RemoteOffice (RSS and RAS) and MediAExec are set as desired. These user permissions are named beginning with "Web-". Verify that the appropriate users are designated as AEs. The Web-MediaExec: Order Review permission is required to allow Sales Assistants or any other users with View Entire Group access to approve or reject orders. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 51 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation AE Groups and User Groups This section applies to MediAExec installations only. 1. Using Novar Account Executive (AE) setup, create the desired AE Groups. AE Groups are not required if all AE's will be entering and approving their own orders. This is extremely rare; AE Groups need to be created for most installations. View Entire Group is required to allow Sales Assistants or any other user’s access to approve or reject orders for other AEs. 2. Using Novar Operator setup, configure Order Review Status and Users Groups as desired for each MEPP user. This must be done by a Novar system administrator. An Order Review Status is required to allow Sales Assistants or any other user’s access to approve or reject orders for other AEs. Each user requiring access to multiple AE Accounts must be assigned permission to AE Groups through the Users Group setup. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 52 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 3. Click Add. 4. Select an AE Group for the user from the dropdown box. Click Save then Exit. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 53 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 5. Click Save on the Password Update display. 6. Update screen to save the changes and exit the user. Remote Office Configuration Settings The RSSConfig.cfg file is found in the Common Files folder in the website. To direct the RemoteOffice website to the correct Novar Database, the RSSConfig.cfg (text) file is used. Each setting is critical in proper set-up. Open RSSConfig.cfg (text) file in Notepad and revise the entries in the IF / END IF section to reflect the location specific data. In the phrase “ ucase("localhost") “, the word localhost should be replaced by the qualified website name used in the Host header information and registered in the location’s DNS entry. This localhost field must be entered for each host header entry established for the website. Replace "RemoteOffice.com" with the URL of the hosting Website name in the IF THEN line. o IF ucase(ServerName(0)) = ucase("RemoteOffice.com") THEN o If necessary, ping the Server to get the IP name. DSN information specifies the Novar SQL server name, user, password and database name. o The “Server=” should specify the applicable SQL Server Name. o The “uid=” should specify the applicable SQL Server User Account Name. o The “pwd=” should specify the applicable SQL Server User Account Password. It is encrypted. o The “database=” should specify the applicable Novar Database Name. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 54 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation If present in an existing config file, the DSN2 and DSN3 entries can be removed. They are not used. The RSS, RAS, MediaExec lines tell the system which functional areas are available. A “1” means that the application is allowed; a “0” means that the application is not allowed. Set RSS, RAS, and MediaExec = "1" for each one has been purchased. Make sure the setting is “0” for any functional areas that have not been purchased. If present, RTS = "1" should be removed. RTS is obsolete. The “SMTPServer =” should specify the hosting SMTP Server URL. If this line is missing then RemoteOffice e-mail routing will default to local Web Host. Verify that this setting is correct for the installation. SMTP server information is only used with order approval notification in MediaExec. The path for the lines HTMLtxt.txt, PDF and URLlocation should be the location of the tmp folder. Example: Installing on the Client New Installation of MediAExec 3.3 The installation must be done on every client machine that will be running the Dashboard. The installation steps have been listed below. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 55 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 1. Run Setup.exe from the \MEPPClient\ directory to install the MediAExec Client software. Setup.exe will run the MediaExec Proposal Plus.msi. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 56 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 2. The Version Update menu would be displayed at the end of the installation process, showing the .Net Framework (update) step. 3. Make sure the checkbox Install Microsoft’s is enabled and then click Start Update. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 57 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 4. Click OK to close the notification message. 5. Close the Version Update dialog box. 6. Once software installation has been successfully completed, start up MediaExec by double-clicking on the new desktop icon. 7. Using the newly created AE account (from above), complete the following three steps for the Client Configuration. a. The Step 1 tab should already be completed. Verify the configuration information and change it if necessary. b. The Step 1 and Step 2 tabs are shown below for the reference. c. The Step 3 tab is the e-mail address for the AE. A valid e-mail address is required. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 58 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 8. Install New Novar Data Files. 9. Click Next to continue the process and wait for it to finish. 10. If the user has access to multiple AEs from their dashboard, Install New Novar Data Files should be run for each of the other AEs they are impersonating. Upgrading MediAExec Client to 3.3 from 3.1 or an older version MediAExec 3.3 is the only version of Media Exec that is still supported. The structure of the local Data directory changed beginning with MediAExec 3.2. With pre-3.2 versions of MediAExec, users would frequently install multiple instances on one machine. This is no longer necessary and should never be done with MediAExec 3.2 or 3.3. Only one installation of MediAExec 3.2 or 3.3 is needed for each machine because multiple AE’s may be accessed from one installation of MediAExec. It is critical to remove all instances of MediAExec before installing MediAExec 3.3. Template files and orders created with an older version of MediAExec are not compatible with MediAExec 3.2 or 3.3. The Download Software Updates feature cannot be used for this type of upgrade; an uninstall and a reinstall of MediAExec Client must be done on each client machine that will be running the Dashboard. Upgrade Steps 1. Each user must run Sync with Novar before upgrading to avoid losing pending contracts during the upgrade. 2. Use Add or Remove Programs to uninstall MediAExec Client. 3. Delete all Imagine Communications Software Systems\MEPP\ folders, including all files and subfolders. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 59 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Installation 4. Run setup.exe from the \MEPPClient\ directory to install the MediAExec Client software. Setup.exe will call the MediaExec Proposal Plus.msi and the dotnet fix if required. a. This must be done once on each client machine that will be running the Dashboard. b. It is no longer necessary or possible to install multiple instances of MediAExec on the same client machine. A feature introduced with MediAExec 3.2 allows one user to impersonate multiple AE's. 5. Run the Install New Novar Data Files process if it does not run automatically. Select No if prompted to save templates and working or modified active orders. Upgrading to MediAExec Client 3.3 from version 3.2 or later If the Novar database structure has changed, template files and orders created with an older version of MediAExec will not be compatible with the latest version of MediAExec. The Download Software Updates feature looks for differences in file versions rather than newer file versions, so it is important to keep the latest versions of all the files in the Updates folder on the web server. Upgrade Steps 1. Each user must Sync with Novar for each AE that has pending orders before upgrading to avoid losing contract data during the upgrade. This is especially critical if the Novar database structure has changed. 2. Open MediAExec. The Download Software Updates feature would prompt to download new software now. Select Yes. 3. If the Novar database structure has changed, the Install New Novar Data Files process must be run for each AE if it does not run automatically. Select No if prompted to save templates and working or modified active orders. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 60 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Post-Installation Post-Installation Overview Installation Verification Verify access to MediAExec Web Service Open the link http://yourwebservername/MEPP30WS/MEPP30WS.asmx and verify if the website methods are displayed. Verify Access to all Web Site Applications Ensure the following Website Applications are fully accessible and operational. Log into RemoteOffice and Navigate to Media Exec: OrderReview, CheckAvails (button on OrderReview page), AE Setup (Configuration), and Order Approval Configuration. Users Accounts Create New AE Test User and Sales Manager Test User Setup users with Novar Operator Setup and Novar Account Executive setup Traffic/Contracts/ Account Executive Setup [AESetup.exe] Analysis/Utilities/ Operator Setup [Utility.exe] Choose Option 1 or Option 2. OPTION 1: AE and Sales Manager are different users Using Account Executive setup, create a new AE and add it to the appropriate AE Group. Using Operator Setup, add the newly created AE as a Novar User. Using Operator Setup, add an acting Sales Manager as a Novar User. Specify AEID = 0 unless Manager is assigned to an AE Group with View Entire Group = True. OPTION 2: AE and Sales Manager are same user with full approval authority Using Account Executive Setup, create a new AE and add it to the appropriate AE Group with View Entire Group = True. Using Operator Setup, add the newly created AE as a Novar User. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 61 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Post-Installation For each Approving Manager: Set Order Review Status to the status for which each Approving Manager is responsible. E-mail address must be completed and accurate for each Approving Manager. Each Approving Manager must have proper Access to Web-MediaExec: Verify Client Installation MediaExec Order Entry 1. Start MediaExec by double-clicking on the desktop MEPP Icon. 2. Create a new test Client (Edit Menu in Dashboard) and create two new distinct orders using the newly created test Client. 3. Save and Submit each new Order. 4. Synchronize new orders with Novar by clicking on the red-lit “Send data to Novar” Dashboard button. MediaExec Order Approval 5. Once sync has completed, open IE browser and log on to the Remote Office / Media Exec Web Site using a login name for someone that has access to approve orders for other AEs. 6. Navigate to the Order Review site and verify both orders can be viewed. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 62 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Post-Installation 7. Click “Check Avails” to ensure the installation was properly completed. 8. Click on the show/hide columns and test to ensure properly handled. 9. By close coordination with the Client site, approve the first order. 10. Verify proper e-mail routing to both AE and Order Approver (correct any problems). 11. By close coordination with the Client site, disapprove the second order. 12. Further testing of Media Exec Web Site may be necessary in the areas of AE Setup and Order Approval Configuration. MediaExec Order Synchronization 13. On client machine, request to Synchronize with Novar (under Data menu) to verify new Order status for both orders. 14. View contents of the order to ensure all Order Lines are included for both Orders. Notifying Imagine Communications of Installation This section is used for installations that clients complete an upgrade on their own. It is strongly suggested that clients contact Imagine Communications Client Support for assistance with the upgrade if they are doing anything but upgrading the MediAExec 3.2 Client software on a system where MediAExec 3.2 has already been installed. Please complete the Install Verification Form at the end of this guide and fax it per the instructions on the form. This information assists Imagine Communications Client Support in providing the best support possible. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 63 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Troubleshooting Troubleshooting This section provides information regarding errors that may be received during installation, and some questions and issues that may arise after installation is complete. A Data Flow diagram is also included for reference. Possible Issues Timeout Errors can occur on both the Sync Web Service and Web Site. Resolution Some clients have large volume of data and require timeout settings larger than IIS default Recommended Connection and Script timeout is 900 seconds. Alternative Ports are in use Resolution Using an alternative port requires special handling. Refer ODBC (Appendix E - Special Installations) section for more information. Web Site errors on page Resolution Recommend turning Friendly Messages On in browser’s settings to view more specific error details. Error 500 on initial setup Microsoft VBScript compilation arror '800a03f2' Expected identifier /common Files/RSSConfig.cfg, line 2 Resolution Removed extra comma in the RSSConfig file between RSS and RAS dim DSN, ServerName, RunLogFile, CompanyURL, FinishLog, RSS, , RAS --------------------------------------------------------------^ Microsoft VBScript runtime error '800a005e' Invalid use of Null /Common files/Z-lib.asp, line 1465 © 2015 Imagine Communications Corp. Proprietary and Confidential Page 64 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Troubleshooting Resolution Line 1465 is regarding passwords. Verify that the following scripts and nsp’s have been run: RSS_Update_Area_Tables, RAS_Update_Area_Tables, and RAS_ALL queries. Partial page displayed in RSS/AIMS/Examine Breaks Only partial page appears, with no filter section. Resolution When there is an error or partial page then try to “view source” and the error will occur on the last line. Register ROCal.dll on the host server. If the correct .DLL is already registered then right click Remote Office in the component services and retype the User and Password If that still doesn’t fix it then delete ROCal.dll in component services and manually register the .dll by running this “regsvr32 path\rocal.dll” in Start/Run. ADODB.Recordset error '800a0bb9' when browsing to the website from IIS ADODB.Recordset error '800a0bb9' Arguments are of the wrong type, are out of acceptable range, or are in conflict with one another. /Common Files/Z-lib.asp, line 41 Resolution RSSConfig file is not set up properly. It needs to have the Host Header information added. Default configuration is: IF ucase(ServerName(0)) = ucase("localhost") THEN Need to change "localhost" to be the Host Header value specified in the IIS configuration, such as IF ucase(ServerName(0)) = ucase("remoteoffice. ImagineCommunications.com") THEN Access Error when running the Exception Report This is the full text of the error: Server object error 'ASP 0178 : 80070005' Server.CreateObject Access Error © 2015 Imagine Communications Corp. Proprietary and Confidential Page 65 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Troubleshooting /ME/Exception/exception.asp, line 68 The call to Server.CreateObject failed while checking permissions. Access is denied to this object. Resolution Uncheck Enforce Access under Security tab in Remote Office Properties menu. Change the System Account setting to Network Service on the Identity tab. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 66 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Troubleshooting Login page refreshes when attempting to login to Remote Office Resolution Make sure Index.asp is in the default start-up list in IIS for Remote Office Web Site. This is usually done with the RSS installation. The proxy setting may be incorrect. Make sure the correct virtual directories and applications are created. Missing one or creating an additional one will cause this issue. o See the Create Remote Office / Media Exec Web Site section where Virtual Directories and Virtual Applications are set up - Steps 19 through 30. o It may be necessary to do ApplicationCreate for AlternateApprover, OrderReview, CheckAvails, OrderPromoteCodes, and/or AESetup. o A virtual Common directory can used for Common Files. If so, it needs to be a Virtual Directory. o The Common Files directory always needs to be just a directory. MediAExec Client machine has unexpected software versions installed Resolution The Download Software Updates process compares the file versions in the \MEPP30WS\Updates directory with the file versions on the client machine. It assumes that all the software files in the \MEPP30WS\Updates directory are the most recent versions and need to be downloaded to the client machine if the versions are different. This is true even if the user just did a completely new install using the Setup.exe and has more recent versions of the software files than the \MEPP30WS\Updates directory. The \MEPP30WS\Updates directory should always be empty, or it should always have the latest versions of the software in it. Make sure the \MEPP30WS\Updates directory is empty, or that it has all the latest versions of the software in it. Contacting Support Please contact Imagine Communications Technical Support for assistance installing this new version of MediAExec: Phone Number: 303.476.5066 Fax Number: 303.476.5004 Email Address: broadbandsupport@imaginecommunications.com © 2015 Imagine Communications Corp. Proprietary and Confidential Page 67 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Data Flow Diagram Data Flow Diagram © 2015 Imagine Communications Corp. Proprietary and Confidential Page 68 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Additional Reference Material Additional Reference Material Novar Installation Documents Please contact Imagine Communications to request the Novar Installation Guide and other documentation. How to verify the MDAC Version 1. On the Start menu, click Run. 2. In the Open text box, type RegEdit and then click OK; this opens Registry Editor. 3. In the Navigation pane, drill-down to the following path: HKEY_LOCAL_MACHINE\Software\Microsoft\DataAccess 4. In the Details pane, open Name column for FullInstallVer and Version. 5. Both of these keys should specify version 2.80.1022.0 later in the Data column. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 69 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Additional Reference Material 6. If version is incorrect, install 2.8 from the following site: http://www.microsoft.com/en-us/download/ How to Install Internet Information Services (IIS) 1. From the Add/Remove Programs control panel, click Add/Remove window to open the list of components to be installed. 2. Select Application Server and click Details. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 70 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Additional Reference Material 3. Select the following components. a. ASP.NET b. Enable network COM+ access c. Internet Information services (IIS) 4. Open Internet Information Services and click Details 5. Ensure the following are components are selected. a. Common Files b. Front Pate 2002 Server Extensions c. Internet Information Services Manager d. SMTP Service e. World Wide Web Service 6. Click OK. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 71 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Additional Reference Material 7. Select World Wide Web Service, click Details. 8. Click OK. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 72 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Additional Reference Material 9. If prompted for Optional Networking components, select No. 10. Accept the defaults to continue the installation process. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 73 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix A – Scheduling a Job Appendix A - Scheduling a Job Microsoft SQL Server Enterprise Manager 2000 1. Expand Microsoft SQL Servers Applicable Server Group Server (Refer the screenshot below). 2. Expand Management SQL Server Agent. 3. Select the Jobs and right mouse click. Select New Job. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 74 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix A – Scheduling a Job 4. Under General Tab, complete as follows. The Name text will appear in the Enterprise Manager under Jobs after the job is created. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 75 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix A – Scheduling a Job 5. Select Steps tab, click New and complete the New Job Step form as follows. NOTES Command is either SQL or an installed Stored Procedure with any necessary parameter. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 76 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix A – Scheduling a Job 6. Select Schedules Tab, click New Schedule 7. Fill New Job Schedule Name and click Change 8. Complete the Edit Recurring Job Schedule form as follows: 9. Click OK button on each form to accept the new Scheduled Job. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 77 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix A – Scheduling a Job Microsoft SQL Server Management Studio 2005 1. From Object Explorer, connect to the SQL Server machine on which the Novar database resides. 2. Expand SQL Server Agent. 3. Select Jobs and right mouse click. Select New Job. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 78 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix A – Scheduling a Job 4. On the General page, complete as follows. The text of the Name field will display in the SQL Server Agent under Jobs after the job is created. 5. Select the Steps page. Click New and complete the New Job Step form. Select database to run. NOTE Command is either SQL or an installed Stored Procedure with any necessary parameter. Click OK. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 79 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix A – Scheduling a Job 6. Select Schedules menu. 7. Click New Schedule 8. Enter the details in New Job Schedule menu. 9. Click OK to accept the New Job Schedule. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 80 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix B – Stored Procedures and Functions Used by MediAExec Appendix B - Stored Procedures and Functions Used by MediAExec 1. These files are included on the standard Novar install CD, and should have already been installed when the standard Novar stored procedures were installed. a. If they have not been installed yet, make sure the files listed below are in the NSP directory and then run UtilRep with the /DBMaint option. 2. This is the list of files, taken from the ReadMe.txt file. a. MediAExec 3.3 uses all XML2Novar Stored Procedures and Functions nsp_Create_NCE_TempConLine.sql nsp_Create_NCE_TempContract.sql nsf_ComputeCPMS.sql nsp_NCE_GetConLines.sql nsp_NCE_GetContracts.sql nsp_NCE_GetNextID.sql nsp_NCE_PutConLine.sql nsp_NCE_PutContract.sql b. MediAExec 3.3 uses two NIN Stored Procedures nsp_IN_ASExceptions.sql nsp_IN_AdCopyStatus.sql c. MediAExec 3.3 uses all MediAExec Stored Procedures and Functions nsf_ComputeClientCreditLimit.sql nsf_FormatMoneyToString.sql nsp_AEExceptionRpt.sql nsp_CheckAvailsContract.sql nsp_CheckAvailsLineItem.sql nsp_CheckAvailsMEOrderLine.sql nsp_ConGenOrderStatusUpdate.sql nsp_crCopyExceptions.sql nsp_crSchedException.sql nsp_GetBroadcastYrWeek.sql © 2015 Imagine Communications Corp. Proprietary and Confidential Page 81 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix B – Stored Procedures and Functions Used by MediAExec nsp_GetEventSpotCount.sql nsp_LineExceptionClean.sql nsp_MediaExecClientChange.sql nsp_MediaExecOrderReviewList.sql nsp_MediaExecSAConfig.sql nsp_monendorderby.sql nsp_RateCardME.sql nsp_RateCardME_MakeView.sql nsp_sumCopyExceptions.sql nsp_WebAreaAccessSetup.sql © 2015 Imagine Communications Corp. Proprietary and Confidential Page 82 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix C – Obsolete MediAExec Items Appendix C - Obsolete MediAExec Items These scripts and stored procedures used to be part of the MediAExec installation process. They are obsolete and should never be run on any database because they are not compatible with the current Novar database structure. All database structure changes are handled by the Novar Database Upgrade Script. ME_Install_Columns.sql adds columns to existing tables. o 1 - MAKE_NCE_tables.sql creates some tables. o o This logic has been moved to the 'Validating Conline for Renumbering LineNums' section of the Novar Database Upgrade Script. o This script should never have been run unless there was a specific need to do so. 3 - ME_Install_Primary_Keys.sql All this work is done by Novar Database Upgrade Script except deleting the LogAmalChannelZoneOption record from SystemConfig. Import the 4 – MediaExec_DB_Data.XLS spreadsheet o This work is done by the Novar Database Upgrade Script. 2.8 - Line_Renumber.sql o This should not be run. Another existing conline trigger updates Last_Mod_Date. 2.7 – ME_NotNullable_Keys.sql o This work is done by the Novar Database Upgrade Script. 2.5 – ConlineTriggerUpdate.sql - adds triggers to maintain Last_Mod_Date column. o This work is done by the Novar Database Upgrade Script. 2 - ME_Install_Trigger_Scripts.sql adds Last_Mod_Date and Mod_Guid columns. o The Novar Database Upgrade Script does this work, and does it correctly. This spreadsheet and its related process are replaced by the "InitializeTable…" scripts. 5 - ME_Update_Tables.sql o It updates the Area and AreaAction Tables. It adds the OrderReviewProcess table and default review process if the table does not exist. It updates permissions for a user if non-blank parameters are used. o InitializeWebME_valuesTableAreaAndAreaAction.sql does the Area and AreaAccess tasks and also adds the 'MediaExecRateCardSyncPageSize' SystemConfig setting. It replaces ME_Update_Tables.sql except for the user password and permissions © 2015 Imagine Communications Corp. Proprietary and Confidential Page 83 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix C – Obsolete MediAExec Items updates. But ME_Update_Tables is nearly always called with blank parameters, which skips the user password and permissions updates. o The OrderReviewProcess table is created by the Novar Database Upgrade Script. o InitializeTableOrderReviewProcess.sql truncates and then inserts the default OrderReviewProcess records. o ME_Update_Tables should not be run. 6 – Update_NCE Table_Config.sql o 7 - ME_Install_LineExceptions.sql o o This was used to correct some things that were done by another script. o Since the other script is obsolete, and the new script does its job correctly, this script is no longer useful. 9 - RatecardWeeknumIndexCreation.sql o The script just identifies duplicates. It does not do any updates or deletes. o This script may not be obsolete, but it is not necessary to run it during installation. Update_AuditLog.sql This work is done by the Novar Database Upgrade Script. AddMustInstallColumnToUsersTable.sql o This work is done by the Novar Database Upgrade Script. 10 - Check_AdCopyGroup_Dupe.sql o The Novar Database Upgrade Script handles all these database structure changes, and inserts the records into these tables. 8 - ME_22Plus_Upgrade_adcopy_LastModDate.sql o Replaced by SQL statement in InitializeTableNCE_Table_Config.sql. This work is done by the Novar Database Upgrade Script. AddAlternateApprover.sql o This work is done by the Novar Database Upgrade Script. These were listed as "Additional SQL scripts that may be needed": Line_Renumber.sql o This script is also listed above - in the "required scripts" section. It should never have been run unless there was a specific need to do so. o This logic has been moved to the 'Validating Conline for Renumbering LineNums' section of the Novar Database Upgrade Script. Check_AEs_Contracts.sql © 2015 Imagine Communications Corp. Proprietary and Confidential Page 84 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide o Used to get contract count and client count by AE. Helpful to select small user for testing purposes. It does not change any data in the database. o Appendix C – Obsolete MediAExec Items Selects from contract and ae and groups by ae.aeid, lastname, firstname. This can be run if desired, but it is not part of the installation or upgrade process. ME_OrderReview_Diagnostics.sql o This script will not run on a database that is 5.12 or later. Since this script should not be run anyway, it will not be modified to run on later versions of the database. o Was helpful to see high level diagnostics prior to testing install. o A note in the script says "Script is for internal use only...please do not distribute without permission". It was used to look for data issues. Looks for OrderReviewProcess table and Status field in that table. This work is done by the Novar Database Upgrade Script. Ensures that the user is in the user table, has an email, has an OrderReviewStatus, and has access to WebME:OrderReview. It does change data in the database. Returns a list of duplicate (non-zero) AEID's that are in the Users Table. Run ME_AE_Columns_Repair.sql and then run ME_AE_Columns_Setup_Repair.sql o A note in one of the scripts says that this problem was resolved for all systems at MediAExec 2.3. o Both of these scripts change data in the database and should never be run. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 85 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix D – Obsolete Remote Office Items Appendix D - Obsolete Remote Office Items RTS is an obsolete section of Remote Office. All stored procedures and scripts related to RTS are obsolete. Most of these files have "RTS" as part of the file name. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 86 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix E – Special Installations Appendix E - Special Installations Create ODBC connection if Alternate Port is used for SQL Server Port 1433 is the default port for Sql Server. In some cases, a different port is used for the ODBC connection which is used to access the Novar database from the Remote Office website. If a port other than 1433 will be used for the Sql Server, a new ODBC connection must be created. 1. Open Settings Control Panel Administrative Tools. 2. Open Data Sources (ODBC). Go to the System DSN tab. 3. Click Add. 4. Follow the prompts to create a SQL Server ODBC connection with the desired port number. 5. Click OK to save. 6. It is probably necessary to change the DSN line in the RSSConfig file so it will use the newly created DSN instead of the default DSN for SQL Server. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 87 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix E – Special Installations Use the name of the new DSN that was created with the alternate port number. DSN = "SystemDSN_Name;uid=sa; pwd=xxxxx;database=NovarDB;" SMTP Email Server must be set up if web server is client hosted If SMTP service is not installed, add it through the Add & Remove Programs control panel. 1. Select Internet Information Services (IIS) and click OK. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 88 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix E – Special Installations 2. Check SMTP Service. Click OK. Configure the SMTP service 3. On My Computer (Desktop) and right mouse click and select Computer Management. 4. Select Services and Applications and open Internet Information Services. 5. Open Default SMTP Virtual Server and select Properties. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 89 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Appendix E – Special Installations 6. Open Access tab. Open Relay restrictions. Click Relay. 7. Select ‘Only the list below’. Click Add and select Single Computer option. 8. Enter the IP Address of the Web Server Machine requesting to use SMTP Server. a. If the RSSconfig file is set with a server, this setting is not used. b. If the RSSconfig file is NOT used, the settings in this screen are used. © 2015 Imagine Communications Corp. Proprietary and Confidential Page 90 of 91 Remote Office / MediAExec 3.3 / 6.0.x Installation Guide Install Verification Form Install Verification Form To: Imagine Communications Client Support From: Fax: 303.476.5004 Title: Email: broadbandsupport@imaginecommunications.com Company: Phone: Software Installed: _____________________________________________________ Date Completed: _____________________________________________________ Comments: _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ –Thanks for notifying us of your recent installation – © 2015 Imagine Communications Corp. Proprietary and Confidential Page 91 of 91