installation guide for db2 on windows - baan iv c4 install guide db2 windows.pdf · 1-2 | install...

SSA® Baan IVc4

Installation Guide for DB2 on Windows

© Copyright 2004 by Baan International B.V., a subsidiary of SSA Global Technologies, Inc.

All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any way or by any means, including, without limitation, photocopying or recording, without the prior written consent of BaanTM International B.V.

Important Notices

The material contained in this publication (including any supplementary information) constitutes and contains confidential and proprietary information of Baan International B.V.

By gaining access to the attached, you acknowledge and agree that the material (including any modification, translation or adaptation of the material) and all copyright, trade secrets and all other right, title and interest therein, are the sole property of Baan International and that you shall not gain right, title or interest in the material (including any modification, translation or adaptation of the material) by virtue of your review thereof other than the non-exclusive right to use the material solely in connection with and the furtherance of your license and use of software made available to your company from Baan International pursuant to a separate agreement (“Purpose”).

In addition, by accessing the enclosed material, you acknowledge and agree that you are required to maintain such material in strict confidence and that your use of such material is limited to the Purpose described above.

Although Baan International has taken due care to ensure that the material included in this publication is accurate and complete, Baan International cannot warrant that the information contained in this publication is complete, does not contain typographical or other errors, or will meet your specific requirements. As such, Baan International does not assume and hereby disclaims all liability, consequential or otherwise, for any loss or damage to any person or entity which is caused by or relates to errors or omissions in this publication (including any supplementary information), whether such errors or omissions result from negligence, accident or any other cause.

Baan International B.V., is a wholly owned subsidiary of SSA® Global TechnologiesTM, Inc.

Trademark Acknowledgments

SSA Global, SSA and the SSA Global logo are trademarks of SSA Global Technologies, Inc. in the United States and/or other countries. Baan is a trademark of Baan International B.V., in the United States and/or other countries.

All other company, product, trade or service names referenced may be registered trademarks or trademarks of their respective owners.

Publication Information

Document code : U7181F US

Release : SSA® Baan IVc4

Document title : Installation Guide for DB2 on Windows

Publication date : January 07

Table of Contents

Chapter 1 Install and configure DB2 ..........................................................................................1-1 Hardware and software requirements ..........................................................................................1-1 To create user names for DB2 installation and operation ............................................................1-2

Add the Windows user baan ...................................................................................................1-3 Install the DB2 Universal Database version 8..............................................................................1-4 To install DB2 Universal Database FixPak ..................................................................................1-4 Add user baan to the administrator’s group .................................................................................1-5 Modify database configuration parameters ..................................................................................1-5 To verify the installation ...............................................................................................................1-5 The Baan database driver level ...................................................................................................1-6

Level 1 driver ..........................................................................................................................1-6 Level 2 driver ..........................................................................................................................1-6

Chapter 2 Baan IVc4 Installation.................................................................................................2-1 Installation requirements..............................................................................................................2-1

C++ Runtime...........................................................................................................................2-2 Create the Windows user baan ..............................................................................................2-2 Installation considerations.......................................................................................................2-2

Baan IVc4 installation procedure .................................................................................................2-3

Chapter 3 Post Installation tasks................................................................................................3-9 To uninstall Baan IV software ......................................................................................................3-9

ii | Table of Contents

Appendix A To customize DB2 Universal Database for Baan IV................................................A-1 To create the DB2 database for Baan IV manually..................................................................... A-1

About this Guide

This document is a User’s Guide that describes how to install and configure SSA Baan IVc4 on a Microsoft Windows platform that runs DB2.

This guide is intended for Baan IVc4 installers and system administrators who are familiar with the system administration of Microsoft Windows systems.

Note: In this document, the term Windows refers to Microsoft Windows versions 2003.

The purpose of this document is to help you set up a working Baan Software Environment. For tuning information, refer to the BAAN IVc - Technical Reference Manual for DB2 Database Driver (U7184 US).

This document is divided into the following chapters and appendices:

Chapter 1, “Install and configure DB2,” describes the prerequisites for the installation of DB2 UDB version 8 and lists the activities to be performed to install the DB2 UDB software.

Chapter 2, “Baan IVc4 installation” describes how to install the Baan IVc4 software.

Chapter 3, “Post Installation tasks” describes some post installation tasks

Appendix A, “To customize DB2 Universal Database for Baan IV,” describes how to manually install and configure the database for Baan.

iv | About this Guide

Send us your comments

We continually review and improve our documentation. Any remarks/requests for information concerning this document or topic are appreciated. Please e-mail your comments to [email protected].

