Deltek Costpoint® Manufacturing Execution 2.0 Browser Installation Guide

December 15, 2017

While Deltek has attempted to verify that the information in this document is accurate and complete, some typographical or technical errors may exist. The recipient of this document is solely responsible for all decisions relating to or use of the information provided herein. The information contained in this publication is effective as of the publication date below and is subject to change without notice. This publication contains proprietary information that is protected by copyright. All rights are reserved. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, or translated into another language, without the prior written consent of Deltek, Inc. This edition published December 2017. © Deltek, Inc. Deltek’s software is also protected by copyright law and constitutes valuable confidential and proprietary information of Deltek, Inc. and its licensors. The Deltek software, and all related documentation, is provided for use only in accordance with the terms of the license agreement. Unauthorized reproduction or distribution of the program or any portion thereof could result in severe civil or criminal penalties. All trademarks are the property of their respective owners.

Browser Installation Guide ii

Contents

About this Manual ...... 1 Scope ...... 1 Audience ...... 1 Adding Custom Notes to This Guide ...... 1 Installation Package Contents ...... 2 Pre-Installation ...... 3 Overview ...... 3 Minimum Hardware and Software Requirements ...... 3 Multiple Release Instances ...... 4 Default Installation Directory Structure...... 4 Windows Settings ...... 4 Video Tool Reliance on DirectX Media Software ...... 5 MES Browser and Support Software Installation ...... 6 Overview ...... 6 What You Will Need ...... 6 CAD Viewers ...... 6 Runtime Components for the Vector Viewer ...... 6 Application Server Connections ...... 7 Installation ...... 8 Accessing Costpoint MES Help ...... 11 Assigning CPSUPERUSER the Full User License ...... 12 Validating Costpoint Connection to Costpoint MES ...... 12 Proceed to Costpoint/MES Integration or Start Using MES 2.0 ...... 14 Costpoint MES Shortcut ...... 15 Silent Installation ...... 15 Uninstalling Costpoint MES Browser ...... 16 Performance Related INI Parameter Settings ...... 16 Appendix A: Supported Formats for Default Viewers ...... 17 Overview ...... 17 Supported File Types ...... 17 Deprecated Raster Formats ...... 18 Appendix B: Command Line Options ...... 20 Overview ...... 20 Appendix C: If You Need Assistance...... 24 Deltek Support Center ...... 24

Browser Installation Guide iii

Additional Documentation for this Release ...... 25

Browser Installation Guide iv

About this Manual

About this Manual

Scope This manual contains instructions for installing Deltek Costpoint Manufacturing Execution System (MES) Browser software on MES client machines. The MES Browser installation supports Browser applications for current MES Integrated Business Application (IBA) servers. Support for Direct Oracle connections is deprecated. All current releases of the MES suite use the IBA server (Java EE application server) and the MES Browser connects to the IBA server, rather than directly to the database. MES applications software includes one or more of the following components: . MES Browser client . The MES Vector Viewer (the default CAD viewer) . Additional Raster Image Support

Audience This manual is targeted for system administrators who will be installing the MES Browser software and database management software. It is assumed that the reader has knowledge of the Windows environment, basic TCP/IP protocol, and the capabilities of the MES software.

The MES Browser client software component is the next in succession to the Thin Client. In the following document, in sections where the distinction between the branches is not important, both branches of product are referred to as Client Software or just Client. Otherwise, the relevant branch of client software is explicitly identified.

Adding Custom Notes to This Guide If you would like to add custom notes to this guide that are specific to your company, Adobe® Reader® X provides this ability. If you do not already use Adobe Reader X, you can download it here free from Adobe.

To add a custom note using Adobe Reader X, complete the following steps: 1. On the Reader toolbar, click Comment at the far right.

2. In the Annotations pane that displays, click Sticky Note. The cursor changes to match the button. 3. Position the cursor at the location in the guide where you want the note to appear, and click. A note icon is inserted at the location and a text box pops up. 4. Enter your information in the text box. 5. Continue adding notes as needed. 6. Save the document.

Deltek recommends that you save the document to a slightly different filename so as to keep the original from being overwritten.

Browser Installation Guide 1

Installation Package Contents

When reading the document, cursor over a note icon to see the information. Double-click a note icon to edit the information. Installation Package Contents

This package includes the following: . DeltekCostpointMES20LA.zip — the following installs under BrowserInstall: . Solumina BrowserSetup_v9.0.11.4.exe . Deltek Costpoint MES 2.0 Browser Installation Guide document

Browser Installation Guide 2

Pre-Installation

Pre-Installation

Overview This manual contains instructions for installing MES Browser software on client Windows machines running the following operating systems: . Windows 7

. The prior Windows 7 Aero theme related performance degradation has been addressed as of MES Browser 9.x. However, there are still potential issues related to the use of Windows 7 Aero themes, so it is recommended that all users switch to the Windows Basic theme. . The MES Client installation program will raise an error if .NET is not already installed on the target machine. However, .NET is only required for configurations which utilize the Vector Viewer component. . If installation of .NET is not wanted, then installation can be performed manually by copying files from an existing installation, updating the PATH, and registering viewer ActiveX controls as needed. . Direct Oracle (sf32do.exe) client executable is no longer provided for Browser version 9.0.2.1 and subsequent releases.

The person performing the MES software installation must have Windows Administrator rights. Before you begin installing the components of the MES Browser environment, use the information in this chapter to make sure that your system is prepared and configured correctly.

Minimum Hardware and Software Requirements For a successful installation and operation of the Costpoint MES Client, please see the Costpoint MES Platforms and Settings document to verify that your system meets the minimum hardware and software requirements.

