Kinetica 5.1 Kinetica Installation Guide

Kinetica 5.1 Kinetica Installation Guide

2012 Thermo Fisher Scientific Inc. All rights reserved. The information in this document is subject to change without notice and should not be construed as a commitment by Thermo Fisher Scientific. Thermo Fisher Scientific assumes no responsibility for any errors that may appear in this document. No part of this document may be reprinted, reproduced or utilized in any form by any electronic, mechanical or other means, now known or hereafter invented, including photocopying and recording, or in any information storage and retrieval system without permission in writing from Thermo Fisher Scientific. All trademarks recognized.

Your Comments Thermo Fisher Scientific is interested in receiving any comments you have regarding this manual. Contact details can be found at: http://www.thermo.com/informaticscontacts Part Number KIN-IG-5.1 Revision Number 1.00 Software Version Kinetica 5.1 Thermo Fisher Scientific Kinetica Installation Guide i

Notes ii Kinetica Installation Guide Thermo Fisher Scientific

Contents 1. Welcome to Kinetica... 1 Conventions... 2 Kinetica Documentation... 3 Hardware and Software Requirements... 4 2. Stand-Alone Installation... 5 3. Network Installation... 9 Preparing the Server... 10 Creating the Err.kdr File... 14 Installing a Stand-Alone from the Server... 15 4. Client Installation... 19 Thermo Fisher Scientific Kinetica Installation Guide iii

Contents Notes iv Kinetica Installation Guide Thermo Fisher Scientific

1. Welcome to Kinetica Welcome to Kinetica, a powerful, industry-standard pharmacokinetic-pharmacodynamic (PK/PD) application for non-compartmental, standard compartmental and population pharmacokinetic analyses, bioequivalence, graphing and formatting. With an intuitive point-and-click graphical interface, Kinetica facilitates data analysis and reporting in a structured yet flexible, easy-to-automate environment. This Kinetica Installation Guide is for administrators who are responsible for installing, configuring, and maintaining Kinetica servers and/or clients. Inside you ll find: System hardware and software requirements Necessary configuration settings Procedures for installing Kinetica Online Technical Support information Note Kinetica for Windows cannot co-exist on a workstation with any previous versions of Kinetica. Before starting the installation process, you must remove any previous versions of Kinetica through the uninstall procedure. The format of Kinetica Database files (.kdb extension) changed in version 5.0. All *.kdb files can be opened with Kinetica 5.0 or 5.1. However, files saved in Kinetica 5.0 and 5.1 can only be read by Kinetica versions 5.0 and later. We recommend backing up your existing.kdb files before opening them with Kinetica 5.1. Thermo Fisher Scientific Kinetica Installation Guide 1

Welcome to Kinetica Conventions The following terms, text formats, and symbols are used throughout the printed documentation. Convention Bold Italic UPPERCASE Monospace Meaning Indicates windows, buttons, column headings, command-line commands and options, icons, dialog box titles, lists, menu names, tabs, menu commands, and user input. Indicates a placeholder for information that you must provide. For instance, if a procedure asks you to type filename, you must type the actual name of a file. Italic also indicates new terms and the titles of books, disks, and CDs. Represents keyboard keys (e.g., CTRL, ENTER, F2). Represents text file contents and text displayed at the command prompt. 2 Kinetica Installation Guide Thermo Fisher Scientific

Welcome to Kinetica Kinetica Documentation In addition to this installation guide, the Kinetica package also contains the following documentation: The Kinetica User Guide is a comprehensive manual with full descriptions of the features and functions of Kinetica, including many worked examples. The Kinetica Basic Reference Guide catalogs the Kineticaspecific scripting language similar to Microsoft s Visual Basic that you may use for writing your own Kinetica methods. Thermo Fisher Scientific Kinetica Installation Guide 3

Welcome to Kinetica Hardware and Software Requirements Kinetica requires the following hardware and software to install and run successfully: Note The exact environment used in testing this release is detailed in the Version Release Description document for this release. Hardware Recommended Required Workstation IBM Compatible IBM Compatible Processor P2 Pentium 233 MHz Hard Disk Space 100+ MB 100 MB Ram Memory 256+ MB 256 MB External Setup Drive CD-ROM CD-ROM Monitor SVGA VGA Software 32-bit Operating System Internet Browser Microsoft Office Required Microsoft Windows XP, 2000, or 2003 Microsoft Internet Explorer 5.x or higher Microsoft Office 2000 or higher 4 Kinetica Installation Guide Thermo Fisher Scientific

2. Stand-Alone Installation Follow these instructions if you would like to install Kinetica as a stand-alone application on a single, local workstation. 1. Log on to your computer as Administrator. 2. Insert the Kinetica distribution CD into your computer. From the Add/Remove Programs dialog, locate the CD and select Kinetica Setup from the directory. 3. Click Open. This action displays the Run Installation Program dialog: Figure 2-1. Run Installation Program Dialog 4. Click Finish. The InstallShield Wizard is launched and the Setup Type dialog appears: Thermo Fisher Scientific Kinetica Installation Guide 5