In your e-mail, refer to the document number and title. More specific information will enable us to process feedback efficiently.

mailto:[email protected]?subject=Documentation

This chapter describes the following:

The hardware and software requirements

To create user names for DB2 installation and operation

How to install DB2 Universal Database version 8

How to test the installation

How to install IBM DB2 Universal Database FixPaks

How to tune DB2 for Baan IV

The Baan Database Driver Level

Hardware and software requirements

To install DB2 Universal Database version 8 on your Baan IV server, you must check hardware and software requirements. A technical consultant is able to determine the system requirements for both Baan installation and database as this differs for each company.

IBM DB2 Universal Database Installation Prerequisites contain the requirements for the database. It describes the minimum for installation and a variable part for each user.

Hardware supported by Microsoft Windows is needed. Consult porting set release notes for supported hardware and Windows versions.

1Chapter 1 Install and configure DB2

1-2 | Install and configure DB2

Microsoft Windows Server must be installed and configured: For more information about how to set up your Windows server, refer to the Windows Installation Guide.

The latest Service Pack for Windows installed

A CD-ROM drive

A Windows-supported network adapter

The database server must contain 2 GB of free disk space to accommodate the database data files for Baan IV database. A fully loaded database requires 2,500 MB for the tables and indexes and 200 MB for the log files. Although 1.5 GB is sufficient for the initial installation, this will leave you with hardly any additional space for new data.

To create user names for DB2 installation and operation

You must have a user name that will be used to install DB2. The user name must belong to the administrators group, and must also be a valid DB2 user name or have the act as part of the operating system advanced user right. A valid DB2 user name is eight characters or less.

If this user name does not comply with DB2’s naming rules, but has the act as part of the operating system advanced user rights, the set-up program will create the user name DB2ADMIN to perform the installation.

This user name will be removed from the system when the installation is complete, unless the administration server uses the user name.

During installation, you will be asked to provide a user name and a password that the administration server will use to log on to the system and to start as a service.

By default, the set-up program fills the User Name, Password, and Confirm Password fields with db2admin. You can accept these default values, or provide your own values. If you provide your own user name, you must ensure that the user name you supply is eight characters or less and complies with DB2’s naming rules.

The set-up program creates the user name specified for the administration server if the user name does not exist.

Install and configure DB2 | 1-3

If the user name does exist, the setup program will do the following:

Verify that the user name is a member of the administrators group.

Verify that the password is valid, provided that the user name used to install DB2 has the Act as part of the operating system advanced user right.

If you use the default user name db2admin, and did not change the default password for this user name, you must change this password immediately following the installation.

When the setup program creates the db2admin user name, the set-up program also makes the user name a member of the administrators group. Because the user password is well known, you must do the following:

1 Use the user manager function of Administration Tools to change the password for db2admin.

2 Change the password for the DB2-DB2DAS00 service to match the new password that you specified for the db2admin user name.

Add the Windows user baan

To be able to run the Baan IV installation you must add the Windows user baan. Take the following steps:

1 Log on to the local server as a user with administrator rights.

2 On the Start menu, click Programs Administrative Tools (Common) User Manager for Domains.

3 Click Groups to make user baan a member of the users and administrators groups and DB2 administrator’s group.

Note: The user baan must initially be created with password baan. After you successfully complete the Baan IV installation, you can change this password.


Install the DB2 Universal Database version 8

Before you begin the installation, make sure you have DB2 Universal Database version 8 for Windows Operating Environment and the latest FixPak for your version of DB2. You must install the FixPak after the installation of DB2 UDB 8, as described in “To install DB2 Universal Database FixPak,” later in this chapter.

To start the installation CD-ROM, take the following steps:

1 Log on as a user that meets the requirements to install DB2.

2 Shut down any other programs so that the setup program can update files, as required.

3 Insert the CD-ROM into the CD-ROM drive and click OK. The Welcome dialog box appears.

4 Click Next. The Select Products dialog box appears.

5 Select DB2 Universal Database Enterprise Edition.

6 Follow the further instructions on screen. Online help is available to guide you through the remaining steps of the installation. To activate the online help, click Help.

To install DB2 Universal Database FixPak

You can download the latest DB2 FixPak directly from DB2’s Service and Support Web page:

http://www-4.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/download.d2w/report

Alternatively, you can also order the FixPak directly from IBM support.

To install a DB2 FixPak, first verify that all the software requirements for this FixPak have been met. In addition, verify that your current DB2 installed version is version 8. Follow the instructions in the Fixpak.readme file, which is available with the FixPak for platform-specific FixPak install procedure.