Citrix There are performance differences from Citrix versus “direct” that result primarily from Citrix resources and/or connections being different. In particular: Citrix server must be “close” in network terms (latency and aggregate bandwidth) to the IBA server(s). The Citrix resource allocations for each Costpoint MES Browser instance at the Citrix server should not be less than that available to the MES Browser instance running separately in its own Windows Workstation environment. Please see the Costpoint MES Platforms and Settings document section Costpoint MES Browser local cache files for more details.

The Costpoint MES Browser client software component is the next in succession to the Thin Client. In the following document, in sections where the distinction between the branches is not important, both branches of product are referred to as Client Software or just Client. Otherwise, the relevant branch of client software is explicitly identified.

Browser Installation Guide 3

Pre-Installation

Multiple Release Instances If any release of the MES Browser is already installed on the client machine, the installation program may prompt you to perform an uninstall. For more information on uninstalling, see Uninstalling MES Browser. In any MES installation, certain executable files such as CAD-related files are installed in a shared Windows system directory. These files are referred to by the same name in every MES release. In the event that you install a later MES release in the presence of an existing earlier release, you may receive a warning message saying that after installation, the earlier release may not function as before. This is because the installation will overwrite the shared files with newer versions whose contents may render them partially or completely incompatible with any earlier installed releases.

If you have an existing installation of MES and install a later release to a different directory, you may receive an error message saying that a DLL cannot be found. If this happens, remove the path entry that refers to the previous installation.

Existing Files of the Same Release If the setup program detects no files matching the release you are attempting to install, it takes you directly to the setup routine. However, if the setup program detects files matching the release you are attempting to install, it displays the Application Maintenance dialog box with the following options: . Modify — Allows you to install or uninstall specific components. Use this option to install additional functionality or to uninstall additional functionality. . Repair — Allows you to reinstall missing or corrupt files, Registry keys, and shortcuts. This option may reset Preferences to default values. . Uninstall — Uninstalls files except for Registry entries and log/Admin files.

Default Installation Directory Structure During installation, the setup program installs files to the default directories. Your specific Solumina directories will depend on the components you install, one directory for each component. In 64-bit operating systems, the Solumina folder is installed in the folder named Program Files (x86). To ensure that the Solumina directory structure remains intact during run time, the installation allows you to change only the superior path, that is, the drive and/or directory above the Solumina directory.

Windows Settings The following sections contain prescribed Windows settings, which ensure proper MES functioning.

Browser Installation Guide 4

Pre-Installation

Set the Windows Desktop Themes

To check or select the Windows 7 desktop Theme, complete the following steps: 1. Click Start » Control Panel » Display. Then, under Appearance and Personalization, click Change the theme. 2. Select any theme listed under Basic and High Contrast Themes.

Set the Display Font Size

To check or set the display font size setting, complete the following steps: 1. Click Start » Control Panel » Display. 2. Make sure the setting is set to Smaller – 100%. If it is not, select the Smaller – 100% option, and click Apply.

Video Tool Reliance on DirectX Media Software MES's video objects rely on DirectX Media software and require that it be installed on the client computer. In past versions of MES, the startup routine prevented MES from starting if it did not find DirectX Media on the client. Although the application now starts without DirectX Media, the Slide window cannot display video objects without it. You can download DirectX Media directly from Microsoft's Web site: http://www.microsoft.com/en-us/download/details.aspx?id=35 Follow the links and instructions for DirectX Media Runtime. In addition, 4.0 and later automatically installs the DirectX Media software.

Browser Installation Guide 5

MES Browser and Support Software Installation

MES Browser and Support Software Installation

Overview The MES Browser installation program installs, modifies, repairs, or uninstalls one or more of the following software components in a single master routine: . MES Browser . Video display software . The Solumina Vector Viewer (default CAD viewer) This manual shows you how to install and uninstall only. It assumes that if you need to modify or repair files, you have already performed an installation and are familiar with the basic features of the modify and repair routine.

What You Will Need You should have the following items and information on hand before you begin: . The MES Browser SoluminaBrowserSetup.exe file . The destination path and name of the installation directory . Optionally, if you want to configure the Local Ini file as you install, have the Connection Alias or URL on hand. The format of the alias depends on the type of application server you will be connecting to. The URL comes from the MES Middle-tier Application Server.

CAD Viewers Native CAD viewing is provided by the Vector Viewer which is installed automatically during Typical and Complete installations, and is enabled by default when installed as a component during a Custom installation. Depending on your configuration, when you enable the Vector Viewer you may need to install the runtime components of Visual C++ Libraries on your machine before installing MES Browser. These components may already be installed on the machine if it is running Microsoft applications. For more information, see Runtime Components for the Vector Viewer below.

Runtime Components for the Vector Viewer If you are installing the default Vector Viewer—which is installed automatically in a Typical or Complete installation, or as a component in a Custom installation—you may need to install runtime components of Visual C++ 2010 Libraries before attempting the MES Browser installation. These libraries enable you to run the viewer. If you are running Microsoft applications, chances are these runtime components are already on your computer. If they are, there will be at least one entry in the C:\Windows\System32, or C:\Windows\SysWOW64 directory with the file name of MSVCP100.dll. If you do not see one or more of this entry, or remain unsure whether the runtime components have been installed: 1. Go to the Microsoft Web site: http://www.microsoft.com 2. Search for vcredist_x86.exe and download the Visual C++ 2010 Package.

Browser Installation Guide 6

MES Browser and Support Software Installation

3. Double-click the downloaded file to install the runtime components.

Application Server Connections

Proxy Servers The use of a proxy server is when using the 3-tier solution, that is, Java Middle-tier. In the case where you are using a proxy server, add a space-delimited proxy server argument to the DbAlias: Proxy = /@: URL is the only required parameter and Proxy is not case-sensitive. Examples of proxy servers: Proxy=JohnSmith/[email protected]:9090 [email protected]:9090 Proxy=proxy1.acme.com:9090 Proxy=proxy1.acme.com Examples of DbAlias values with proxy servers: DbAlias=http://server123.acme.com:8080/solumina-G8/gateway Proxy=JohnSmith/[email protected]:9090 or, on the command line... /a "http://server123.acme.com:8080/solumina-G8/gateway Proxy=JohnSmith/[email protected]:9090"

Display Names Onscreen, the DbAlias displays next to the User Name in the Status line. If this alias is too long or not meaningful to the user, you can specify a shorter name using the DisplayName property in the System Manager's Ini File Maintenance tool or by adding the space-delimited DisplayName argument to the DbAlias: DisplayName= DisplayName is not case sensitive. Use underscores to indicate spaces in the name. These will be converted to space characters on display.

DisplayName Examples Displayed Text

DisplayName=Production Production

DisplayName=Widget_DB Widget DB

Examples of DbAlias values with DisplayNames:

DbAlias=Prod123 DisplayName=Production DbAlias=Prod123.Acme.com DisplayName=Widget_DB DbAlias=http://server123.Acme.com/Solumina DisplayName=Widget_DB Proxy=proxy1.Acme.com DbAlias=http://server123.Acme.com/Solumina Proxy=proxy1.Acme.com DisplayName=Production DbAlias=http://server123.Acme.com/Solumina DisplayName=Widget_DB

Browser Installation Guide 7

MES Browser and Support Software Installation or, on the command line...

/a “http://server123.Acme.com/Solumina DisplayName=Widget_DB Proxy=proxy1.Acme.com” /a “http://server123.Acme.com/Solumina Proxy=proxy1.Acme.com DisplayName=Production” /a “http://server123.Acme.com/Solumina DisplayName=Widget_DB”

Installation The MES Browser installation consists of the following steps: 1. When needed, installation of runtime components of Visual C++ Libraries—if the runtime components are not already installed on the Solumina Browser machine. See Runtime Components for the Vector Viewer. (Optional) 2. MES Browser installation

If you are performing a software installation that makes MES Browser accessible to all users on the installation machine (see step 3 in the following procedure). You must have Windows Administrator rights.

To install Solumina Browser software, complete the following steps: 1. From the DeltekCostpointMES20LA.zip, extract the \DeltekCostpointMES20\BrowserInstall\Solumina BrowserSetup_v9.0.11.4.exe into a desired location (i.e., C:\CPMES20\BrowserInstall). This location is referred to as [CPMES-unzip-dir] throughout this installation guide. 2. Run the [CPMES-unzip-dir]\Solumina BrowserSetup_v9.0.11.4.exe.

Due to enhanced security in Server, it is advised that you use the Run as Administrator option when launching installation files, even if you are logged in as a user with local administrative rights. To Run as Administrator, right-click the SoluminaBrowserSetup.exe file in Windows Explorer and select Run as Administrator.

The Welcome dialog box displays.

If the Application Maintenance dialog box appears, the setup program has detected files of the same release you are attempting to install. iBASEt recommends that you perform an uninstall before proceeding. For more information, see “Uninstalling Solumina Browser,” on page 16.

3. Click Next. The License Agreement dialog box displays. 4. If you agree with the software license agreement, select the I Accept the license agreement option and click Next. The User Information Setup dialog box displays. This dialog box allows you to install MES Browser for just yourself or for all users on the installation machine. If you install just for yourself, you will be the only one that can see the MES Browser icon and application on the Start menu. You must be an Administrator to install for all users. 5. Select the appropriate option, and click Next.

Browser Installation Guide 8

MES Browser and Support Software Installation

The Select Destination Directory dialog box displays. This dialog box allows you to change the drive and directory superior to the Solumina subdirectories (see Default Installation Directory Structure). 6. After accepting the default path or browsing to set a new one, click Next. The Installation Type dialog box displays.

. If you are installing the Vector Viewer in any type of installation, runtime components for Visual C++ Libraries may need to be installed on your computer. If they are not, exit the installation and see Runtime Components for the Vector Viewer. . By default, the Client installation no longer includes support for deprecated raster formats. You must use the Custom installation and select Additional Image Format Support to get support for the deprecated formats. For more information, see Appendix A: Supported Formats for Default Viewers.

Setup Type Description

Typical Includes all basic MES functionality.

Complete Includes all basic MES functionality, API, Additional image format, Office Viewer, and Vector Viewer support files.

Custom Includes all basic MES functionality. Allows you to individually install API, Additional image format, Office Viewer, and Viewer support files.

7. Select the installation type you want and click Next. . If you choose a Typical or Complete installation, go to step 8. . If you choose a Custom installation, the Select Components to Install dialog box displays (below right). Continue here. The Select Components to Install dialog box contains the following components:

Component Description

Additional Image Includes complete image formats support. Requires Format Support additional Client configuration. This component will be installed on the local hard drive.

SFOfficeViewer Integration of MS Offices. This will be installed on the local hard drive.

Include raster support Ordinarily, raster file viewing is handled by the client for Vector Viewer application. Enable this option if you intend to configure MES to delegate raster support to the Vector View plugin. This component will be installed on the local hard drive.

