Advanced Graphics Application Installation Instructions

Transcription

1 Advanced Graphics Application Installation Instructions MS-ADVGRF-0 Building Technologies & Solutions LIT Release 10.0

2 Contents Document Introduction...3 Summary of Changes...3 Advanced Graphics Application Overview... 3 Microsoft Visio Professional or Standard Software...3 Scalable Vector Graphics (SVG)... 3 System Requirements... 4 Graphics Creation... 4 Graphics Viewing...4 Installation Sequence...4 Licensing...5 Detailed Procedures...5 Installing the Advanced Graphics Application... 5 Troubleshooting... 6 Creating a New User with Windows Login Authentication for SCT Standalone Computer... 8 Related Documentation...9 Technical Specifications...9

3 Document Introduction This document describes how to install or upgrade the Advanced Graphics Application (AGA). For information on configuring and using the Advanced Graphics Application to create system graphics for the Metasys system, refer to the Advanced Graphics Application Help (LIT ). Summary of Changes The following information is new or revised: Removed Windows 7 Professional, Enterprise, and Ultimate Editions with SP1 (32-bit). This operating system is no longer supported for host computers at this release. Updated Installing the Advanced Graphics Application. Advanced Graphics Application is now licensed from the Software Activation Manager (SAM). For more information, refer to Software Activation Manager Help (LIT ). Advanced Graphics Application Overview The Advanced Graphics Application is an enhanced graphics creation package that provides dynamic graphic capabilities such as animation, color changing, and flashing for the Metasys system. The package includes a dynamic example stencil library and serves as an add-on to Microsoft Visio 2003, 2007, or 2010 Professional or Standard edition software (32-bit version only). With a more comprehensive representation of facility support systems, building operators can easily monitor the health of the system on a more intuitive interface. Important: After you create advanced graphics using the Advanced Graphics Application, you view them from within the Site Management Portal (SMP) UI. Microsoft Visio Professional or Standard Software Important: When using the Windows 8.1 Pro or Enterprise (64-bit) operating system (OS) or the Windows 7 Professional, Enterprise, or Ultimate Edition (64-bit) OS, run Microsoft Visio software as an administrator so that the Advanced Graphics Application add-on is visible in the Visio add-on menu. The Advanced Graphics Application, which is designed to work with Microsoft Visio 2003, 2007, or 2010 Professional or Standard edition software (32-bit only), includes a stencil sheet mechanism that allows you to create stencil libraries. The Advanced Graphics Application includes the Graphics Example stencil, a library of dynamic HVAC components. Important: The Advanced Graphics Application is not supported on either Microsoft Visio 2013 or Visio for Office 365. Scalable Vector Graphics (SVG) The SVG file format is an XML-based web standard and is viewable and editable in any text editor, much like HTML documents. The World Wide Web Consortium ( maintains the SVG specification. The Advanced Graphics Application complies with the SVG specification for dynamic SVG graphics. 3

4 Important: When saving scalable vector graphics for Metasys systems, use the Save Advanced Graphics option rather than the Save As option. System Requirements To create advanced graphics, you need the Advanced Graphics Application software and other prerequisites, depending on your configuration. See Graphics Creation. To view advanced graphics, you need access to the System Configuration Tool (SCT UI) or Application and Data Server/Extended Application and Data Server (ADS/ADX) computer. See Graphics Viewing. Graphics Creation Graphics creation requires that you first meet the system requirements defined in Table 3. These software prerequisites and associated system requirements are necessary when you install the Advanced Graphics Application on any computer regardless of whether or not it has SCT or ADS/ ADX software already installed on it. See the Installation Sequence section for information on the installation order of the required software. Graphics Viewing Advanced graphics viewing takes place in the SMP UI, which means you can view AGA graphics on any client computer that has access to the SMP UI. See Graphics Creation for the system requirements necessary to create graphics. Installation Sequence On a stand-alone computer, install the prerequisite software and the Advanced Graphics Application in the following order: 1. A supported Microsoft Windows operating system. See the Technical Specifications section for a list of supported Windows operating systems. 2. Microsoft.NET Framework Version Service Pack (SP) 1 (.NET can only be installed by enabling the Windows feature). 3. Microsoft Visio 2003, 2007, or 2010 Professional or Standard edition software (32-bit version only; order separately). 4. Advanced Graphics Application (included on the Advanced Graphics Application product disk and the ADS/ADX product disk). AGA is also available for download from the License Portal. Refer to Software Activation Manager Help (LIT ) for details. Note: AGA installer also installs the Software Activation Manager if a newer version is not already installed on the machine. On computers with SCT or ADS/ADX software, the operating system and Microsoft.NET Framework are already installed according to the installation sequence defined for the ADS/ADX or SCT. Install the remaining prerequisite software and the Advanced Graphics Application in the following order: 1. Microsoft Visio 2003, 2007, or 2010 Professional or Standard edition software (32-bit version only; order separately). 2. Advanced Graphics Application (included on the Advanced Graphics Application product disk 4

5 and the ADS/ADX product disk). AGA is also available for download from the License Portal. Refer to Software Activation Manager Help (LIT ) for details. Licensing Activate the Advanced Graphics Application license using the instructions in the Software Activation Manager Help (LIT ). You must activate the Advanced Graphics Application license online with your product key or offline with your license activation file. Refer to the Software Activation Manager Help (LIT ) for further details. Note: Advanced Graphics Application is licensed seperately from any other JCI software on the machine. Detailed Procedures Installing the Advanced Graphics Application Note: If you try to upgrade the Advanced Graphics Application on a computer with older ADS or ADX software installed, you are required to upgrade the ADS/ADX software to the same release level as the AGA software. If you upgrade the Advanced Graphics Application on a computer that does not have ADS/ADX software, you can perform the update, but may need to relicense the Advanced Graphics Application software after the upgrade is complete. Note: With the release of Metasys Software Release 10.0, Advanced Graphics Application has to be relicensed at each major release, separate from any licensing of the Metasys Server or other JCI software. The installation software installs the Advanced Graphics Application and a library of sample symbols (Graphics Example stencil). To install the Advanced Graphics Application: 1. Verify that the computer meets the requirements described in the Technical Specifications section, and make sure all prerequisite software is installed according to the Installation Sequence section. Note: If Microsoft Visio 2003, 2007, or 2010 Professional or Standard edition (32- bit version only) software is not installed on the computer, install it according to the Installation Sequence section before proceeding. 2. Obtain the product installation file. Navigate to and double-click Setup.exe. 3. Double-click MetasysAdvancedGraphicsApplication.exe. 4. Click Yes to Do you want to allow the following program to make changes to this computer? in the User Account Control window. 5. In the Metasys Advanced Graphics Application Setup window, choose between the following: - Click Install to proceed with the default installation path location (C:\Program Files \Johnson Controls). - Click Custom and browse to your preferred installation path location. 6. Click Finish, once the automated installation process is complete in the Metasys Advanced Graphics Application Setup window. 5

6 Important: If you complete a new installation or upgrade to a major release, you must license the Advanced Graphics Application software. See the Licensing section for details. The Advanced Graphics Application installation is complete. You can now create a new symbol or create and edit a graphic. Refer to the Advanced Graphics Application Help (LIT ) for procedures. Troubleshooting Table 1 lists the problems you may encounter when installing the Advanced Graphics Application and possible solutions. Table 1: Installation Troubleshooting Message AGA Instance is running. Please close them to proceed! Do you want to completely remove the selected Application and all of its features? Solution Appears when you attempt to install or uninstall the Advanced Graphics Application while it is running or while the Metasys Database Manager is running. Click OK and close the Advanced Graphics Application or exit the Metasys Database Manager. Then, restart the installation or removal process. Appears when you uninstall the Advanced Graphics Application. Click Yes to remove the application. 6

7 Table 1: Installation Troubleshooting Message Error while creating Save Advanced Graphics Menu. Solution Appears when the required version of the office file (a.dll file) is missing on your computer and the AGASetupMenu add-on cannot access the version required to create the Save Advanced Graphics menu option. This error occurs when the Visio 2003, 2007, or 2010 software is installed before the.net Framework. Click OK. One solution is to uninstall the Advanced Graphics Application, the Visio software, and the.net Framework, and then install them in the order specified in the Installation Sequence section. Note: A valid software installation key is required to reinstall Visio 2003, 2007, or 2010 software. A second solution requires that you install the required version of the office.dll file. To install this file: For Visio 2003: 1. Shut down the Visio 2003 application on your computer. 2. Insert a Visio 2003 CD in your computer and browse to the PA cab directory on the CD. 3. In the PA cab directory, copy (or drag) the office.dll file and paste (or drop) the file in the C:\windows\assembly directory. 4. Start the Visio 2003 application. For Visio 2007: 1. Shut down the Visio 2007 application on your computer. 2. Insert a Visio 2007 CD in your computer and browse to the VisPro.WW directory on the CD. 3. In the VisPro.WW directory, open the contents of the VisProWW.cab file and locate the office.dll file. Copy (or drag) the office.dll file and paste (or drop) the file in the C:\windows \assembly directory. 4. Start the Visio 2007 application. For Visio 2010: 1. Shut down the Visio 2010 application on your computer. 2. Insert a Visio 2010 CD in your computer and browse to the Visior.WW directory on the CD. 3. In the Visior.WW directory, open the contents of the VisiorWW.cab file and locate the office.dll file. Copy (or drag) the office.dll file and paste (or drop) the file in the C:\windows \assembly directory. 4. Start the Visio 2010 application. The required file is installed and AGA should operate as intended. 7

8 Table 1: Installation Troubleshooting Message The Advanced Graphics Application is not licensed. Please contact JCI Support group for further details. Visio Instance(s) are running and will be closed by the Metasys AGA setup. Please save your changes, if any. Please refer to C:\Users \[Username]\AppData\ Roaming \AGAInstallLog.htm for more information. Solution You must activate the Advanced Graphics Application license online with your product key or offline with your license activation file. Refer to the Software Activation Manager Help (LIT ) for further details. For help, contact your local Johnson Controls representative. Appears when you attempt to install or uninstall the Advanced Graphics Application while Visio software is running. Go to Visio and save your file, then click OK to allow the installer to close the Visio software and continue with Metasys AGA installation or uninstallation. If you do not save your file, Visio prompts you to save changes before continuing. Creating a New User with Windows Login Authentication for SCT Standalone Computer When the Release 8.1 version of AGA is installed on an SCT computer with SCT version 11.1 or later, AGA cannot access the SCT archive database when you select Actions > Show Attributes in the AGA Binder. This issue is due to the default Metasys user name having a dynamic and encrypted password at SCT version 11.1 or later. To work around this issue, add a new user with Windows login authentication to the SCT archive database. 1. On the SCT computer, open SQL Management Studio, and connect to the SCT computer. Or, use Remote Desktop Connection and access the SCT computer to open and connect to the SCT computer. 2. In the Object Explorer, expand the Database folder and then expand the SCT archive database folder. 3. Right-click the Security folder and select New > User. 4. In the Database User - New window, select Windows user from the User type drop-down menu. The Select User or Group dialog box appears. 5. Type in the username in the Enter the objects name to select field. Click Check Names. 6. Click OK. 7. Enter the same username in the Login name field. 8. For the Default schema field, click the browse button. The Select Schema dialog box appears. 9. Click the Browse button next to the Enter the object names to select field. The Browse for Objects dialog box appears. 10. Select the db_owner option and click OK. 11. Click OK in the Database User - New window. 8

9 Note: For AGA to work, you need to manually add your credentials to the SCT Archive Database with the same rights as the MSEA_SCT_AppPool user. Related Documentation Table 2: Related Information For Information On Metasys System Metasys System Terms and Acronyms How to Install or Upgrade an ADS/ADX How to Install or Upgrade SCT How to Configure and Use the Advanced Graphics Application How to Use the User Graphics Tool How to License the Advanced Graphics Application See Document Metasys System Configuration Guide (LIT ) Metasys System Extended Architecture Glossary Technical Bulletin (LIT ) Metasys Server Installation and Upgrade Instructions Wizard (LIT ) SCT Installation and Upgrade Instructions (LIT ) Advanced Graphics Application Help (LIT ) User Graphics Tool (UGT) section of the Metasys SMP Help (LIT ) Software Activation Manager Help (LIT ) Technical Specifications Table 3: Advanced Graphics Application System Requirements (Graphics Generation) Recommended Computer/Server Platform Note: Our computer platform and memory recommendations are not meant to imply that older or slower machines are not usable. Refer to the Network and IT Guidance for the BAS Professional Technical Bulletin (LIT ) for more information regarding computer/ server recommendations. Supported Operating Systems Stand-Alone Computer Platform Intel Core 2 Duo E6700 or better (Intel Core 2 Duo E4300 minimum) 20 GB free hard disk space available (600 MB minimum) DVD drive SCT or ADS/ADX Computer Platform 2.8 GHz Pentium 4 processor with 80 GB hard disk (2.0 GHz Pentium 4 processor with 40 GB hard disk minimum) 20 GB free space on the hard disk (C: drive) after installing all prerequisite software and before installing the ADS software DVD drive Prerequisite software includes the supported OS, database software,.net Framework, and any other software or Service Packs required for your ADS configuration. Windows 8.1 Pro and Enterprise Editions with Update 1 (64-bit) 9

10 Table 3: Advanced Graphics Application System Requirements (Graphics Generation) Note: Advanced Graphics Application does not support installation on a Windows 10 Enterprise and Pro Editions (64-bit) computer. Other Required Software Windows 7 Professional, Enterprise, and Ultimate Editions with SP1 (64-bit) Windows Server 2012 R2 with Update 1 (64-bit) Windows Server 2012 (64-bit) Microsoft Visio 2003, 2007, or 2010 Standard or Professional Edition (32-bit only; purchased separately) Table 4: Advanced Graphics Application Client Requirements (Graphics Viewing) Metasys Supported Operating Systems Windows 10 Pro and Enterprise Editions with Creators Update (version 1709 or later) (64-bit) Windows Server 2016 (64-bit) Windows 8.1 Pro and Enterprise Editions with Update 1 (64-bit) Windows 7 Professional, Enterprise, and Ultimate Editions with SP1 (64-bit) or Windows 7 Professional, Enterprise, and Ultimate Editions with SP1 (32-bit) Windows Server 2016 (64-bit) Windows Server 2012 R2 with Update 1 (64-bit) Windows Server 2012 (64-bit) 2018 Johnson Controls. All rights reserved. All specifications and other information shown were current as of document revision and are subject to change without notice