Install and configure DB2 | 1-5

Add user baan to the administrator’s group

After you have installed DB2 you must Add user baan to the administrator’s group The user baan must meet the following conditions:

Must have password baan during the Baan installation.

Must belong to the DB2 system administration authority group. To add the user baan to the DB2 administrator’s group, you can issue the following DB2 command from the Command Line Processor dialog box:

update dbm cfg using sysadm_group db2admns

In this command, db2admns is the name of the group with system administration privileges.

Modify database configuration parameters

The following needs to be added to the file db2cli.ini. Make sure that the active version of this file is edited. Multiple versions of this file may exist on the system.

[common] MultiConnect=3 CloseOpen=1 UseLightOutputSqlda=1 ConnectionPooling=1 ConnectionPoolingInterval=180 OptimizeForNRows=5 IgnoreWarnings=1

To verify the installation

You can verify if DB2 is installed correctly. Create the DB2 sample database on your system, and access data from this sample database. If you want to do so, please check your DB2 manual for specific information about this sample database.


The Baan database driver level

The Baan IV application communicates with the database by means of a database-specific driver. This driver translates application queries into (database) native SQL queries. As a result, the application is database-independent. The database driver is able to run in two modes, namely Level 1 and Level 2. The level 2 mode is the default mode.

Level 1 driver

For all databases that the Baan software supports, a so-called Level 1 driver is available. Level 1 means that the Baan database driver splits complicated Baan SQL statements into simple queries for the database server in an optimal way. Therefore, the Baan software performs the optimization of the SQL statements, rather than the database.

Level 2 driver

A Level 2 driver receives all queries from the Baan Virtual machine and sends these queries almost directly to the database. If applicable, the driver adds a hint to the query for optimal execution by the database engine.

Before you start to install Baan IV, you must decide whether you want to work with the Level 1 or Level 2 driver. The process to change a level after the installation requires a conversion of the entire database.

For the latest Baan IV versions in combination with DB2 database, Level 2 is recommended for new installations. To achieve good performance, you can also ensure that the database is tuned correctly.

This chapter describes the software requirements for installing Baan IVc4 for DB2 database in the Windows 2003 environment. This chapter covers the following topics:

Installation requirements

Baan IVc4 installation procedure

For the latest detailed information about the installation of Baan IVc4 please, refer to the Deployment Guide for Unix and Windows (U7949 US). It is important to review this document so you will have the correct installation steps at hand.

Installation requirements

This section provides the following preinstallation information:

Install C++ runtime

To create the Windows user baan

Installation considerations

2Chapter 2 Baan IVc4 Installation

2-2 | Baan IVc4 Installation

C++ Runtime

Make sure that the C++ runtime is installed on the system. This can be found on the CD-ROM in the following directory:

\server\InstallableUnits\i386-Windows2003. Run the executable: vcredist_x86.exe

Create the Windows user baan

To create the Windows user baan, take the following steps:

1 Log on as a user with administrator rights.

Note: You must log on to the local server.

2 Click Start Programs Administrative Tools (Common) Computer management.

3 On the User menu, add the user baan.

4 Make the user baan a member of the db2admns, Users and Administrators groups.

Installation considerations

If your database exists before the SSA Baan IVc4 installation

The Baan IVc4 installation enables you to create a new database or select an existing database.

Multiple environment support

This release supports multiple Baan IVc4 installations or environments for each Windows system.

Baan IVc4 Installation | 2-3

Baan IVc4 installation procedure

Important:

If installing the Baan IVc4 software on a Windows server, you must be logged in on the console directly or when connected via a remote desktop tool, this tool must connect to the console. For instance Microsoft’s “Remote Desktop” must be started with the option /console.

To install SSA Baan IVc4, take the following steps:

1 Close all running applications, log on as user baan, and insert the Baan IVc4 Master CD-ROM into the CD-ROM drive.

2 The Baan IV setup starts automatically. The Welcome dialog appears. For specific help on a particular dialog, click Help or F1.

Note:

If you must perform a manual launch of the Baan installation program, start setup.exe in the \server\InstallableUnits\SSA_Installation_Wizard\setup subdirectory of the Baan installation CD-ROM.

3 Carry out the instructions specified in the Wizard dialog boxes. For specific help, click Online Help or press F1.

The Environment dialog box appears.

4 Enter a new environment name (in lowercase) or choose an existing environment from the list.


5 Click Next. The Select Installable Units dialog appears:

If you require a Master Application Server installation (porting set and applications), select both SSA Enterprise Server Porting Set and Master CD Baan IV c4 (build: 3.0). The remainder of this chapter is based on that choice.

If you require an Application Server installation (porting set only), also known as a FAT client installation, select SSA Enterprise Server Porting Set.

Note: If you use this setup to install another update CD-ROM, select Another Update CD.

6 The Porting Set dialog appears. Select the porting set applicable to your system.

7 Click Next. The SSA Environment Location dialog box will appear.


8 Select Local and click Next to continue. Click Next. The Host Name dialog appears. Fill in the Password field. Please take care. For technical reasons this password cannot be checked at this stage. But the installation will fail if you fill in a wrong password.

9 Check the filled information and click Next to continue. The Destination Directory dialog box appears. The path that you enter in the Destination Directory dialog box is the directory in which the SSA Baan ERP 5.0c software will be installed. If the target directory does not exist, you must create the target directory manually.

Note:

It is recommended not to use spaces in the destination directory path.

10 Click Next to continue. The Setup Type dialog appears:

Two different set-up types are available:

Master Application Server (MAS)

Application Server (AS).

To set up an Enterprise Cluster, you must first install an MAS and install the AS later.


11 Select your set-up type and click Next to continue. The Database dialog box will appear.

12 Choose the database type you prepared to store the data of the Baan IVc4 software.

13 Click Next. The Locale dialog box will appear.

14 Select the character set and language that you want to use. The default character set is ISO_BIN. In case of a U.S. English installation, you can use this default.

If you want to install a multibyte Language Pack, such as Japanese, Simplified Chinese, Traditional Chinese, or Korean, select the appropriate locale as follows:

Platform Japanese Simplified Chinese

Traditional Chinese

Korean

Windows 2003

SHIFJIS_ WIN32

GB_WIN32 BIG5_WIN32 KOREAN_ WIN32

15 Click Next. The Database Server Location dialog box appears.

16 Select a Database Server Location. Your choice depends on whether you want to install your database on your Baan IVc4 server (Master Application Server) or on another server.

17 Click Next. The Database Connection Information dialog box will appears. Fill in the following fields:

Database Group: this is the name of the database to be created.

DB2 Instance: the database will be created in the instance specified here.

18 Click Next. The Database Users and Group dialog box will appear.

Define the users and a group for the DB2 database:

Current User: this is typically baan. Enter the password for this user

Group user: this user owns all Baan tables

19 Click Next to continue with several Database Configuration Parameters dialog boxes. Make the necessary changes based on DB2 documentation or use the defaults. To use the default values, click Defaults.

20 Click Next to continue. The Database Device Locations and Sizes dialog box with Log Directory Path. Specify a directory for the logging.


21 Click Next to continue with the following Database Device Locations and Sizes dialog box with Database Data Files configuration. This is the tablespace which will contain the actual data.

There are two options to store the data on the file system. You can store the data in a DMS or SMS tablespace.

SMS tablespace will automatically increase in size in case more data must be stored.

DMS tablespace size is fixed. The database administrator needs to increase the size in case more space is needed. However, the DMS offers the highest performance.

22 Click Next to continue. The Database Device Locations and Sizes dialog box appears with Database Index Files configuration. This is the tablespace which will contain the indexes of the tables.

23 Click Next to continue. The Database Device Locations and Sizes dialog box appears with Database Temporary Files configuration. This is the tablespace which will contain temporary data, used by the database to store query results.

24 Click Next to continue. The Database Device Locations and Sizes dialog box appears with Database Catalog Files configuration.

25 Click Next. The Program Folder dialog box appears.

26 Indicate in which folder, and under what name, this SSA IVc4 installation must be saved. The default name is Baan IV.

27 Type or select an existing program folder name or create a new folder.

28 Click Next. The Configuration Files dialog box appears.

Note:

Changing these configuration files can have serious consequences. Do not change these settings unless you have a specific reason to adjust the configuration files.

29 Click Next. The Ready to Install dialog box appears.

30 Check the parameters and click Install to start the installation.


Note:

If services are still running, a warning message appears. If you approve stopping these services, click OK.

After the installation finishes successfully, you must reboot the windows machine.

Post Installation tasks | 3-9

After you have installed the Baan IVc4 software, you must perform some additional tasks. Refer to the Deployment Guide for Unix and Windows (U7949 US). Chapter 2 explains which post installation tasks you must perform.

To uninstall Baan IV software

In case of an installation failure, take the following steps:

Use the Windows “Add or Remove Programs” to start the uninstaller. Use installed program Baan IVc4 Server.