8. In the Select Components dialog box, for each component, click the icon next to the component name, and select the installation option you want. Click Next. The Connection Setup window displays.

Browser Installation Guide 9

MES Browser and Support Software Installation

. If the Client is connecting directly with the IBA server over HTTPS, the Client needs the public certificate that matches the private certificate on the IBA server. However, if there is a Load Balancer between the IBA server and the Client (and the Client is connecting to the Load Balancer via HTTPS), then the Client needs the public certificate that matches the private certificate on the Load Balancer, not on the IBA server. . The implementation of HTTPS support requires the securing of a security certificate. Security Certificates have both private and public keys. Configuring the server with the private certificate is server dependent and beyond the scope of this document. If you are applying the public certificate to the Client, go to the Setting up for HTTPS in the MES Browser Client section of the System Manager Install Guide for the complete setup instructions of the HTTPS connection.

Leave all values blank and configure them later (see Costpoint MES Shortcut). or Enter property values for the Shortcut Setup file as follows:

Field Description

Connection When connecting to n-tier architecture, enter URL. For example, URL or Alias http://CostpointMES20Server:8080/solumina- G8/gateway?id=CPMES_CLIENT. Where CPMES_CLIENT is the configuration that has been setup in the System Manager install.

SSL certificate This points to a certificate or to a text file (txt or .lst) that contains a file name list of certificate locations, other cert lists, and so on. If a particular certificate is not specified, a certificate list file in the same directory is read to obtain the location of any required cert(s). For example, http://mycompany.com/misc/DigiCertSHA2HighAssuranceServer CA.p7c.

. Unlike in the Target field of the Client Shortcut Properties dialog: You do not need to list the entire command line argument in one field. Instead, you use each field to enter the specific information required for that field – see the table descriptions above for examples of what each field requires. You do not need to enter quotation marks (“ “) around paths that contain spaces. These will automatically populate in the Target field of the Client Shortcut Properties dialog. . Use of a local initialization file is still supported for backward compatibility. In this case, the local Ini file must be placed in the appropriate folder location using an external process or manually copied to the desired location as needed. Also, a minor modification to the created desktop shortcuts is needed to reference the appropriate file by name. Specifically, the "/N " command line argument must be added to the Target setting of the Shortcut tab in the Windows Properties dialog.

9. Click Next.

Browser Installation Guide 10

MES Browser and Support Software Installation

The Start Installation dialog box displays. 10. Click Finish to complete the installation. Setup creates the following shortcuts, which can be modified as needed: . Solumina G8 . Uninstall Solumina G8 You access these shortcuts through the Start button: Start » Programs » Solumina G8.

Accessing Costpoint MES Help Before you can login to Costpoint MES 2.0 the Costpoint MES help file must exist.

If you configured the Overrides for help in the Configuring Browser INI File step of the DeltekCostpointMES20SystemManagerInstallationGuide.pdf you must perform this step before you will be able to access Costpoint MES 2.0.

To install the Costpoint MES help file to your Browser location, complete the following steps: 1. Locate the Costpoint MES help file that downloaded with DeltekCostpointMES20EA.zip, it will be under your DSM Costpoint MES\20\LA\Documentation folder: Costpoint MES.chm 2. Copy the Costpoint MES.chm file to your local Browser install directory: C:\Program Files (x86)\Solumina\Solumina Browser If you configure the System Manager INI file as described in the sections above and a user does NOT copy the Costpoint MES.chm file to their local Thin Client install directory they will receive the following error when they attempt to login:

Browser Installation Guide 11

MES Browser and Support Software Installation

Assigning CPSUPERUSER the Full User License With Costpoint MES 2.0 connection from Costpoint to Costpoint MES 2.0 will not work unless the Costpoint Config Utility connection user, CPSUPERUSER, has FULL USER license rights.

To assign CPSUPERUSER the proper connectivity, complete the following steps: 1. As SUPERUSER, login to Costpoint MES 2.0 using the Solumina Browser. 2. Click on the System Administration tab. 3. Select User Management and open the Users screen. 4. Select CPSUPERUSER, then select the License tab at the bottom of the screen. 5. Select the + icon to add a license to the CPSUPERUSER account. 6. From the drop-down select FULL USER. 7. Click OK.

Validating Costpoint Connection to Costpoint MES

Purpose This step provides instructions for validating that the connection from Costpoint 7.1.1 to Costpoint MES 2.0 is still working after upgrading to Costpoint MES 2.0.

Skip this section if you are doing a Costpoint MES 2.0 new install, you still need to configure Costpoint and Costpoint MES by following the

DeltekCostpointPMFGIntegrationtoSFT13andMES20.pdf.

Where You must perform this step on your Costpoint application server.

To validate the connection between Costpoint and Costpoint MES, complete the following steps: 1. Click Start » All Programs » Costpoint 7.1.1 » Start Costpoint 7.1.1 Config Utility.

Due to enhanced security in Windows Server 2012, it is advised to use the option to Run as Administrator when launching this command even when the logged in user

has local administrative rights.

2. When the Select Your Configuration Options screen displays, perform the following: . Costpoint Web Configuration — Make sure this box is selected. The default is selected. . Click Next. 3. When the Costpoint Configuration Utility screen displays, click the Costpoint tab and under the Select SYSTEM section perform the following: . Displaying System — Select your Costpoint System. For example, DELTEKCP. . Select the Project Manufacturing tab.

Browser Installation Guide 12

MES Browser and Support Software Installation