Stand-Alone Installation Figure 2-2. Setup Type Dialog 5. Select Stand-Alone, and then click Next. The Choose Destination Location dialog appears, displaying the default path (Destination Folder) where the application will be installed. Figure 2-3. Choose Destination Location Dialog 6 Kinetica Installation Guide Thermo Fisher Scientific

Stand-Alone Installation 6. To select a different destination path (if required), click Browse and select another folder. 7. Click Next. Kinetica is installed to the selected directory. 8. Following installation, the License file installation dialog appears: Figure 2-4. License File Installation Dialog 9. Do one of the following: Click the top button to select a personal TM file from a license disk. If you choose this option, Setup will look for your personalized Kinetica license file (KXXXXXX.tm) and install it automatically. Click the bottom button to install an unlicensed version of Kinetica in Demonstration Mode. Print, save, and export functions are only available for 30 days in Demonstration Mode. If you select a personal TM file from your license disk, the following screen appears: Figure 2-5. License Transfer Confirmation Dialog Thermo Fisher Scientific Kinetica Installation Guide 7

Stand-Alone Installation Important The successful file transfer message indicates that a copy of the license file has been created in the Kinetica\Program directory. Once Kinetica is installed, ensure that the disk containing your license file is stored in a secure place. Your company will be held responsible for any copyright infringement that may occur if this file is reproduced or distributed either outside your company or on more computers than stipulated in your license agreement. 10. Click Finish to conclude the InstallShield Wizard. 11. Right-click on the Start menu and select Explore. Locate the license folder in the Kinetica Program directory. Right-click on this folder and select Properties. Select the Security tab. Verify that all users of this computer have read-write permissions. If they do not, assign them at this time. 12. Restart the workstation. 13. Click on the Start menu. Kinetica appears under the Programs menu. 14. Click on the Kinetica menu option to start the application. 8 Kinetica Installation Guide Thermo Fisher Scientific

3. Network Installation Kinetica can be installed on a network drive and function as a file service for client workstations mapped to the network drive. Some configuration is required for a Kinetica network installation on a mapped network drive. The workstation that is used for installation will operate as a fully functional client workstation. If Kinetica is removed from this workstation using the uninstall utility, the application files will be removed from the mapped network drive. If the mapped drive is disconnected at any time, you will need to re-install Kinetica. The system administrator who has read-write access to the network drive where the applications files will be installed must create two shared directories: One shared directory must have read-only privileges. The application files will reside in this directory. For example, X:\Kinetica (X: = mapped drive letter) The other shared directory must have read-write privileges. The run-time license file will reside in this directory. For example, X:\License\Kinetica (X: = mapped drive letter) Note The mapped drive letter MUST be the same as the drive letter in the Err.kdr file. The procedure for creating the Err.kdr file is described in the section below, Creating the Err.kdr File. In addition, the mapped drive letter MUST be the same on ALL workstations. Thermo Fisher Scientific Kinetica Installation Guide 9

Network Installation Preparing the Server The following steps prepare a server to deliver installation files over a network to remote clients. 1. Log on to the installation computer as Administrator. 2. Insert the Kinetica distribution CD. From the Add/Remove Programs dialog, locate the CD and select Kinetica Setup from the directory. 3. Click Open to display the Run Installation Program dialog: Figure 3-1. Run Installation Program Dialog 4. Click Finish. The InstallShield Wizard is launched and the Setup Type dialog appears: 10 Kinetica Installation Guide Thermo Fisher Scientific

Network Installation Figure 3-2. Setup Type Window 5. Select Server, and then click Next. The Choose Destination Location dialog appears, displaying the default path (Destination Folder) where the application files will be installed. Figure 3-3. Choose Destination Location Window Thermo Fisher Scientific Kinetica Installation Guide 11

Network Installation 6. Select the destination folder (i.e., X:\Kinetica where X: is the mapped drive letter) on the appropriate mapped network drive, and then click Next. 7. Click Next. Kinetica is installed to the selected directory. 8. After installation, the License file installation dialog appears. Figure 3-4. License File Installation Dialog 9. Do one of the following: Click the top button to select a personal TM file from a license disk. If you choose this option, Setup will look for your personalized Kinetica license file (KXXXXXX.tm) and install it automatically. Click the bottom button to install an unlicensed version of Kinetica in Demonstration Mode. Print, save, and export functions are only available for 30 days in Demonstration Mode. If you select a personal TM file from your license disk, the following screen appears: Figure 3-5. License Transfer Confirmation Dialog 12 Kinetica Installation Guide Thermo Fisher Scientific

Network Installation Note The successful file transfer message indicates that a copy of the license file has been made in the Kinetica\Program directory. Once Kinetica is installed, ensure that the disk containing your license file is stored in a secure place. Your company will be held responsible for any copyright infringement that may occur if this file is reproduced or distributed either outside your company or on more computers than stipulated in your license agreement. 10. Click Finish to conclude the InstallShield Wizard. 11. Restart the workstation. Note Kinetica licensed user access requires that the license file (KXXXXXX.tm) be linked to a run-time license file (Err12.ktx). The run-time license file is created during the installation of Kinetica in X:\Kinetica\Program (X: = mapped drive letter). 12. Move the run-time license file (Err12.ktx) from X:\Kinetica\Program\License to the read-write directory X:\License\Kinetica. Thermo Fisher Scientific Kinetica Installation Guide 13

