Windows Installation Guide
Transcription
Windows Installation Guide
® Windows Guide February 2016 User’s Guide Installation Information in this document is subject to change without notice and does not represent a commitment on the part of the vendor or its representatives. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, without the written permission of Pitney Bowes Software Inc., One Global View, Troy, New York 12180-8399. © 2008-2016, Pitney Bowes Software, Inc. All rights reserved. MapInfo, and Group 1 Software are trademarks of Pitney Bowes Software Inc. All other marks and trademarks are property of their respective holders. Prices for Pitney Bowes products, options and services are not established, controlled or approved by Canada Post Corporation (CPC) or the Canadian Government. When CPC data is used to determine parcel-shipping costs, the business decision on which parcel delivery company to use is not made by CPC or the Canadian Government. Postal CodeOM is an official mark of Canada Post Corporation. FSAOM and LDUOM are official marks of Canada Post Corporation. The data that has been used in conjunction with Recognized Software (Address Accuracy) is the Postal CodeOM data that Canada Post creates and compiles, along with other data, into the Postal CodeOM Address Database. However, Canada Post has now created an enhanced database known as the Point of Call (range based) Address Database, which is more precise than the Postal CodeOM Address Database and in particular eliminates addresses that either do not exist or are addresses to which there is no mail delivery. As the creator of the Postal CodeOM data, Canada Post is the original source of, and the owner of the copyright in, all such data. As the compiler of the Postal CodeOM Address Database and the Point of Call (range based) Address Database, Canada Post is the original source of, and the owner of the copyright in, each of those database compilations. Canada Post Data is subject to change and the Canada Post Data Files are updated on a monthly basis to incorporate the changes, which changes may include, but are not limited to, changes to update data that is no longer valid. Tous droits réservés. MapInfo et Group 1 Software sont des marques commerciales de Pitney Bowes Software Inc. Toutes les autres marques et marques commerciales appartiennent à leurs détenteurs respectifs. Les tarifs des produits, options et services de la gamme de Pitney Bowes ne sont ni établis, ni contrôlés ni approuvés par la Société canadienne des postes (SCP) ou le gouvernement canadien. Si la SCP est utilisée pour déterminer les coûts d'envoi des colis, la décision sur le choix de l'entreprise de livraison à utiliser n'est prise ni par la SCP ni par le gouvernement canadien. Code postalMO est une marque officielle de la Société canadienne des postes. RTAMO et UDLMO sont des marques officielles de la Société canadienne des postes. Les données utilisées en conjonction avec le logiciel reconnu (précision de l'adresse) [Recognized Software (Address Accuracy)] correspondent au données de Code postal MO que Postes Canada crée et compile, avec d'autres données, dans la base de données d'adresses de Code postalMO. En tant que créateur des données de Code postalMO, Postes Canada est la source originale de toutes ces données et en est le détenteur des droits d'auteur. En tant que compilateur de la base de données d'adresses Code postalMO, et en tant que point de remise (en fonction de la gamme) de la base de données d'adresses, Postes Canada est la source originale de toutes ces compilations de bases de données et en est le détenteur des droits d'auteur. Les données de Postes Canada peuvent faire l'objet de changements et les fichiers de données de Postes Canada sont mis à jour sur une base mensuelle pour intégrer ces changements. Ces changements peuvent inclure, mais sans s'y limiter, des changements de mise à jour de données qui ne sont plus valides. Pitney Bowes Software Documentation Team [email protected] [email protected] or http://go.pbinsight.com/online-case-management Support: +1 (800) 367.6950 Sales: +1 (800) 327.8627 www.pb.com/software/ Canada: Phone: +1 (416) 594.5200 Fax: +1 (416) 594.5201 Technical Support: +1 (518) 285.7283 Technical Support Fax: +1 (518) 285.6080 www.pitneybowes.ca/software/ This Installation Guide applies to Canadian CODE-1 Plus and MAIL360 Manager™. Additional installation guides are located at our support site. Table of Contents Chapter 1: Windows Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Contacting Pitney Bowes Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Product Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Contents of the *.ZIP or *.EXE File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Internet Installs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Media Installs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Products and Subscription Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Chapter 2: Installation Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Installation Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Before You Begin the Windows Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Installing the Product Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Installing the Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Canadian CODE-1 Plus Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Verifying Your Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Obtaining Your Permanent License Key File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Installing Product Updates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 February 2016 3 Windows® Installation Guide February 2016 4 Windows® Installation Guide Windows Installation Overview In this chapter... Contacting Pitney Bowes Support . . . . . . . . . . . . . . . . . . . . . . . . . .6 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Environment Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Product Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Contents of the *.ZIP or *.EXE File . . . . . . . . . . . . . . . . . . . . . . . . . .7 Products and Subscription Databases. . . . . . . . . . . . . . . . . . . . . . .7 1 Contacting Pitney Bowes Support Contacting Pitney Bowes Support Please see contact information on the inside front cover of this guide. You can also obtain product information and updates from the support site. System Requirements Before you install your software, ensure that your operating system is supported by Pitney Bowes Software. Review our current supported platforms at our support site. If you are upgrading an installed product, be sure to back up any files you have changed. Since your product uses system environment variables, you must be logged on as an administrator to successfully install a product. Environment Variables For new product releases, where applicable, the installation process sets the environment variables shown below. The value xxx is the three-character product code (see the Product Code table for a listing of these). Note that the default paths are overridden if you supply a different path during installation. Environment Variables from Installation Variable Description Default G1xxx Path of the product software directory c:\Program Files\Group1\xxx G1xxxDATA Path to the product’s user data directory. c:\Group 1 Data\xxx G1DB Path of the database/reference file directory c:\Program Files\Group1\DB G1CD Media drive None You may also define a G1EDIT environment variable to set the editor used when an editing icon is launched. The default is Notepad™. Set the G1EDIT variable as a user variable. February 2016 In a 64-bit OS, the default is C:\Program Files (x86)\Group1. 6 Windows® Installation Guide Chapter 1: Windows Installation Overview Product Codes Product Codes The table below lists the three-character product codes that are commonly used in the installation procedure. Throughout these instructions, product codes are referred to as xxx. Please substitute xxx with your product code when it appears in the text. Product Name Product Code Canadian CODE-1 Plus™ C6P MAIL360 Manager™ IMB Contents of the *.ZIP or *.EXE File Internet Installs We deliver software releases in a zipped or executable file named xxxnnn.ZIP or xxxnnn.EXE, where xxx is the product code (see the Product Codes table, above), and nnn is the release number. The file name may also contain additional characters, following the xxxnnn structure, that indicate post-release build numbers and other important internal information. This file contains an install image (which in turn contains setup.exe) that must be downloaded to a temporary folder you define. Software updates (also called “fixes”) may also be identified by a fix level, along with the product code and release number; for example: xxxnnnCxxxxxxx.zip or xxxnnnNTSxxxxxxx.zip (or with the *.exe extension). Media Installs We deliver a media image on the product DVD. Additional information may be provided in a README.TXT file. Installation media is only available from the Pitney Bowes eStore. Please log in to the Pitney Bowes Software eStore for media purchasing and shipping. Products and Subscription Databases In addition to software installation, Canadian CODE-1 Plus requires a subscription database. Follow the instructions in Chapter 2 (Installing the Databases) to load your subscription databases for your products. February 2016 7 Windows® Installation Guide Products and Subscription Databases February 2016 8 Windows® Installation Guide Installation Procedures In this chapter... Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Before You Begin the Windows Installation . . . . . . . . . . . . . . . . .10 Installing the Product Software. . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Installing the Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Verifying Your Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Obtaining Your Permanent License Key File . . . . . . . . . . . . . . . . .12 Installing Product Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 2 Installation Steps Installation Steps This chapter provides information on internet and media installation procedures for installing Pitney Bowes Software products on a Windows platform. Most new installations consist of these steps: 1. Installing the Product Software 2. Installing the Databases 3. Verifying Your Installation 4. Obtaining Your Permanent License Key File This chapter provides step-by-step instructions. Additionally, this chapter includes information for Installing Product Updates. Before You Begin the Windows Installation Before installing the software or subscription database files, make sure you: 1. Have administrative rights on the PC where the software and databases are being installed. 2. Know the directory and path where the software and subscription databases are to reside (unless you plan to accept the installation defaults). 3. Have your user ID and password available to access the secure area of the Pitney Bowes support site. To receive your user ID and password, call Technical Support. 4. Have your permanent License Key available (for a new installation, if required). The Access Key only allows temporary use of the software. The Access Key that appears on the Download Software screen is valid for ten days. If your Access Key expires, return to the Pitney Bowes support site to get a new Access Key (in the My Products section), or obtain your permanent license file. 5. Review the Release Notes. Installing the Product Software To install your product software, follow these steps: 1. Log in to the Technical Support website at http://www.g1.com/support. 2. Click My Products. 3. Click the link for the product to install. 4. Click View Available Downloads for your platform. 5. Click Software and download the software files for your product. February 2016 10 Windows® Installation Guide Chapter 2: Installation Procedures Installing the Databases 6. Locate the setup.exe file and double-click to start the software installation process. 7. Follow the prompts to complete the software installation process. Installing the Databases After installing the software, you are ready to install the subscription databases.To install the subscription databases, follow these steps: 1. Review the README file and/or the product documentation for detailed information on installing the appropriate databases for your product. Some products have additional optional subscription databases. 2. Log in to the Technical Support website at http://www.g1.com/support. 3. Click My Products. 4. Click the product link to access the appropriate databases to install. 5. Click View Available Downloads for your platform. 6. Click Databases and download the database files for your product. Canadian CODE-1 Plus Database The Canadian Postal Monthly Database contains Canada postal data in a Pitney Bowes Software proprietary format. Database Canadian Postal Monthly Database Required or Recommended Required Description Contains the following information: • Postal code • Standardized address elements • Municipality and province information. February 2016 11 Windows® Installation Guide Verifying Your Installation Verifying Your Installation For new product releases, we recommend you run the installation verification procedure (IVP) "sample" job before running your own production jobs. 1. Go to the Start button and choose Programs > Group 1 Software > product name > Run product name Job. or Double-click the xxxRun.vbs file in the \cmds or \bin subdirectory. 2. Enter the name of job name (see table below), and click OK. The job takes a few minutes to run. Job Names Product Job Name Canadian CODE-1 Plus SAMPLE MAIL360 Manager IVPL 3. When the job is complete, you will receive notification via a dialog box. Click Yes to review the output for errors. 4. To ensure that output files were produced, you can check the execution log (JobName.xlg) in the data directory where you loaded the software (for example, in C:\Program Files\Group1\xxx, where xxx is your product code). Depending on the product installed, the XLG file or RPT file lists the number of records read and written during the verification process. 5. If the job did not run to completion, contact Technical Support for assistance. Obtaining Your Permanent License Key File If the IVP was successful, your final step is to acquire your permanent license key file from the product download page of the Pitney Bowes support site. February 2016 12 Windows® Installation Guide Chapter 2: Installation Procedures Installing Product Updates Installing Product Updates To install a product update, follow these steps: 1. Have your Access Key available (if required). The Access Key allows temporary use of the software. The Access Key that appears on the Download Software screen is good for ten days. If your Access Key expires, return to the Pitney Bowes support site to get a new Access Key (in the My Products section), or obtain your permanent license file. 2. Download the appropriate files from the Pitney Bowes support site. 3. Back up your lib subdirectory and the lib64, if one exists. 4. Extract the objects contained in the .ZIP file to a temporary directory on the same computer as your product installation. If the update contains an install.bat file, simply execute this file to install the update. If install.bat is not included in the update, copy the objects extracted from the .ZIP file to the lib subdirectory of your existing product installation. When prompted to overwrite existing files, reply Yes to all. 5. Check to see if the files updated successfully. February 2016 13 Windows® Installation Guide