. Under the Manufacturing Execution (ME) Connection Information Setup, perform the following: . Highlight your Projection Manufacturing Instance ID, for example, PLANT1. . Click Clone. . Enter a new Projection Manufacturing Instance ID, for example, PLANT1_MES20. . Change Connection URL to point to your MES 2.0 system, for example, http://:8080/solumina-G8/ws. . Click Test. . When the Connected message displays, click OK.

If the connection does not work, check to make sure Costpoint and Costpoint MES services are running and all connection information is still valid.

4. Click Close.

Browser Installation Guide 13

MES Browser and Support Software Installation

Proceed to Costpoint/MES Integration or Start Using MES 2.0

Once all of the following have been done, you can start using Costpoint MES 2.0:

• System Manager (DeltekCostpointMES20SystemManagerInstallationGuide.pdf)

o Installed o INI File – CPMES_DEFAULT configured o INI File – CPMES_CLIENT created and configured o INI Lib - CPBA_5081 configured • Database (DeltekCostpointMES20SQLDatabaseInstallationGuide.pdf or DeltekCostpointMES20OracleDatabaseInstallationGuide.pdf)

o Fresh install or Upgrade (5000) applied o Service Pack 8 (5080) applied o Service Pack 8 Hot Fix 2 (5082) applied o CP MES Update 1008 applied • IBA (DeltekCostpointMES20IBAInstallationGuide.pdf)

o Installed o CP MES 1008 lib installed o Apache Tomcat 8.0 SOLG8 service started • Browser (DeltekCostpointMES20BrowserInstallationGuide.pdf)

o Installed o Help File installed • Configuration (DeltekCostpointPMFGIntegrationtoSFT13andMES20.pdf)

o Connectivity to Costpoint setup o Global Parameters updated o User CPSUPERUSER given Full License (or appropriate) rights o Test Connection from CP to MES and MES to CP tested Proceed to the appropriate document for any steps not yet completed.

Browser Installation Guide 14

MES Browser and Support Software Installation

Costpoint MES Shortcut The easiest place to run the MES application with additional or altered command line options is from the MES desktop shortcut that starts the application. You set command line options in the Target field of the Properties dialog box.

To change the command line through the MES desktop shortcut, complete the following steps: 1. Right-click the MES desktop shortcut, and click Properties. The icons properties dialog box displays. 2. Click the Shortcut tab. 3. In the Target field, add appropriate command line options (see Appendix B: Command Line Options).

By default, Browser version 8.0.18.1 and later releases retrieve bootstrap initialization settings via http request to the middle tier, instead of reading settings from a local INI file. As such, the client installation program no longer creates a sample Solumina.ini in contrast to prior releases. Please refer to the “Maintaining INI File” chapter of the Configuration Basics Manual for information regarding maintenance of server-based INI files using the MES System Manager. Multiple server-based INI file settings can be maintained and deployed using this method. The INI file used by the Browser application can be specified in the URL using the id parameter as follows: Syntax: http://:/?id= Example: http://srv-cust1:8888/production/gateway?id=Prod1 If the "id" argument is not provided, the id named DEFAULT is applied.

Silent Installation You can perform a silent installation of Costpoint MES Browser via the command line. Silent installation is executed in a DOS window and triggers no dialog boxes or advisories. The following command information contains the executable installation files and arguments (parameters) needed to refine an installation.

If you have the same or previous version of this product currently installed, you will need to perform an uninstall of the product first.

Costpoint MES Browser Only Installation 1. Open the Windows Command Prompt. 2. Copy the setup program to your desired directory.

You must use double quotation marks around the setup program filename or you will encounter errors.

3. Enter the command for the silent install. The parameters for a silent install command are:

[Filename] SILENT=TRUE ALLUSERS=[TRUE/FALSE] [Install Type]=TRUE DBALIAS=[URL]

Browser Installation Guide 15

MES Browser and Support Software Installation

Example:

“Solumina Browser setup.exe” SILENT=TRUE ALLUSERS=TRUE COMPLETE=TRUE DBALIAS=”http://MyConnection” Please use the table below to understand the correct parameter to use for the syntax in the command line. Table 1: Windows Command Line Parameters for Silent Installation

Parameters Description

Filename Enter the installation file name, for example, “Costpoint MES Browser setup.exe”. You must use double quotation marks around the file name or you will encounter errors.

ALLUSERS . TRUE — Installs the product for all users (anyone that uses that computer) . FALSE — Installs the product for one user (installer or local computer)

Install Type . COMPLETE — Includes all basic MES, API, Additional Image Format, MS Office viewer, and Vector Viewer support files . TYPICAL — Includes all basic MES functionality A Custom Install is not available during a Silent Installation because this involves user interaction in selecting components during the installation.

DBALIAS Enter the appropriate URL for your database connection. (Optional) Example: http://MyConnection Make sure that the URL that you provide has a valid connection.

Uninstalling Costpoint MES Browser You can uninstall Costpoint MES Browser in two ways: . Through the Windows Add/Remove Programs routine. (Start » Settings » Control Panel » Add/Remove Programs). Use this method if you know that there is a currently installed Client release. . Through the MES Browser Uninstall program. (Start button, search for ‘Solumina’, and select Uninstall Solumina Browser). Then, simply follow the prompts to uninstall the MES Browser files.

Performance Related INI Parameter Settings The default INI parameter settings are set to the recommended values. The values will be the same for both your local and remote workstations. These settings should not be changed unless otherwise instructed by the implementation team or technical support.

Browser Installation Guide 16

Appendix A: Supported Formats for Default Viewers

Appendix A: Supported Formats for Default Viewers

Overview This appendix contains supported files types and extensions for default viewers.