Network Installation Creating the Err.kdr File To create the Err.kdr file: 1. Select Programs from the Start menu. 2. Select Accessories and then select Notepad. Notepad opens an Untitled document. 3. In the Untitled document, enter the path name for the Kinetica run-time license file, Err12.ktx. For example, X:\License\Kinetica. (X:= the mapped drive letter) 4. Select the File menu Save As option to access the Save As dialog. 5. Enter X:\Kinetica\Program in the Save field to ensure that the new file is saved in the correct location. 6. Enter Err.kdr in the filename field. 7. Exit Notepad. 8. Open X:\Kinetica\Program\err.kdr using Notepad to confirm that the file contains the correct directory path for the Kinetica license file (e.g. X:\License\Kinetica). Note When you save the Err.kdr file using Notepad, if the extension.txt is appended to the filename (so that the filename appears as Err.kdr.txt) you MUST rename the file to Err.kdr. To rename the file, locate it using Windows Explorer, right mouse click on the filename, select the option Rename, and type in the new filename, Err.kdr. 14 Kinetica Installation Guide Thermo Fisher Scientific

Network Installation Installing a Stand- Alone from the Server The installation of Kinetica from a mapped network drive to a local workstation requires approximately five megabytes of disk space on the local workstation. Each client workstation must be mapped successfully to the readonly directory to access the application files, and mapped successfully to the read-write directory where the run-time license file resides. Please select the option to reconnect at logon when mapping these two-shared areas to each client workstation. It is strongly recommended that the same mapping designations (drive names) be used for all clients mapped to the read-only directory where the application files reside, and the read-write directory where the run-time license file resides. After the run-time license file configuration has been completed, the Kinetica Client installation can continue. Note If an automated application deployment tool is used to install the Kinetica client version, please contact Thermo Fisher Scientific before attempting a package build (contact information is located at the front of this manual). After the network installation is successfully completed, the file Setup.exe file (the program that enables you to perform the client installation) can be found in X:\Kinetica\ClientSetup (X: =mapped drive letter) or on the CD. To perform the Kinetica client installation from the server: 1. Navigate to X:\Kinetica\ClientSetup, and then double-click on the Setup.exe file. 2. The InstallShield Wizard for Kinetica dialog launches with Choose Destination Location dialog, displaying the default path where the application will be installed. Thermo Fisher Scientific Kinetica Installation Guide 15

Network Installation Figure 3-6. Choose Destination Location Dialog 3. Select a different destination path (Destination Folder), if required. 4. Click Next. Kinetica is installed in the selected directory. 5. When installation is complete, click Finish to conclude the InstallShield Wizard. 6. Restart the workstation. 7. Click on the Start menu. Kinetica appears in the Programs menu. 8. Click on the Kinetica menu option to start Kinetica. Your network license dictates the maximum number of simultaneous Kinetica users. If the maximum number of users is reached, additional users trying to log on will see the following message: 16 Kinetica Installation Guide Thermo Fisher Scientific

Network Installation Figure 3-7. License dialog when number of licenses is exceeded. Thermo Fisher Scientific Kinetica Installation Guide 17

Network Installation Notes 18 Kinetica Installation Guide Thermo Fisher Scientific

4. Client Installation To set up a client-server environment and run a server-based copy of Kinetica from a remote client, follow the instructions below. 1. Log on to the installation computer as Administrator. 2. Insert the Kinetica distribution CD. From the Add/Remove Programs dialog, locate the CD and select Kinetica Setup from the directory. 3. Click Open to display the Run Installation Program dialog: Figure 4-1. Run Installation Program Dialog 4. Click Finish. The InstallShield Wizard is launched and the Setup Type dialog appears. 5. Select Client and click Next. Thermo Fisher Scientific Kinetica Installation Guide 19

Client Installation Figure 4-2. Setup Type Dialog 6. The Specify Program Location dialog appears. Figure 4-3. Specify Program Location Dialog 7. Browse to locate the appropriate server location, and then click Next. The Choose Destination Location dialog appears. 20 Kinetica Installation Guide Thermo Fisher Scientific

Client Installation Figure 4-4. Choose Destination Location Dialog 8. Use the Browse button to select a different destination path (Destination Folder), if required. 9. Click Next. Kinetica is installed to the selected directory. 10. When installation is complete, click Finish to conclude the InstallShield wizard. 11. Restart the workstation. 12. Click on the Start menu. Kinetica appears in the Programs menu. 13. Click on the Kinetica menu option to start the application. Thermo Fisher Scientific Kinetica Installation Guide 21

Client Installation Notes 22 Kinetica Installation Guide Thermo Fisher Scientific

Thermo Fisher Scientific P.O. Box 9046 Waltham, Massachusetts 02454-9046 United States www.thermo.com/informatics