The Baan IVc4 Back Office Uninstaller might not remove all data. You must manually remove the following items from BAAN after you run the Back Office Uninstaller:

The Baan %BSE% installation directory, for example, c:\baan. You can safely remove the entire BSE directory from the system.

Baan-specific registry entries. The following registry items must be removed:

Registry key HKEY_LOCAL_MACHINE\SOFTWARE\Baan.

Registry values BSE, BSE_REM, and BSE_TMP, all of which are under HKEY_USERS\.DEFAULT\Environment.

3Chapter 3 Post Installation tasks

3-10 | Post Installation tasks

The Baan IVc4 program folder on the Start menu. To remove the folder, use Windows Explorer and remove the Baan IVc4 directory under <WINNT>\Profiles\<User>\Start Menu\Programs.

Delete the <Windows directory>\Baan6.1.lic file

This appendix describes how to manually create the database devices for Baan IV and the Baan IV database users and group. Note that this procedure is optional for a fresh installation of the Baan IV software, because the Baan IV installation script prompts you to create these database devices during the installation of the Baan IV software if Baan IV notices that the database devices and the users and group are not present. Simply follow the procedures described in this appendix to configure DB2 UDB manually, or if you must reconfigure DB2 UDB for the import of Baan IV data.

This appendix discusses the following topics:

How to create the DB2 UDB database for Baan IV

How to create Baan IV users and groups

To create the DB2 database for Baan IV manually

This section describes how to create the DB2 database for Baan IV. The database for Baan IV will have the following tablespaces.

A SYSCATSPACE System Catalog tablespace of System Managed Space (SMS) type. This tablespace stores DB2’s catalog tables. The container for this SMS tablespace is defined as a directory instead of as a data file. At least 100 MB of free space must be available in this disk to account for future growth, because SMS tablespaces cannot have the space increased dynamically.

A Appendix A To customize DB2 Universal Database for Baan IV

A-2 | To customize DB2 Universal Database for Baan IV

A tablespace to store user data USERSPACE1. This tablespace must be created as a Database Managed Space (DMS) tablespace. If possible, assign several containers that reside on separate disks to this tablespace. Allocate a minimum of 1500 MB, in total.

A tablespace to store indexes, INDEXSPACE. This tablespace must be created of DMS type. If possible, assign several containers that reside on various disks to this tablespace. Allocate a minimum of 1500 MB in total.

A temporary tablespace, TEMPSPACE1, used by DB2 for sorts and temporary tables. This tablespace must be created of type SMS.

A set of log files located on one or more separate disk. Allocate a minimum of 500 MB for log files.

To create the Baan database, invoke the DB2 control center tool and, on the Start menu, click Programs DB2 for Windows 2003 Administration Tools Control Center.

Expand the Systems and Instances icons and right-click on Database. On the shortcut menu that appears, click Create New to start the Create Database Smart Guide.

To customize DB2 Universal Database for Baan IV | A-3

Enter the database name, alias, default drive, and a comment. To navigate through each tab of the Smart Guide, click Next or click the Specific tab of the section that you want to modify.

Create the USERSPACE1 tablespace as a DMS tablespace (file or raw device) on a drive with sufficient free space. Use the fields on the Performance tab to change the default extent and prefetch sizes for the tablespace.

Both the catalog and temporary tablespaces must be created as SMS tablespaces.


To save space on empty tables, you can select smaller values for the tablespace extent size. The prefetch size will influence how much asynchronous read DB2 does.


Use the fields on the Region tab to change the default sorting sequence for DB2. Select the Byte for Byte option for the identity-collating sequence.

Click Done to create the database. After the database creation process is complete, the main Control Center window reappears with the new database. Open this database and select the tablespaces entries to create an additional tablespace for indexes.

Note: If you require help during the index tablespace creation, use the Create Tablespace Smart Guide.


Create a regular DMS tablespace for the indexes. Click Advance to select the extent and prefetch sizes.

Define containers on a disk different from the one associated to the data tablespace (USERSPACE1). You can define more than one container on separate disks to spread I/O.


After you create the tablespaces, you can use the Performance Smart Guide tool from the control center to change some of the default configuration parameters including the number, size, and location of the database log files.

Note: You must always assign log files to disks where no other I/O operations exist, because these disks will be heavily used during the normal operation of your Baan IV system, especially when you run batch jobs. Isolating the database log files helps to reduce I/O bottlenecks.

installation guide for db2 on windows - baan iv c4 install guide db2 windows.pdf · 1-2 | install...

Documents