To display any object, Web Express Publisher uses mime types to map object extensions to browser-specific plug-ins. Mime types are passed to the browser in the object header. Mime types are defined and changed in the File Types tab of the Domain Manager program.

Supported File Types The following table contains supported file types for the default image viewer. Table 2: Associated File Extensions for the Default Native Supported Image Formats

Extensions Description

.JPG JPEG Compressed formats

.TIF TIFF formats

.BMP BMP formats

.WMF Windows Metafile Format

.PNG Portable Networks Graphics format

.GIF Graphics Interchange Format

.EMF Enhanced Metafile Format

The following table shows all of the extensions/formats supported by the Costpoint MES Vector Viewer—the default CAD viewer. Table 3: Supported File Extensions/Formats for the Costpoint MES Vector Viewer

Extensions Description

.WMZ Compressed Windows Metafile. Vector file format primarily representing Group 3 fax documents.

.CGM Computer Graphics Metafile. Includes the binary-encoding format of CGM Versions 1, 2, 3, and 4.

.CMX Corel Presentation Exchange. Versions 5, 6, 7, and 8.

.DGN Versions 1, 2, and 3.

.DRW DRaWing. Versions 1 through 5.

Browser Installation Guide 17

Appendix A: Supported Formats for Default Viewers

Extensions Description

.DXF Drawing Interchange Format. All current versions: 2.6, 9–5, and 2004.

.DWF Versions .4, .5, .55, and .6.

.DWG Versions 13, 14, 15 (DWG2000), and 18 (DWG2004).

.SHP ESRI Shape Format.

.GBR Gerber Format.

.PCT Macintosh Pict Format.

.NAP North American Presentation Layer Protocol Syntax. Version 1.

.PLT, .HPG, .HPGL LEADTOOLS supports HPGL and HPGL/2.

.PCL, .PRN, .PRT Printer Command Language. Versions 3.0 and 5.0.

.SVG Scalable Vector Graphics. Supported by Adobe SVG Viewer, CorelDRAW 10.0, Jasc WebDraw, and Apache Batik SVG browser.

.WMF, .EMF Windows Metafile.

.WPG, .VWPG WordPerfect Graphics. Version 2. This format is also supported by CorelDRAW 8.0.

The following table contains other supported file extensions. Table 4: Other Supported File Extensions

Extensions Object/Viewer Type

* .WAV, .WAVE, .RIFF Audio

*.AVI, .MPG, .MPEG, .MOV, .WMV Video

*.RTF, .RPT, .TXT, .XLS, .XLSX, .PPT, Document .DOC, DOCX

PDF Optional native viewer or use Adobe Acrobat

*.HTM, .HTML, .CFM, .ASP Web Browser

* Support depends on software not included with MES.

Deprecated Raster Formats Deprecation of Lead Tools libraries raster graphics support begins with MES Browser version 9.0.0.0. Version 9.0.0.0 installs the Lead Tools support DLLs, but the related Ini Lib setting, Slide.GraphicsProcessingLib, defaults to Native. Subsequent releases further deprecate

Browser Installation Guide 18

Appendix A: Supported Formats for Default Viewers support in the client installation program such that supporting DLLs are not installed except by explicit choosing as follows: . The Installer provides the choice to include the legacy/external graphics processing library (Lead Tools library). . The default is not to use the legacy graphics processing library, but rather to use new Native support. This is the preferred configuration for installation of the client via web page served from the middle tier. This significantly reduces the size and complexity of the client installation package. The Native option also supports additional formats installed in the operating system using Windows Imaging Component (WIC). For more information on WIC, see http://msdn.microsoft.com/en-us/library/windows/desktop/ee719902(v=vs.85).aspx. Any errors raised during native loading of image files automatically attempts to load via Windows Imaging Component. In the installer, the two options under "Graphics Processing Library" are: Native (File formats- BMP, JFIF, GIF, PNG,TIFF, WMF, EMF and any video formats provided by Windows Media Player) or Auxiliary (Legacy support of other formats – Deprecated). . Ini Lib configuration of setting Slide.GraphicsProcessingLib must be set to Native unless the client is installed using the Auxiliary option. . Customers should ensure that the Native support is sufficient to handle expected file formats. If issues arise during testing, customers can elect to use the Auxiliary installation option. . Slide.ImportDialogImageSaveFormat is ignored for imported TIFF files. TIFF files are always stored in the native TIFF file format.

Browser Installation Guide 19

Appendix B: Command Line Options

Appendix B: Command Line Options

Overview You can start the Costpoint MES software from the command line in order to change certain startup variables and to run diagnostics. Syntax

Solumina Executable File [option1 option2 option3 option_n] Table 5: Command Line Options

Option Description

/A Overrides the DBAlias variable in the startup file

/N Starts Costpoint MES with the indicated Ini file and assumes that the file is in the Solumina directory. See the /I option below for starting MES with a startup file that resides outside the Solumina directory.

/I Starts Costpoint MES with the indicated Ini file in the indicated path. If MES cannot find the file, it uses the default (SF.Ini).

/CL Used during the handshake when the Client connects to the server over an HTTPS connection. The command allows you to define where the certificate is located. The certificate can be located on a local, network, or URL location. For example:

C:\Program Files (x86)\Solumina9092\Solumina Browser\Sf32.exe /CL See the Setting up for HTTPS in the MES Browser Client section of the System Manager Install Guide for full information.

/OC Overrides the user’s stored context information with the contents of the specified file, and on exit, writes the exiting context into the database. . If a filename, but no extension is specified, the application assumes a .txt extension. . If a filename, but no path is specified, the application assumes the file is in the home directory of the MES Browser executable file. You can also save and load User Context data through the User Context tab of the Diagnostics dialog box.

