Transcription
AssetWise PerformanceManagementAPM InstallationPrerequisites
Trademark NoticeBentley, the “B” Bentley logo, AssetWise, Ivara, and Ivara Work Smartare either registered or unregistered trademarks or service marks ofBentley Systems, Incorporated or one of its direct or indirect whollyowned subsidiaries. All other brands and product names are trademarksof their respective owners.Copyright NoticeCopyright 2017, Bentley Systems, Incorporated. All Rights Reserved.Including software, file formats, and audiovisual displays; may only beused pursuant to applicable software license agreement; contains confidential and proprietary information of Bentley Systems, Incorporatedand/or third parties which is protected by copyright and trade secret lawand may not be provided or otherwise made available without properauthorization.For reference, a copy of the End User License Agreement named“EULA.pdf” is installed in the same folder as the tersAsia HeadquartersBentley Systems,Incorporated685 Stockton DriveExton, PA 19341-0678USAPhone: (1) 610 458-5000Fax: (1) 610 458-1060http://www.bentley.comBentley SystemsInternational LimitedSecond Floor, Block 2,Park PlaceUpper Hatch StreetDublin 2IrelandPhone: 353 1 436 4600Fax: 353 1 416 1261http://www.bentley.comBentley EngineeringSoftware SystemsUnit 1402-06, Tower 1China Central Place,Beijing 100022ChinaPhone: (86) 10 5929 7000Fax: (86) 10 5929 7001http://www.bentley.comAPM Installation PrerequisitesPublished July 2017APM Release 7.7.02APM Installation Prerequisites
ContentsInstallation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5APM Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Client Minimum Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Application Server Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Database Server Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Supported Database Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Synchronization Service Provider for Mobile Computing . . . . . . . . 14APM Inspections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Handheld Device Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16External Data Provider for SAP Plant Maintenance . . . . . . . . . . 17APM Integration to SAP Plant Maintenance . . . . . . . . . . . . . . . . . . 18APM Integration to IBM Maximo . . . . . . . . . . . . . . . . . . . . . . . . 19APM Integration to Oracle eAM . . . . . . . . . . . . . . . . . . . . . . . . . . 20APM Integration to Isograph Availability Workbench . . . . . . . . . 21ODC Services Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22APM Installation Prerequisites3
Contents4APM Installation Prerequisites
Installation PrerequisitesThis document defines the recommended minimum hardware and software for APM server and client environments. Use this document as areference before installing APM to ensure proper configuration.Note: While every effort is made to ensure the accuracy of thisinformation, the specifications are a broad guide. If your system’sconfiguration does not meet the requirements specified in thisdocument, contact APM Technical Services for an evaluation orfor guidance in deployment strategies that accommodate non-compliant technologies.DefinitionsSupported ConfigurationsSupported configurations are combinations of hardware, operating systems, drivers, and other third-party software required for an APM installation to function properly. They represent what we know to work withthe confidence gained from normal quality assurance measures in multiple situations. These recommendations do not mean that other configurations will not support a functioning APM installation.Unsupported ConfigurationsUnsupported configurations are combinations of hardware, operatingsystems, drivers, and other third-party software that might degrade performance of an APM installation or cause it to function improperly. WhileBentley will endeavor to assist customers with unsupported configurations, errors or support solutions might require fixes that involve the customer moving to a supported configuration or upgrading to the latestversions of third-party software.APM Installation Prerequisites5
Installation PrerequisitesAPM DeploymentAPM deployment is very flexible. The application supports lightweightsmart clients, as well as traditional thick clients. You can set up as manyapplication servers as your environment requires. Each server can perform multiple tasks: host smart clients, provide online data collection(ODC) services, manage scheduled tasks, and provide synchronization forhandheld devices and tablets. The server can also host custom serviceproviders to implement other features. Multiple application servers canrun on a single Windows server or across multiple computers. You canuse either the APM server manager or an external service to balance theworkload across resources.Smart-clientsSmart-client deployment involves running a minimum software component set on the client connected to a physical or virtual applicationserver. Different clients might connect to the same application server orto distinct application servers for scalability, if needed. An APM servermanager is typically deployed, running under IIS, to facilitate load balancing across multiple application servers. It determines the least activeapplication servers and routes the clients accordingly. The server manager can also be used to route handheld and APM Remote synchronization requests across multiple synchronization servers.To facilitate easy deployment, the Smart Client Packager is a simple wizard that quickly packages a smart client instance into a softwareinstaller. The connection information is automatically configured basedon the server or broker instance identified in the wizard. The click-oncepackage can be deployed under the Ivara Server itself or under IIS. Once6APM Installation Prerequisites
Installation Prerequisitesdeployed, a URL is automatically generated to send to clients. It can alsobe deployed to a network share, and a UNC path will be generated tosend to clients. Smart-client updates are deployed in the same manner,except that the smart clients automatically detect a new release anddownload it; there is no need to re-send the URL. Deploying the APMsmart client places a relatively small set of components on each clientcomputer (which also requires the Microsoft .NET runtime).The advantages of smart-client deployment are: HTTP- or UNC-based deployment links Click a link to install, launch, and upgrade the smart client Easy to upgrade and rollback clients (server points to current version) Multiple versions of the APM client can run simultaneously on thesame computer. The same is true for the application server; two ormore versions can run side-by-sideTypically, smart-client deployments are used in: Live production environments Shared training environmentsAPM Installation Prerequisites7
Installation PrerequisitesRemote ComputingThe remote computing client is a stand-alone deployment in that all software components that are required to run the application are local. Theremote client software is comprised of a relatively small database, objectmodel, and user interface.The remote computing synchronization server is a Service Provider (possibly running on its own application server) that allows remote computers to synchronize with the main system.Thick-clientsA thick client is required for administrative tasks and customizing theapplication. The client computer runs the client software components,plus the application server software components, and connects to a separate database server. The application server can run either in the sameprocess space as the client (using the -l option on the IvaraClient executable) or as a separate software server instance. A thick-client with an inprocess application server is required for definability (modification/extension of the core product’s object model and user interface).You can use a thick client when:8 Setting up a pilot implementation Developing customizations Testing an implementation Demonstrating APM software Training end-users on softwareAPM Installation Prerequisites
Installation PrerequisitesClient Minimum RequirementsThe table in this section outlines the minimum recommended hardwareand software requirements for various APM client deployments.Smart ClientThick ClientRemote ClientCPUIntel Core i3Intel Core i5Intel Core i5Memory2 GB2 GB2 GBDisplay Resolution1280 x 10241280 x 10241024 x 7681Operating SystemMicrosoft Windows 7, Windows8.1, or Windows 10Microsoft Windows 7(x64), Windows 8.1(x64), or Windows10 (x64)Windows 7 (x64)SP1, Windows 8.1(x64), or Windows 10(x64)2Database SoftwareN/ASee “SupportedDatabase Software”on page 13Microsoft SQLServer 2014 SP1Express3Redistributablepackages for 2005,2008, 2010, 2012,and 2013 (x64)Microsoft VisualStudio C Other Software Microsoft .NET 3.5 and .NET 4.5 plusthe latest patches are needed for clientcomputers Microsoft Office Outlook 2010, 2013,365, or 2016 is required for sendingemails from client computers Microsoft Excel 2010, 2013, 365,5 or2016 is required for exporting checksheets, tables, RFQ supplier bids, etc. Microsoft Project 2010, 2013, 365, or2016 is required for exporting schedules(EAM module) Microsoft .NETFramework 4.5(plus the latestpatches) isrequired for client computers4 Microsoft Excel2010, 2013, 365,5or 20161. The APM Remote client display resolution has been certified for thefollowing devices: Panasonic FZ-G1 and Motion Computing MC-F5.2. The APM Remote client bar-coding and photography features havebeen certified for the following OS and hardware combinations:APM Installation Prerequisites9
Installation PrerequisitesMakerDeviceWindows 7(64 bit)Windows 8.1 (64 bit)Windows 10 (64 hPadFZ-G1 (10")mk1YesYesYesYesYesPanasonicToughPadFZ-G1 (10")mk2YesYesYesYesYesPanasonicToughPadFZ-M1 sYesMotionComputingMC-F5mNoYesYesYesYesNote: The camera feature is not supported under Windows 7.Note: We cannot guarantee the efficacy of bar-coding functionalityon devices that have not been certified with APM Remote.3. If supported database software is not present on the computer, theAPM install utility prompts the user. With confirmation, the utilitydownloads and installs Microsoft SQL Server 2014 Service Pack 1Express.4. If Microsoft .NET is not present on the computer, the APM installutility prompts the user. With confirmation, the utility downloadsand installs Microsoft .NET.5. The APM export-to-Excel feature is not supported with Excel Onlinein Office 365.10APM Installation Prerequisites
Installation PrerequisitesApplication Server RequirementsThe table in this section outlines the minimum recommended requirements for APM application server computers. It is based on the assumption that the application server will access the APM database using anetwork ODBC connection.Minimum RecommendedCPUIntel Xeon E-series processor with multiplecores. Additional CPU cores should have significant benefit due to the multi-threaded nature ofthe application server software.A minimum of one physical server core per 10active concurrent users is recommended. Forpower users, we recommend no more than fiveusers per core.MemoryA minimum of 2 GB for each server processwith an additional 150 MB per active concurrent user is recommended for each IvaraServerinstance running on the application server.Multiple instances of the application server executable or service per hardware server mayimprove scalability.Operating SystemMicrosoft Windows Server 2012 R21Microsoft Windows Server 2016Microsoft .NETFrameworkVersion 3.5 and 4.5 (plus the latest patches)Microsoft Visual Studio C Redistributable packages for 2005, 2008, 2010,2012, and 2013 (x86 and x64)1. Foundation Edition is not supported.Note: APM Server Manager has been certified with Microsoft IIS7.5 and 8.5.Note: Connection to the Internet is required on APM applicationserver computers.APM Installation Prerequisites11
Installation PrerequisitesDatabase Server RequirementsIn order for the APM application to provide acceptable performance whenaccessing information stored in the database, the database server needsto be configured appropriately. Items to be considered include: Amount of memory Number of CPUs Disk capacity and throughput Network bandwidth Backup and recovery Fault tolerance Configuration of the operating system and database options ANSI or Unicode formatNote: The database and master APM installation can reside onthe same computer. However, if the database server uses a nonWindows operating system (for example, if you are running Oracleon a Solaris machine), the master APM installation must be on aseparate computer. This is because the APM software only runsunder a Windows operating system.For help in server sizing and configuration, contact Bentley TechnicalServices. As a basic guideline, the APM database consumes approximately 1 GB of disk per 10,000 assets. Memory required is typically 10%of the database size. An example of a server processor on which an APMdatabase has been successfully deployed is an HP Proliant DL380 G6EE4450 with 2 CPUs.For optimal performance, we strongly recommend physical rather thanvirtualized disk storage, preferably a solid-state drive.12APM Installation Prerequisites
Installation PrerequisitesSupported Database SoftwareThis table shows which database management systems are supported forAPM Enterprise.DBMS1Client2Microsoft SQL Server 2012SQL Server Native Client 11.0Microsoft SQL Server 2014ODBC Driver 11 for SQL ServerMicrosoft SQL Server 2016ODBC Driver 13.1 for SQL ServerOracle 11.2.0.2Oracle ODBC 12.1.0.2, ODP .NET12.1.0.2, and Oracle ASP .NET12.1.0.2Oracle 12.1.0.23Oracle ODBC 12.1.0.2, ODP .NET12.1.0.2, and Oracle ASP .NET12.1.0.21. The Oracle Locator module must be installed in Oracle databases tosupport the spatial data types of APM 7.3 and later. The Locator feature is part of the Oracle Multimedia module included in Standardand Enterprise Editions. The required components are: Oracle JVM Oracle XML DB – Oracle 11.2.0.2 only Oracle Multimedia2. The required Oracle Client components are: SQL *Plus Oracle Net Oracle Data Provider for .NET Oracle Providers for ASP .NETNote: If the 64-bit version of APM is to be installed, be sure toinstall the 64-bit version of the Oracle Client components.3. Oracle pluggable database is supported.APM Installation Prerequisites13
Installation PrerequisitesSynchronization Service Provider for Mobile ComputingA computer acting as a synchronization server for APM Mobile.NET,APM Remote, or both has the following requirements:Minimum RecommendedCPU2 GHz processor, minimum. Multiple CPUsor multiple cores are recommended. If youexpect to require numerous concurrentuploads and downloads, more cores willhelp significantly.MemoryMinimum 4 GB. Memory requirementsdepend on the total of handheld computers,tablets, or both that will be synchronized atsimultaneously. 100MB RAM is requiredper concurrent upload or download.Operating SystemWindows Server 2012 R2Windows Server 2016Microsoft .NET FrameworkMicrosoft .NET Framework version 3.5 and4.5 (plus the latest patches)The handheld synchronization server’s capacity is highly dependent onthe memory (and processing power) of the server it is running on, as wellas the nature of the data being synchronized. Bentley has successfullytested the following using representative customer data:40 concurrent synchronizations on a 4 core, 3 GB server.120 concurrent synchronizations on an 8 core, 8 GB server.14APM Installation Prerequisites
Installation PrerequisitesAPM InspectionsAPM Inspections is a mobile application for collecting maintenance datain plant settings. Checksheets for indicator readings are downloaded topersonal mobile devices like smart phones or tablets. The device is usedto collect data about the assets on an inspection route. Inspection typically involves entering readings from gauges or picking asset conditionsfrom a list. When checksheet are completed, users upload them to theAPM database for processing.APM Inspections is currently supported on any device that runsAndroid 4.0.3 or newer. It can take photographs and scan barcodes onany Android device with a camera, but it takes advantage of the barcodescanner on Panasonic devices for faster and more accurate barcode scanning. APM Inspections for Android will be available soon at GooglePlay .APM Installation Prerequisites15
Installation PrerequisitesHandheld Device RequirementsHandheld computers can be used to collect maintenance or inventorydata to be uploaded into APM. The APM Mobile.NET application isinstalled on each handheld device. The application is used to record indicator readings, which can also include attached images, or inventorycounts.Hardware and software requirements for handheld computers: Windows Mobile 6.5 Minimum memory requirement for the handheld device is 64 MBwith minimum free program memory of 24 MBNote: A handheld device with 64 MB of memory will handle a limited number of checksheets and indicators or count sheets anditems. If you assign activities with many lines to a device, it willneed more memory. Microsoft .NET Compact Framework 3.5. This software is provided inthe APM Mobile.NET installation package. Microsoft ActiveSync is required for installing APM Mobile.NET onthe handheld computer. After installation, the handheld computercan use ActiveSync to exchange data with the APM database whiledocked to a work station. Alternatively, the handheld computer canconnect to your Windows network either wirelessly or using an Ethernet port. When a handheld computer is connected to the network wirelessly,additional configuration might be needed to access the web service.This is true when a wireless security protocol such as PEAP (Protected Extensible Authentication Protocol) or LEAP (LightweightExtensible Authentication Protocol) is in use. Be sure to verify thatthe handheld supports your desired wireless security protocol. Forexample, PEAP can be supported by installing additional software onthe handheld computer, such as the Juniper Networks OdysseyAccess Client for Windows Mobile handhelds.APM Mobile.NET works with the APM application server that performsthe upload and download processes for APM Mobile.NET, APM Remote,or both. For more information, see “Synchronization Service Provider forMobile Computing” on page 14.Note: If you are upgrading from a previous APM version, youmust also upgrade the APM Mobile.NET program on each handheld computer. Review the instructions in “Upgrading HandheldDevice Software” in the APM Upgrade Guide.16APM Installation Prerequisites
Installation PrerequisitesExternal Data Provider for SAP Plant MaintenanceAPM provides plugin technology that allows APM users to view, reference, retrieve, and create data in other systems. The SAP external dataprovider plugin is designed to work with SAP Plant Maintenance.Before installing or upgrading APM, make sure that SAP ECC and SAPGateway Foundation are installed and configured correctly.The external data provider plugin has been verified to work with: SAP ECC 6.0, Service Pack 4, Enhancement Pack 7 SAP Gateway Foundation 7.40 (SAP GWFND), Service Pack 13Bentley will make reasonable efforts to support later ECC and GatewayFoundation service packs.For information about setting up this functionality, seeAPM Interoperability Guide for SAP Plant Maintenance.APM Installation Prerequisites17
Installation PrerequisitesAPM Integration to SAP Plant MaintenanceUsing the Computerized Maintenance Management System (CMMS)Integration functionality in APM, you can exchange information aboutassets, work requests, work order tasks, standard tasks, and standardjobs with SAP Plant Maintenance.Note: The CMMS integration functionality does not work withsites where the EAM module is enabled.Before installing or upgrading APM, make sure that SAP ECC and SAPNetWeaver Process Integration (PI) are installed and configured correctly. The integration solution is designed to work with the Plant Maintenance module.The integration plugin has been verified to work with the following.SAP ECC (Back-end Server) SAP ECC 6.0, Service Pack 4, Enhancement Pack 7SAP PI (Middleware) SAP NetWeaver PI 7.1.1 Dual Stack SAP NetWeaver PI 7.3.1 Single Stack (Java ) SAP NetWeaver PI 7.4 Single Stack (Java ) with 7.3.1 adaptersBentley will make reasonable efforts to support later ECC andNetWeaver service packs.For information about setting up and using the integration functionality,see APM Integration Guide for SAP Plant Maintenance.18APM Installation Prerequisites
Installation PrerequisitesAPM Integration to IBM Maximo Using the CMMS integration functionality in APM, you can exchangeinformation about assets, work orders, standard tasks, and standard jobswith IBM Maximo Asset Management software.Note: The CMMS integration functionality does not work withsites where the EAM module is enabled.Before installing or upgrading APM, make sure that IBM Maximo Enterprise Suite 6.x, 7.1.x, 7.5, or 7.6 is installed and configured correctly.The plugin has been verified to work with Maximo Enterprise Suite 6.0,7.1 (with Maximo Basic Services Release 7.1.1.4 Hot Fix Build:017), 7.5.and 7.6. Bentley will make reasonable efforts to support later EnterpriseSuite service packs.For information about setting up and using the integration functionality,see APM Integration Guide for IBM Maximo.APM Installation Prerequisites19
Installation PrerequisitesAPM Integration to Oracle eAMUsing the Computerized Maintenance Management System (CMMS)Integration functionality in APM, you can exchange information aboutassets, work requests, work orders, standard tasks, and standard jobswith Oracle eAM software.Note: The CMMS integration functionality does not work withsites where the EAM module is enabled.Before installing or upgrading APM, make sure that Oracle E-BusinessSuite is installed and configured correctly. The integration solution isdesigned to work with the Enterprise Asset Management (eAM) application.The APM application server computer requires: Oracle 11.2.0.2 or Oracle 12.1.0.2 Client components: SQL *Plus Oracle Net Oracle Data Provider for .NET Oracle Providers for ASP .NETThe Oracle client components must reside on the computer where theOracle integration adapter is installed, typically, where the APM integration server is installed.These components can be downloaded from the Oracle web site.The plugin has been verified to work with Oracle E-Business Suite 12.0.6and 11.5.10. Bentley will make reasonable efforts to support later OracleE-Business Suite service packs.20APM Installation Prerequisites
Installation PrerequisitesAPM Integration to Isograph Availability Workbench Using the integration functionality in APM, you can export failure modesfrom MTA2 and RCM2 analyses to the Isograph Availability Workbench(AWB), where you can analyze and optimize the data. You can thenimport optimization results into the APM analysis, review the recommendations in the Optimization view, and make appropriate changes tothe action plans.Before installing or upgrading APM, make sure that the followingrequirements are met: Isograph Availability Workbench v2.1 must be installed and configured correctly.For information about installing Availability Workbench, see Availability Workbench Installation and Licensing Guide from Isograph. Valid Isograph Availability Workbench license, which includes theAWB DLL ISOGRAPH licensed module.The plugin has been verified to work with Availability Workbench2.1.19.0. Bentley will make reasonable efforts to support later Availability Workbench service packs.For information about setting up and using the integration functionality,see APM Integration Guide for Isograph Availability Workbench.APM Installation Prerequisites21
Installation PrerequisitesODC Services RequirementsOnline Data Collection (ODC) provides an interface between APM indicator readings and online condition-monitoring devices, for example, Distributed Control Systems (DCSs) or programmable logic controllers(PLCs). Following are the requirements for ODC services.OPC DA1OPC HDADescriptionRequirementsOPC Real TimeData Access OPC Core Components 3.00(105.1) (x64) Redistributable Microsoft Visual C 2008(x64) Redistributable OPC Core Components 3.00(105.1) (x86) Redistributable OPC DA 2.XX and OPC DA3.0 Servers OPC Core Components 3.00(105.1) (x64) Redistributable Microsoft Visual C 2008(x64) Redistributable OPC Core Components 3.00(105.1) (x86) Redistributable OPC HDA 1.2 ServersOPC HistoricalData AccessOSI PI2OSI PI connectivityOSIsoft PI Asset Framework (AF)Client SDK 2015 R2 installedand configured on the client andserverData AccessODBC connectivityODBC installed and configured1. For OPC DA and OPC HDA, both x86 and x64 OPC SDK mustbe installed on the computer running APM smart client.2. APM ODC has been verified to work with OSIsoft PI AF Client2015 R2 version 2.7.5.7166 for both 32-bit and 64-bit versionsof the SDK.22APM Installation Prerequisites
and software requirements for various APM client deployments. 1. The APM Remote client display resolution has been certified for the following devices: Panasonic FZ-G1 and Motion Computing MC-F5. 2. The APM Remote client bar-coding and photography features have been certified for the following OS and hardware combinations:
