3.0 Installation Considerations
3.1 Package Name and Location
4.0 Installing the iGateway
4.1 Installing the iGateway Locally
4.2 Installing the iGateway through BrightStor Remote Deployment or Unicenter Software Delivery
4.3 Installing the iGateway Silently
5.0 Upgrading the iGateway
5.1 Upgrading the iGateway Locally
5.2 Upgrading the iGateway Using BrightStor Remote Deployment or Unicenter Software Delivery
6.0 General Considerations
6.1 Using the iGateway
7.0 Uninstalling the iGateway
7.1 Removing the iGateway Locally
7.2 Removing the iGateway Using BrightStor Remote Deployment or Unicenter Software Delivery
Welcome to iGateway Version 4.0. This Readme file contains important information to help you with your implementation of the product, including installation considerations, operating system information, known issues, and how to contact CA Technical Support.
iGateway Version 4.0 is supported on the following operating systems:
The following sections relate to the installation of the iGateway.
You can locate the iGateway installation executable, named iGateway_40_win32.exe, in the IntelNT\iGateway directory on the iSponsor CD.
Note: The iGateway is a common product used by several CA applications. As a result, the location of the iGateway directory can vary from one application to the next.
The following sections provide information about the different ways of installing the iGateway.
To install the iGateway locally, perform the following procedure:
To install the iGateway using BrightStor® Remote Deployment or Unicenter® Software Delivery, you must first register the iGateway into the BrightStor Remote Deployment or Unicenter Software Delivery library using one of the following methods:
After registering the iGateway, using the Unicenter Software Delivery Explorer, add the computers on which you want to deploy the iGateway and drag and drop the Installation procedure to the target machines to install the iGateway.
setup.exe /S /v"/qn"
setup.exe /S /v"/qn /L*v c:\iginstall.log"
setup.exe /S /v"/qn ADDLOCAL=iGateway,Spin CMDLINE=ProductName"
setup.exe /S /v"/qn ADDLOCAL=iGateway,Spin CMDLINE=ProductName "
Before you invoke silent installation, you must be aware of the following licensing information:
CA END USER LICENSE AGREEMENT (THE "AGREEMENT") FOR THE CA SOFTWARE PRODUCT THAT IS BEING INSTALLED AS WELL AS THE ASSOCIATED DOCUMENTATION ("THE PRODUCT") CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS REGARDING YOUR USE OF THE PRODUCT BEFORE INSTALLING AND USING THE PRODUCT. Throughout this Agreement, you will be referred to as "Licensee."
BY SELECTING THE "I agree" BUTTON BELOW, LICENSEE HEREBY INDICATES ACCEPTANCE OF THIS AGREEMENT.
BY SELECTING THE "I disagree" BUTTON BELOW, THE INSTALLATION PROCESS WILL CEASE.
1. CA provides Licensee with one copy of the Product, for use by a single user, or the quantity designated as the authorized use limitation ("Authorized Use Limitation") on any Order Form (defined below) referencing the terms of this Agreement or CD sleeve included within the Product box. CA licenses the Product to Licensee pursuant to the terms of this Agreement as well as the terms of (a) any CA Order Form or Registration Form which has been signed by Licensee and CA; or (b) a License Program Certificate which is provided by CA to Licensee, as applicable (each hereafter referred to as the "Order Form").
2. If the Product is a beta version of the program and not generally available to date, CA does not guarantee that the generally available release will be identical to the beta program or that the generally available release will not require reinstallation. Licensee agrees that if it registers for support or if otherwise required by CA, Licensee shall provide CA with specific information concerning Licensee's experiences with the operation of the Product. BETA PRODUCTS ARE PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR REPRESENTATIONS OF TITLE OR NON-INFRINGEMENT.
3. If the Product is being licensed on a trial or evaluation basis, Licensee agrees to use the Product solely for evaluation purposes, in accordance with the usage restrictions set forth in Section 1, for the thirty-day evaluation period (the "Trial Period"). At the end of the Trial Period, Licensee's right to use the Product automatically expires and Licensee agrees to return to CA all copies or partial copies of the Product or certify to CA that all copies or partial copies of the Product have been deleted from Licensee's computer libraries and/or storage devices and destroyed. If Licensee desires to continue its use of the Product beyond the Trial Period, it may contact CA to acquire a license to the Product for the applicable fee. Licensee's use of the Product during the Trial Period is on an AS IS basis without any warranty, and CA disclaims all warranties including, without limitation, the implied warranties of merchantability and fitness for a particular purpose, as well as any express warranties provided elsewhere in this Agreement.
4. Payment of the fees specified on the Order Form or as agreed between Licensee and an authorized reseller of CA, shall entitle Licensee to use the Product for the term specified on the Order Form (the "Term"), which use may include the right to receive maintenance services therefor for the period set forth on the Order Form. After the Term, continued usage and/or maintenance of the Product as provided herein shall be subject to the payment by Licensee of the fees described on the Order Form. Notwithstanding the foregoing, if the Product was licensed under this Agreement without an Order Form, Licensee shall be entitled to use the Product for an indefinite period, but the license does not include the right to receive maintenance services.
5. If maintenance is provided by CA, it shall be renewed annually (except as otherwise provided in the Order Form) and Licensee agrees to pay the annual renewal maintenance fee, unless either party gives the other at least 20 days written notice of non-renewal. All fees are net of applicable taxes. Licensee agrees to pay any tariffs, duties or taxes imposed or levied by any government or governmental agency including, without limitation, federal, state and local, sales, use, value added and personal property taxes, (other than franchise and income taxes for which CA is responsible) upon a presentation of invoices by CA. Any claimed exemption from such tariffs, duties or taxes must be supported by proper documentary evidence delivered to CA. Any invoice which is unpaid by Licensee when due shall be subject to an interest charge equal to the lower of 1.5% per month or the highest applicable legal rate.
6. Licensee may use the Product as provided herein solely to process its own data and the data of its majority-owned subsidiaries and use is restricted to the location, computer equipment, and Authorized Use Limitation specified on the Order Form or CD sleeve, as applicable. If Licensee desires to use the Product beyond such restrictions, it shall notify CA, and Licensee will be invoiced for and shall pay the applicable fees for such expanded use.
7. Title to the Product and all modifications thereto shall remain with CA. The Product is a trade secret and the proprietary property of CA or its licensors. Usage rights respecting the Product may not be exchanged for any other CA product. Licensee and its employees will keep the Product and the terms of this license strictly confidential. Licensee will not disclose, de-compile, disassemble nor otherwise reverse engineer the Product. Licensee will not copy or permit others to copy the Product without CA's prior written consent. Licensee will not remove any proprietary markings of CA or its licensors. Licensee may copy the Product as reasonably required for back-up and disaster recovery purposes, provided that production use of the Product is restricted to the Authorized Use Limitation specified on the Order Form or CD sleeve, and provided that use of the Product for disaster recovery testing shall be limited to one week in any three month period. The Product may be used only within the boundaries of the country where the Product was purchased (except as otherwise provided on the Order Form) unless CA consents otherwise in writing. If this license terminates for any reason, Licensee shall certify to CA in writing that all copies and partial copies of the Product have been deleted from all computers and storage devices and are returned to CA or destroyed and are no longer in use. All fees payable hereunder shall be payable in advance. Licensee will install each new release of the Product delivered to Licensee. Licensee shall comply with all relevant import and export regulations, including those adopted by the Office of Export Administration of the US Department of Commerce. The Product and any accompanying documentation have been developed entirely at private expense. They are delivered and licensed as "commercial item" "computer software" as defined in FAR2.101. If a Product is being acquired by or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcontractor (at any tier), then the Government's rights to the Product and accompanying documentation will be only as set forth in this Agreement; and in accordance with FAR 52.227-14 Rights in Data-General, "Restricted Rights," any equivalent agency regulation or contract clause, or such applicable successor provisions. CA is the manufacturer of the Product. This license shall be governed by and interpreted in accordance with the laws of the State of New York, without regard to its choice of law provisions. Any dispute hereunder shall be determined by a court of competent jurisdiction within the State of New York, U. S. A.
8. CA warrants that it can enter into this license and that it will indemnify, hold Licensee harmless, and defend or, at its option, settle any claim that CA is not so authorized or that Licensee's use of the Product as authorized hereby infringes any patent, copyright or other intellectual property right of any third party. CA also warrants that the Product will operate in accordance with its published specifications, provided that CA's only responsibility will be to use reasonable efforts, consistent with industry standards, to cure any defect. The foregoing warranty respecting the operation of the Product will be in effect only during any period for which Licensee shall have paid the applicable license fee and annual maintenance fee, or, with respect to Products licensed without an Order Form, during a period of ninety (90) days from Licensee's acquisition of the Product. If, within a reasonable time after receiving Licensee's written notice of breach of either of the above warranties, CA is unable to cause the Product to operate (a) without infringing a third party's intellectual property rights, or (b) in accordance with CA's written specifications, then either party may terminate this Agreement on written notice to the other party.
9. EXCEPT AS SET FORTH ABOVE, TO THE FULL EXTENT PERMITTED BY APPLICABLE LAW: (A) NO OTHER WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ARE MADE BY CA; AND (B) IN NO EVENT WILL CA BE LIABLE TO LICENSEE OR ANY OTHER PARTY FOR ANY CLAIM FOR LOSS, INCLUDING TIME, MONEY, GOODWILL, AND CONSEQUENTIAL DAMAGES, WHICH MAY ARISE FROM THE USE, OPERATION OR MODIFICATION OF THE PRODUCT. IN THE EVENT THAT THE ABOVE LIABILITY LIMITATION IS FOUND TO BE INVALID UNDER APPLICABLE LAW, THEN CA'S LIABILITY FOR SUCH CLAIM SHALL BE LIMITED TO THE AMOUNT OF THE LICENSE FEE ACTUALLY PAID FOR THE PRODUCT BY LICENSEE.
10. Licensee may assign this license only if Licensee complies with CA's then prevailing policies respecting assignment of licenses, which includes a requirement that the scope of use of the Product not be expanded beyond the business of Licensee and the business of Licensee's majority-owned subsidiaries. CA may assign this license to any third party that succeeds to CA's interests in the Product and assumes the obligations of CA hereunder; and CA may assign its right to payment hereunder or grant a security interest in this license or such payment right to any third party.
11. If Licensee breaches any term of this license or if Licensee becomes insolvent or if bankruptcy or receivership proceedings are initiated by or against Licensee, CA shall have the right to withhold its own performance hereunder and/or to terminate this license immediately and, in addition to all other rights of CA, all amounts due or to become due hereunder will immediately be due and payable to CA.
12. If Licensee fails to pay the applicable maintenance fee, then Licensee may reinstate maintenance thereafter by paying to CA a fee equal to 150% of CA's then prevailing maintenance fee for each year for which the maintenance fee has not been paid.
13. Any questions concerning this license should be referred to CA, One Computer Associates Plaza, Islandia, NY 11749, Attention: Legal Department.
LICENSEE ACKNOWLEDGES THAT THIS LICENSE HAS BEEN READ AND UNDERSTOOD AND BY SELECTING THE ["I agree"] BUTTON, LICENSEE ACCEPTS ITS TERMS AND CONDITIONS. LICENSEE ALSO AGREES THAT THIS LICENSE (INCLUDING ANY ORDER FORM REFERENCING THIS AGREEMENT AND ANY TERMS RELATING TO THIRD PARTY SOFTWARE WHICH ARE SET FORTH BELOW THIS AGREEMENT) CONSTITUTES THE COMPLETE AGREEMENT BETWEEN THE PARTIES REGARDING THIS SUBJECT MATTER AND THAT IT SUPERSEDES ANY INFORMATION LICENSEE HAS RECEIVED RELATING TO THE SUBJECT MATTER OF THIS AGREEMENT, EXCEPT THAT THIS AGREEMENT WILL BE SUPERSEDED BY ANY WRITTEN AGREEMENT, EXECUTED BY BOTH LICENSEE AND CA, GRANTING LICENSEE A LICENSE TO USE THE PRODUCT. THIS AGREEMENT MAY ONLY BE AMENDED BY A WRITTEN AGREEMENT SIGNED BY AUTHORIZED REPRESENTATIVES OF BOTH PARTIES. SELECT THE ["I agree"] BUTTON TO ACCEPT THE TERMS AND CONDITIONS OF THIS AGREEMENT AS SET FORTH ABOVE AND PROCEED WITH THE INSTALLATION PROCESS. SELECT THE ["I disagree"] BUTTON TO HALT THE INSTALLATION PROCESS.
To continue with the silent installation process, you must indicate that you agree to the terms of this agreement.
A major upgrade was first introduced with iGateway version 2.1. A problem was encountered when installing that version on top of the previous iGateway packages (starting from version 1.0). The only safe and effective way to complete the installation was through major upgrades.
The major upgrade occurs when a new product installation has a different product code than the old product installation and a higher version number. The major upgrade table must be configured with the old product upgrade codes so that they can be identified on the system during the upgrade. When the old product is detected on the system, it is uninstalled and a new version is installed. To preserve all user settings, the iGateway installation renames all of the .conf files to .conf.merge and then performs the upgrade. When the upgrade is complete and the iGateway has been restarted, the iControl merges the old configuration files (*.conf.merge) into the new configuration files (*.conf)
The major upgrade installs all of the features that were previously installed.
The following sections provide additional information about the different ways of upgrading the iGateway.
To upgrade the iGateway locally, perform the following procedure:
To upgrade the iGateway using BrightStor Remote Deployment or Unicenter Software Delivery, you must first register the iGateway into the BrightStor Remote Deployment or Unicenter Software Delivery library using one of the following methods:
After registering the iGateway, using the Unicenter Software Delivery Explorer, add the computers on which you want to deploy the new iGateway and drag and drop the Installation procedure to the target machines to upgrade the iGateway automatically.
The following sections provide general information relating to the iGateway.
To use iSponsor technology, iGateway must be installed on your system.
The iGateway is uninstalled only if there are no iSponsor configuration files present in the iGateway directory other than the following:
In addition, the following must be true:
If the any of the above rules are not true, the uninstallation does not proceed. In silent mode it aborts, and in verbose mode it displays a message listing all the components (for example, sponsors, eventPlugins, and spindles) that were found.
Note: You cannot remove the iGateway from your system when an iSponsor or Portal Event Plug-in is present on the system.
The following sections provide information about the different ways of removing the iGateway.
setup.exe /S /v"/qn REMOVE=ALL"
To remove the iGateway using BrightStor Remote Deployment or Unicenter Software Delivery, you must have registered and deployed the iGateway using BrightStor Remote Deployment or Unicenter Software Delivery. To register the iGateway into the BrightStor Remote Deployment or Unicenter Software Delivery library, see the section Installing the iGateway through BrightStor Remote Deployment or Unicenter Software Delivery.
Using the Unicenter Software Delivery Explorer, add the computers from which you want to remove the iGateway and drag and drop the uninstallation procedure to the target machines to remove the iGateway.
For this release of iGateway, please consider the following:
For online technical assistance and a complete list of locations, primary service hours, and telephone numbers, contact Customer Support at http://ca.com/support.
This product includes software developed by the Apache Software Foundation (http://www.apache.org); (c) 1999 The Apache Software Foundation. All rights reserved. THE APACHE SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE APACHE SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.