/OI Overrides the Ini_Id variable in the startup (Ini) file, starting Costpoint MES with the indicated Initialization Library record.

/OD The URL of the MES middle-tier application server or Oracle alias when connection directly to an Oracle database.

/OPU Overrides the PublicUserName variable in the Bootstrap Ini file, starting MES with the indicated Public Username.

Browser Installation Guide 20

Appendix B: Command Line Options

Option Description The public user name can contain the following special characters: Colon (:), Comma (,), Slash (/), At symbol (@).

/OPP Overrides the PublicPassword variable in the Bootstrap Ini file, starting MES with the indicated Public Password. The public password can contain the following special characters: Colon (:), Comma (,), Slash (/), At symbol (@). You can encrypt this password in the Local Ini Editor and then copy the encryption to the command line. For more information about encryption, see the “The Local Ini Editor” and “Encrypting a Password” in the System Manager Manual.

/U Starts MES and logs on the indicated user. This option must be used in conjunction with the /P option below. Example: sf32 /U [xxx] /P [xxx]. User names can contain the following special characters: Colon (:), Comma (,), Slash (/), At symbol (@). When initiating external user authentication, no /p parameter is needed.

/P Starts MES using the indicated user password. This option must be used in conjunction with the /U option above. Example: sf32 /U [xxx] /P [xxx]. Passwords can contain the following special characters: Colon (:), Comma (,), Slash (/), At symbol (@). You can encrypt this password in the Local Ini Editor and then copy the encryption to the command line. For more information about encryption, see the “The Local Ini Editor” and “Encrypting a Password” in the System Manager Manual.

/M Disables barcode scanning as enabled in the Ini Lib record. The only valid value is 0 (/m 0).

/XU Disables user exits.

/XA Disables alignment of UDV contents in hypertext.

/XC Disables UDV and SQL Library local memory caching.

/XD Disables the local data cache.

/XH Forces all Display and Input UDV edit fields to visible.

/XL Disables configuration objects caching on the client.

/S Disables error dialog boxes.

/W Simulates a Web Express Publisher client connection to the database. The connection type then displays in the System Data tab of the Diagnostics dialog box. . When the connection type is Solumina Browser, @ClientType = Standard (and the passed value = FAT)

Browser Installation Guide 21

Appendix B: Command Line Options

Option Description . When the connection type is Web Express, @ClientType = Web (and the passed value = Web) Simulation of the Web Express client allows developers to discern any differences in returned values between the two client types.

/D Starts Costpoint MES and enables the indicated diagnostics in the Diagnostics dialog box. Diagnostics can be any of the following:

O Environment/OS.

S SQL. Causes the log to list executed SQL statements.

N Ini Lib. Causes the log to list executed property values in the Initialization Library record.

V Invoke. Causes the log to list data/commands that load instructions and multimedia objects.

T Text Load. Causes the log to list executed queries and other data that load hypertext.

B Text block. Causes the log to list executed queries, for example, block save, defined in each block type.

U User exits. Causes the log to list executed user exits.

E Errors. Causes the log to list additional error diagnostics.

A User interface activity.

Y Scan activity.

G Global data changes.

X UDV processing.

R RAVE Report diagnostics.

W Slide processing.

0 Instant Messsaging.

1 Test API.

J Expressions/Privs.

Z Preferences/Context.

C Connection/Licensing. Causes the log to list connection and licensing events.

Browser Installation Guide 22

Appendix B: Command Line Options

Option Description

F Performance (Local Log).

Q SQL Request Trace. Begin //, end;

I Initialization. Triggers a trace of Initialization diagnostics, which is meant to be used by iBASEt personnel to troubleshoot startup problems. This option should be used after getting the following error on attempted startup:

An application Self Check error has occurred. Please enable Initialization diagnostics (/DI) and retry, or contact Technical Support. The attempted restart triggers a trace of the initialization and Self Check up to the point of the error, and displays them in the Diagnostics dialog box. A text search for SELF CHECK pinpoints the entries that can be used to troubleshoot the problem.

D Display. Causes Costpoint MES to automatically display diagnostic messages for enabled diagnostic types as they occur.

D List multiple diagnostics sequentially without delimiters: /DIVB To display the Diagnostics dialog box, control-right-click on the Exit button or the Error/Status area of the Costpoint MES Shell.

The example below shows the command used to start Costpoint MES using a startup file called SF2.INI (/N SF2.INI), an Initialization Library record called SFMFG_32 (/OI SFMFG_32), and diagnostics that cause display of SQL statements and error messages (/DSE). The name of the executable file is SF32.

SF32 /N SF2.INI /OI SFMFG_32 /DSE There may be instances when you want to disable the local cache on the command line. If you have a cache enabled through the Ini file, you can disable it through the /xl (XL) switch on the command line.

Browser Installation Guide 23

Appendix C: If You Need Assistance

Appendix C: If You Need Assistance

Deltek Support Center The Deltek Support Center is a support Web site for Deltek customers who purchase an Ongoing Support Plan (OSP). The following are some of the many options that the Deltek Support Center provides: . Search for product documentation, such as release notes, install guides, technical information, online help topics, and white papers . Ask questions, exchange ideas, and share knowledge with other Deltek customers through the Deltek Support Center Community . Access Cloud-specific documents and forums . Download the latest versions of your Deltek products . Search Deltek’s knowledge base . Submit a support case and check on its progress . Transfer requested files to a Customer Care analyst . Subscribe to Deltek communications about your products and services . Receive alerts of new Deltek releases and hot fixes . Initiate a Chat to submit a question to a Customer Care analyst online

For more information regarding Deltek Support Center, refer to the online help available from the Web site.

Access Deltek Support Center

To access the Deltek Support Center: 1. Go to https://deltek.custhelp.com. 2. Enter your Deltek Support Center Username and Password. 3. Click Login.

If you forget your username or password, you can click the Need Help? button on the login screen for help.

Browser Installation Guide 24

Appendix C: If You Need Assistance

Additional Documentation for this Release The following table lists the additional Deltek documentation available for this release. Except where noted, all the user guides and quick reference guides listed in this table are available for download from the Deltek Customer Care Connect site.

Installation Guides

Document Name Description

Deltek Costpoint Manufacturing Execution This document provides instructions for 2.0 Browser Installation Guide installing the Costpoint Manufacturing Execution (MES) Browser software on MES client machines.

Deltek Costpoint Manufacturing Execution This document provides instructions on how 2.0 System Manager Installation Guide to install the System Manager application on a client computer and information about Application Access Management settings.

Deltek Costpoint Manufacturing Execution This document provides instructions on how 2.0 Business Application Installation Guide to install, configure, text, and troubleshoot Costpoint Manufacturing Execution on a JEE server.

Deltek Costpoint Manufacturing Execution This document provides instructions on how 2.0 Database Installation Guide for Oracle to install the Costpoint Manufacturing Execution database on an Oracle server.

Deltek Costpoint Manufacturing Execution This document provides instructions on how 2.0 Database Installation Guide for SQL to install the Costpoint Manufacturing Server Execution database on an SQL Server.

Deltek Costpoint Project Manufacturing This document provides instructions for Integration between Manufacturing Execution integrating Shop Floor Time 1.3 (SFT) and/or 2.0 and Shop Floor Time 1.3 Costpoint Manufacturing Execution 2.0 (MES).

User Manuals

Document Name Description

Deltek Costpoint Manufacturing Execution This document explains key concepts and 2.0 User Manual Volume 1: Common procedures common to all Costpoint Functionality Manufacturing Execution modules, such as logging on/off, setting user preferences, navigating within the application, entering data, and using filters, wizards, and search features.

Browser Installation Guide 25

Appendix C: If You Need Assistance

Document Name Description

Deltek Costpoint Manufacturing Execution This document provides instructions on how 2.0 User Manual Volume 2: Master Lists and define item types (Parts, Process, Machines, Libraries and Tools ) required in the application in order to develop plans as well as create libraries of multimedia objects and reusable operations and text.

Deltek Costpoint Manufacturing Execution This document describes the authoring tools 2.0 User Manual Volume 3: Process Planning you can use to write instructions. It also provides procedures for assembly, disassembly, inspection, and testing of highly engineered products.

Deltek Costpoint Manufacturing Execution This document provides instructions on how 2.0 User Manual Volume 4: Inspection to author plans detailing section Planning requirements for supplier parts. This document also provides instructions on how to add suppliers and other data such as contacts, parts supplied, and quality rating.

Deltek Costpoint Manufacturing Execution This document provides information about 2.0 User Manual Volume 5: Production managing work orders, which includes Control creating, releasing, scheduling, deleting, stopping, and resuming work on an order. It also provides information about production control tracking.

Deltek Costpoint Manufacturing Execution This document provides procedures on how 2.0 User Manual Volume 6: Operations to execute work orders released to the shop floor.

Deltek Costpoint Manufacturing Execution This document provides instructions for 2.0 User Manual Volume 8: Receiving/Buyer completing the inspection from the Inspections customer’s authorization to stock as well as supplier line requests and approvals.

Deltek Costpoint Manufacturing Execution This document provides instructions on how 2.0 User Manual Volume 10: Non- to create discrepancies for problems found Conformance during manufacturing, disassembly, or inspection, as well as how to continue work on a unit that has a discrepancy.

Deltek Costpoint Manufacturing Execution This document provides instructions on how 2.0 User Manual Volume 10: Corrective to create corrective action requests directly Action or from a discrepancy and corrective actions initiated without a request.

Deltek Costpoint Manufacturing Execution This document provides instructions on how 2.0 User Manual Volume 11: Audits to author an audit plan; schedule an audit against a process, supplier, or part; execute an audit; and record audit findings.

Browser Installation Guide 26

Appendix C: If You Need Assistance

Document Name Description

Deltek Costpoint Manufacturing Execution This document provides instruction on how to 2.0 User Manual Volume 12: Tool manually add tools to a tool list; identify and Management record the calibration settings; set location and calibration cycles for each serialized tool; and view status of serialized tool and finding where a tool is used.

Deltek Costpoint Manufacturing Execution This document provides instructions on how 2.0 User Manual Volume 13: System to create user IDs; add data to lookup and Administration validation tables; modify configuration tables to customize business rules; create and maintain supplier quality attributes; and define sapling plans and rules.

Deltek Costpoint Manufacturing Execution This document provides instructions on how 2.0 User Manual Volume 14: Management to create a personalized dashboard to Reports display a user’s favorite graphs and set up email alerts for specific tasks.

Browser Installation Guide 27

Deltek is the leading global provider of enterprise software and information solutions for government contractors, professional services firms and other project- and people-based businesses. For decades, we have delivered actionable insight that empowers our customers to unlock their business potential. 20,000 organizations and millions of users in over 80 countries around the world rely on Deltek to research and identify opportunities, win new business, recruit and develop talent, optimize resources, streamline operations and deliver more profitable projects. Deltek – Know more. Do more.® deltek.com