64
BaanERP Sybase Installation Guide for BaanERP on UNIX

BaanERP Sybase Installation Guide for BaanERP on UNIXbaansupport.com/docs/baan/Sybase Installation Guide... · Sybase Installation Guide for BaanERP on UNIX ... To tune the system

Embed Size (px)

Citation preview

BaanERP

Sybase Installation Guide forBaanERP on UNIX

A publication of:

Baan Development B.V.P.O.Box 1433770 AC BarneveldThe Netherlands

Printed in the Netherlands

© Baan Development B.V. 1999.All rights reserved.

The information in this documentis subject to change withoutnotice. No part of this documentmay be reproduced, stored ortransmitted in any form or by anymeans, electronic or mechanical,for any purpose, without theexpress written permission ofBaan Development B.V.

Baan Development B.V.assumes no liability for anydamages incurred, directly orindirectly, from any errors,omissions or discrepanciesbetween the software and theinformation contained in thisdocument.

Document Information

Code: U7081C USGroup: User DocumentationEdition: CDate: June, 1999

i

Sybase Installation Guide for BaanERP on UNIX

1 Installation preparation 1-1Hardware and software requirements 1-1Tune the kernel 1-2Shared memory 1-2Asynchronous disk I/O 1-3Number of users 1-4Test TCP/IP 1-4Create database devices 1-5Create the required UNIX directories, groups, and users 1-5Create UNIX directories 1-6Create UNIX groups 1-6Create UNIX users 1-7Set environment variables 1-7Sybase environment variables 1-7BAAN environment variables 1-8

2 Sybase installation for BaanERP 2-1Sybase Adaptive Server installation 2-1Unload the software 2-1Create Sybase servers 2-3Prepare Sybase for BaanERP 2-3

3 BaanERP installation 3-1Steps for BaanERP installation 3-1Local software load 3-2Remote software load 3-4Install the software 3-7Post-installation tasks 3-17

4 BaanERP configuration 4-1To install the demo tables 4-2Create tables for the demo models 4-3To import the version dumps 4-4Initialize parameters 4-5Reorganize tables 4-6Configure shared memory 4-7Set up shared memory 4-7Create the audit database and assigning tables 4-9

Table of contents

Table of contents

Sybase Installation Guide for BaanERP on UNIX

ii

Validate the system 4-10Define the default currencies 4-13Change passwords 4-13

5 Appendix A: The DBA Module 5-1Add a BaanERP user 5-1To add a database group 5-3Add a database user 5-4Link a BaanERP user to a database user 5-6Link multiple BaanERP users to database users 5-8Move between the DBA module sessions 5-10

Sybase Installation Guide for BaanERP on UNIX

iii

This document describes the process of installing BaanERP to using the SybaseAdaptive Server Enterprise version 11.9 as the RDBMS. It describes how toinstall and configure Sybase Adaptive Server for BaanERP and how to installBaanERP. To tune the system for improved performance, you will need to referto the Baan document BaanERP Sybase Database Driver Technical ReferenceManual (U7082B US).

This guide is divided into the following four chapters and one appendix:

Chapter 1 describes the steps that must be taken before installing SybaseAdaptive Server and BaanERP.

Chapter 2 describes the steps necessary to install Sybase Adaptive Server.

Chapter 3 describes the installation of the BaanERP software.

Chapter 4 describes how to configure BaanERP and how to set up the demodatabase.

Appendix A describes the Database Administrators (DBA) module.

About this document

About this document

Sybase Installation Guide for BaanERP on UNIX

iv

Sybase Installation Guide for BaanERP on UNIX

1-1

There are several tasks that must be performed before installing BaanERP on aUNIX system using the Sybase Adaptive Server as the database server. Thischapter describes how to perform these tasks. The following topics are coveredin this chapter:

n Hardware and software requirementsn Tune the kerneln Test TCP/IPn Create database devicesn Create UNIX directories, groups, and usersn Set environment variables

Hardware and software requirementsThere are several hardware configurations that can be used to install BaanERPwith Sybase Adaptive Server version 11.9. The following are the minimumrequirements for installing both BaanERP and Sybase Adaptive Server on thesame server.

n Sybase Adaptive Server Enterprise version 11.9

n A UNIX system (Sun Solaris, HP-UX, IBM AIX, or Digital UNIX)

n TCP/IP software—installed, configured, and running

n A CD-ROM drive if the distribution medium for Sybase is CD-ROM

n A 4 millimeter tape drive for the BAAN distribution

n A minimum of 90 MB hard disk space for the Sybase software

n A minimum of 250 MB hard disk space for the BAAN software environment(BSE)

n A minimum of 2.3 gigabytes (GB) hard disk space for the database

n Hard disk space equivalent to 2.5 to 3 times the size of the internal memoryfor the UNIX swap space

n A network adapter

1 Installation preparation

Installation preparation

Sybase Installation Guide for BaanERP on UNIX

1-2

Tune the kernelSeveral kernel parameters must be adjusted before you can install the Sybase andBAAN software. The following parameters must be verified and changed ifnecessary:

n Shared memoryn Asynchronous disk I/On Number of users

The following sections provide basic information on tuning requirements. If youneed more information, please refer to the Sybase manual Installing AdaptiveServer and OmniConnect on UNIX Platforms or your system documentation.

Shared memory

For Sybase Adaptive Server to run, the operating system kernel must be set toallow a shared memory segment to be allocated. Although the shared memorysegment requirements that Sybase recommends vary by platform and are around24 MB, Baan recommends that you allocate at least 256 MB.

After you install Sybase Adaptive Server, you can increase the total memoryparameter by using the Sybase procedure sp_configure. When you increasememory for Sybase Adaptive Server, increase the operating system kernelparameters by a similar amount.

The procedure you must use to set shared memory depends on the platform youare using.

Setting shared memory

Platform OS configuration file Shared memoryparamter

HP/UX Use the system administration manager (SAM).

Sun Solaris /etc/system shminfo_shmmax

IBM AIX N/A N/A

Digital UNIX /etc/sysconfigtab shm-max

For more information, refer to the Sybase manual Installing Adaptive Server andOmniConnect on UNIX Platforms.

Installation preparation

Sybase Installation Guide for BaanERP on UNIX

1-3

Asynchronous disk I/O

Depending on the system you are using, asynchronous disk I/O may need to beenabled. If you are using IBM AIX, you must enable asynchronous disk I/O. Ifyou are using an HP or Digital UNIX system you are recommended to enableasynchronous disk I/O. If you are using a Sun system, it is not required.

Enable Asynchronous Disk I/O

Platform Procedure

HP/UX 1) From the SAM Kernel Configuration menu, select Drivers

2) Set the Pending State for asyncdisk to IN

3) From the Actions menu option, rebuild the kernel andreboot the system

4) Execute the following statements as root at the UNIXcommand line:

% /etc/mknot /dev/async c 101 4

% chmod 0660 /dev/async

% chown sybase /dev/async

Sun Solaris Not required.

IBM AIX 1) Enter smit at the UNX command line.

2) From the Devices menu, select Asynchromous I/O.

3) Select the Change/Show Characteristics of AsynchronousI/O option.

4) Enter the following values for the SMIT parameter andentry boxes for AIX 4.1.2:

MINIMUM number of servers: 1

MAXIMUM number of servers: 10

MAXIMUM number of REQUESTS I/O: 4096

Server priority: 39

ASYNC I/O STATE to be configured at system restart:available.

If your system uses more than 7 disks at the same time forAIO, increase the MAXIMUM number of servers parameter by1 for every active device.

Digital UNIX Digital UNIX automatically enables asynchronous I/O but, bydefault, limits the number of concurrent I/O requests to 64. Ifyou expect to need additional requests for your AdaptiveServer installation, add the following lines to the/etc/sysconfigtab file:

rt:

aio-maximum=1024

Installation preparation

Sybase Installation Guide for BaanERP on UNIX

1-4

For more information, please refer to of the Sybase manual Installing AdaptiveServer and OmniConnect on UNIX Platforms.

Number of users

The kernel of the UNIX machine must be tuned to accommodate the projectednumber of BAAN users. Please refer to your system administrationdocumentation to adjust this value.

Test TCP/IPTo start the BAAN license daemon, TCP/IP must be configured correctly. Verifythat the command: ping hostname produces a correct response. The responsetime for this command must be no longer than 20 milliseconds (ms).

sheliak> ping sheliak 65 7PING sheliak.BAAN.nl (193.79.3.7): 65 data bytes73 bytes from 193.79.3.7: icmp_seq=0 ttl=255 time=1 ms73 bytes from 193.79.3.7: icmp_seq=1 ttl=255 time=1 ms73 bytes from 193.79.3.7: icmp_seq=2 ttl=255 time=1 ms73 bytes from 193.79.3.7: icmp_seq=3 ttl=255 time=1 ms73 bytes from 193.79.3.7: icmp_seq=4 ttl=255 time=1 ms73 bytes from 193.79.3.7: icmp_seq=5 ttl=255 time=1 ms73 bytes from 193.79.3.7: icmp_seq=6 ttl=255 time=1 ms--- sheliak.BAAN.nl ping statistics ---7 packets transmitted, 7 packets received, 0% packet lossround-trip min/avg/max = 1/1/1 ms

Installation preparation

Sybase Installation Guide for BaanERP on UNIX

1-5

Create database devicesSeveral database devices must be created prior to installing the Sybase andBAAN software. Database devices are operating system files or raw portions of adisk used to store databases and database objects. Whenever possible, create thedevices on different disks. The following table specifies the database devices thatmust be created.

Required database devices

Device Purpose Recommendedsize

Recommendedtype

master Stores Sybase systemdatabases

30 MB Raw partition

sysprocsdev Stores Sybase storedprocedures

60 MB File system

baandata01 Stores BaanERP data 2 GB Raw partition

baanindex01 Stores BaanERP indexes 2 GB Raw partition

baanlog01 Stores BaanERP logginginformation

100 MB Raw partition

baandbs01 Stores BaanERP metainformation

100 MB Raw partition

tempdbs Stores the Sybasetempdb database

100 MB File system

Create the required UNIX directories, groups,and usersBefore you install the Sybase and BAAN software, the directories where theywill be installed must be created. In addition, for a first-time installation, severalUNIX users and groups must be created both for Sybase and for BAAN. Thefollowing sections specify the directories, users, and groups that you need tocreate.

Installation preparation

Sybase Installation Guide for BaanERP on UNIX

1-6

Create UNIX directories

You will need to create a home directory both for the Sybase products and forBaanERP. To create these directories, carry out the following:

1 Create a directory for the Sybase product. Later, you will set an environmentvariable called SYBASE that will contain the path to this directory.

If you are upgrading from an earlier version of Sybase, be sure to create anew installation directory. Do not install the new version in the samedirectory as the earlier version.

2 Set the permissions of the SYBASE directory to read, write, and execute.

3 Create a directory for BaanERP. Later, you will create an environmentvariable called BSE (BAAN Software Environment) that will contain the pathto this directory.

4 Set the permissions for the BSE directory to read, write, and execute.

Create UNIX groups

You will need the UNIX group accounts sybase, bsp, and baan before you caninstall Sybase and BaanERP. You can use a standard system administrationutility to add these groups. The following describes each of these groups.

n sybaseThe group sybase includes the users who are given system administrationprivileges for the Sybase database.

n bspThe group bsp includes the users who are given system administrationprivileges for the BAAN database. The group bsp must be given the UNIXgroup id 125.

n baanThe group baan includes all users who are given user access to the BAANdatabase.

WARNING

Installation preparation

Sybase Installation Guide for BaanERP on UNIX

1-7

Create UNIX users

Several UNIX users are required for both the Sybase and the BAANinstallations. You can use a standard system administration tool to create therequired users. The following table provides details on these users.

UNIX users and groups

Logon id Primary group

sybase sybase

baan bsp

bsp bsp

demo bsp

applic bsp

Be sure to assign the user bsp a user ID of 125.

Set environment variablesSeveral environment variables must be set for both Sybase and for BaanERP.This section describes the variables that must be set before the software isinstalled.

Sybase environment variables

Four environment variables must be set in the .profile of the user sybase beforeSybase can be installed. Three of these variables are the same for all hardwareplatforms, but the fourth is platform dependent. The following are the threeplatform independent variables and the values they must be set to.

Platform independent environment variables

Environment variable Setting

SYBASE The complete path to the Sybase installationdirectory

DSQUERY The name of the Sybase instance that will be createdduring the BAAN installation, for example, baanV

PATH Must include $SYBASE/bin

The fourth environment variable that must be set in the .profile of the usersybase has different names for different platforms. This variable defines thelibrary path. How you set this variable depends on whether or not a previouslibrary path has been defined.

Installation preparation

Sybase Installation Guide for BaanERP on UNIX

1-8

The following table gives the names and settings for the library path for thedifferent platforms (in the following example, the settings for sh are provided).

Platform dependent environment variable

Platform Environment variable Setting

Sun Solaris

Digial UNIX

LD_LIBRARY_PATH If not set previously:

$SYBASE/lib

If set previously:

$SYBASE/lib:$LD_LIBRARY_PATH

HP-UX SHLIB_PATH If not set previously:

$SYBASE/lib

If set previously:

$SYBASE/lib:$SHLIB_PATH

IBM AIX LIBPATH If not set previously:

$SYBASE/lib

If set previously:

$SYBASE/lib:$LIBPATH

If the library path variable was set previously, be sure to add $SYBASE/lib firstin the path as listed in the table, otherwise you may encounter unresolvablesymbol errors.

BAAN environment variables

After installing BaanERP, you can define the $BSE variables in the .profile filesof the users instead of in the system-wide /etc/profile. If you plan to installBaanERP in a directory that previously existed, there may already be directoriesin the $BSE/home directory. If so, remove any .profile files from thesedirectories. The BaanERP installation script creates .profile files for thedirectories of $BSE/home, but will not overwrite any files that already exist.

NOTE

Sybase Installation Guide for BaanERP on UNIX

2-1

This chapter describes the following:

n Sybase products installationn Prepare Sybase for BaanERP

Sybase Adaptive Server installationBefore you install the Sybase Adaptive Server, you must complete the stepsdescribed in Chapter 1, Installation preparation. There are two steps to installingthe Sybase Adaptive Server:

n Unload the softwaren Create the Sybase servers

These steps are described in the following two sections.

Unload the software

The Sybase Adaptive Server is distributed both on CD-ROM and on tape. Themost common distribution medium is CD-ROM, so the following instructionsassume a CD-ROM distribution. If you have a tape, please refer to the Sybasemanual Installing Adaptive Server and OmniConnect on UNIX Platforms.

The instructions also assume that the machine you are using has X Windows. Ifnot, you must use the sybload utility to unload the CD-ROM in text modeinstead of the sybsetup utility. If you do not have X Windows, please refer to theSybase manual Installing Adaptive Server and OmniConnect on UNIX Platforms.

To install Sybase Adaptive Server from CD-ROM on a machine running XWindows, carry out the following:

1 Place the Sybase CD-ROM in the CD-ROM drive. The next step is to mountthe CD-ROM. If you are installing on a Sun system, skip to Step 4. Solarismachines mount the CD automatically.

2 Log in as user root to a UNIX system attached to the CD-ROM drive. If youare installing Sybase on a machine that is not attached to the CD-ROM, youmust log in remotely.

2 Sybase installation for BaanERP

Sybase installation for BaanERP

Sybase Installation Guide for BaanERP on UNIX

2-2

3 Mount the CD by entering the following platform specific command:

Platform Command

Sun Solaris Not applicable. Sun provides auto mount.

HP % /etc/mount -F cdfs -o ro device_name /cdrom

IBM AIX % /etc/mount -v cdrfs -r device_name /cdrom

Digital UNIX % /usr/sbin/mount -r -t cdfs -o noversion –o rripdevice_name /cdrom

Where device_name is the device name of the CD-ROM and /cdrom is thename of the directory where the CD is to be mounted.

4 Log in as sybase to the UNIX system attached to the CD-ROM drive.

5 Run the sybsetup utility to unload Sybase products from the CD-ROM usingthe following platform dependent command:

Platform Command

Sun Solaris % /cdrom/cdrom0/sybsetup

HP/UX

IBM AIX

Digital UNIX

% /cdrom/sybsetup

% /cdrom/sybsetup

% /cdrom/sybsetup

6 Select Unload Sybase Products from the sybsetup menu and follow thedirections on the screen.

7 Log in as root and enter the following platform dependent command tounmount the CD-ROM:

Platform Command

Sun Solaris % /usr/bin/eject cd

HP/UX

Digital Unix

% /etc/umount /cdrom

% /etc/umount /cdrom

IBM AIX % /etc/unmount /cdrom

8 When unloading is complete, remove the Sybase CD from the drive andcontinue with the following section, “Create Sybase servers”.

Sybase installation for BaanERP

Sybase Installation Guide for BaanERP on UNIX

2-3

Create Sybase servers

After you have unloaded the Sybase software, you are ready to create the Sybaseservers. You will need to create an Adaptive Server. In addition, you arerecommended to create a Backup Server. To create these servers, carry out thefollowing:

1 Start srvbuild, the Sybase server creation utility, by clicking Build NewServers on the sybsetup main menu, or by typing the following command atthe UNIX command prompt:

% $SYBASE/bin/srvbuild

2 From the srvbuild menu, select Adaptive Server and Backup Server.

3 The Server Attribute Editor screen is displayed for the Adaptive Server.Enter the following information:

server name The value of the DSQUERY variable

master device path name Enter the path to the master device created inChapter 1

sysprocsdev device pathname

Enter the path to the sysprocsdev devicecreated in Chapter 1

error log path Accept the default path for the error log orenter a new path

4 Verify the connection information and set the Transport type, Host name,and Port number to values appropriate for your system.

5 The Server Attribute Editor is displayed for the Backup Server. Set theattributes as required.

6 Click Build Servers. You are asked if you would like to add a language otherthan U.S. English or a character set other than iso-1.

7 If you click Yes, the Add and Remove Languages screen is displayed.Select the desired languages and character sets.

Prepare Sybase for BaanERP

Take the following steps to adjust the Sybase installation for BaanERP:

1 Change directories to the Sybase installation directory defined by $SYBASE.

Sybase installation for BaanERP

Sybase Installation Guide for BaanERP on UNIX

2-4

2 Use vi to modify the following entries in the DSQUERY.cfg file (in ourexample, baanV.cfg) to these values:

procedure cache percent = 30number of devices = 20default network packet size = 4096max network packet size = 4096tcp no delay = 1total memory = 131072 (256 MB)number of locks = 50000

3 Stop Sybase by entering the following commands:

$ isql -Usa -p””1> shutdown2> go

4 Start Sybase by entering the following commands:

$ cd $SYBASE/install$ ./startserver -f ./RUN_DSQUERY

5 After the output of the startserver command has stopped, press ENTER toreturn to command prompt.

6 Enter the following commands to define a password for the Sybase databaseadministrator sa. This password must be a minimum of six characters. In thisexample, the password is manager.

$ isql -U sa -P “”1> sp_password NULL, manager2> go

7 Enter the following commands to enlarge the existing temporary database:

$ isql -U sa -P manager1> disk init2> name = “temp01”,3> physname = “path name to raw device for temporary database”,4> vdevno = 2, (or whatever number is free)*5> size = 512006> go1> alter database tempdb on temp01 = 1002> go1> use temdb2> go1> create procedure sp_thresholdaction2> @dbname varchar(30),3> @segmentname varchar(30),4. @space_left int,

Sybase installation for BaanERP

Sybase Installation Guide for BaanERP on UNIX

2-5

5> @status int6> as7> dump transaction @dbname with truncate_only8> print “LOG DUMP ‘%1!’ for ‘%2!’ dumped”, @segmentname, @dbname9> go1> grant exec on sp_thresholdaction to dbo2> go1> sp_addthreshold tempdb, “logsegment”, 512, sp_thresholdaction2> goexit

* The value for vdevno is 2 here. During installation, however, you must usesp_helpdevice to select a free device number, because the virtual device number2 may already be in use.

Sybase installation for BaanERP

Sybase Installation Guide for BaanERP on UNIX

2-6

Sybase Installation Guide for BaanERP on UNIX

3-1

This chapter describes how to install BaanERP. It also describes some of thepost-installation tasks that must be done after installing BaanERP. The followingtopics are discussed:

n Steps for installing BaanERPn Load the software locallyn Load the software remotelyn Install the softwaren Post-installation tasksn Add new BAAN users

Steps for BaanERP installationNote that you must install BaanERP using a Windows 95 or Windows NT basedsystem because a part of the installation must be performed using the BAANWindows (BW) client software. You must use terminal emulation software (forexample, Reflection) to connect to the UNIX server.

To install BaanERP there are two major steps:

1 Load the software from tapeThe software can be loaded locally or remotely. A local installation meansthat the tape drive is connected to the system on which the software is beinginstalled. A remote installation means that the installation is done on a localsystem from a tape loaded on a remote system in the network. Later in thischapter, a local installation is described in the section “Local software load,”and a remote installation is described in the section “Remote software load”.

2 Install the softwareAfter the software is loaded from the tape, it must be installed. This step isdescribed in the section, “Install the software”, later in this chapter.

The master tape shipment may include a second tape, called a patch tape. Use thesame master tape procedure to read the patch tape into a separate, emptydirectory. If a patch tape is included, see the manual enclosed with it forinstallation instructions.

3 BaanERP installation

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-2

The first step is to load the BaanERP software from tape. If you are loading thesoftware locally, continue with the following section, “Local software load”. Ifyou are loading the software remotely skip to the section, “Remote softwareload”.

Local software loadThis section describes how to load the BAAN software from a local tape deviceattached to the UNIX server. To load the software, follow these steps:

1 Log on as user root and create the directory in which to load the BAANsoftware, for example, /usr2/tape50a. To create this directory, type thefollowing commands:

mkdir /usr2/tape50achmod 777 /usr2/tape50a

Never load the software into a directory in an existing BSE environment orinto a directory containing existing BAAN tables. If you do so, theinstallation script will not work.

2 Change directories to the directory created in Step 1 by typing the followingcommand:

cd /usr2/tape50a

3 Make sure that the tape is positioned at the beginning of the tape. You canuse one of the following commands to rewind the tape:

# < local_rewind_device

# mt -t local_device rewind

You can enter the following command at the system prompt to check if themt command is available (If there is no magnetic tape manipulation programavailable, you must use the cpio command for this purpose):

# type mt

4 Enter the following command at the system prompt to retrieve the installationscript from tape:

# cpio -icvdB < local_device

CAUTION

NOTE

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-3

5 Start the mas.read6.2 utility to read the software from tape by entering oneof the following commands.

# sh mas.read6.2

# sh mas.read6.2 -d local_device

6 A screen with help information is displayed. Read this information and pressENTER.

7 You are asked if the streamer is connected to the local system. If the streameris connected to the system, press ENTER.

8 The following menu is displayed, asking you which option is to be installed.

Available options with mas.read6.21) Select packages and Operating System2) Select only the Operating System3) Select components for Workstation installationChoice: [1]

Press ENTER to select 1 for a complete installation of Package VRCs andoperating system (full server installation). If you select 2, only theexecutables for the chosen operating system are read from the tape. If youselect 3, only the workstation software is read from the tape.

If you select 2 or 3, mas.read6.2 skips the next two steps and continues withStep 11.

9 A menu is displayed asking you which packages you want to install. PressENTER if you want to install the displayed packages. Press Y followed byENTER if you want to select different packages.

10 A menu is displayed asking you which languages you want to install. PressENTER if you want to install the displayed languages. Press N followed byENTER if you want to select different languages.

11 A menu is displayed asking you which operating system you want to install.Press ENTER if you do not want to install the operating system dependentbinaries. Otherwise, select the relevant operating system.

12 You are asked to enter the no-rewind device name of the streamer. Type thedevice name of the no-rewind device. If you specified the device name at thecommand line in Step 4, you will not be asked this question.

13 You are asked if you are sure that the tape is in its device. Press ENTER tocontinue.

14 A message is displayed asking if you want to test the no-rewind device. Youare recommended to test the device if the entered device name is a real no-rewind device. Press ENTER to test the no-rewind device.

NOTE

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-4

15 A message is displayed asking if you want the system to check if there isenough space to read the software. Press ENTER to have the system checkdisk space requirements. If there is not enough disk space, make more diskspace available or select fewer languages or packages and start the processagain.

16 A message is displayed asking if you want to start reading the tape. PressENTER to read the tape.

17 After the mas.read6.2 utility has finished, you are asked if you want to readmore languages from tape. If you do not want to read more languages, pressENTER. If you do want to read more languages, press Y followed by ENTERand you will be asked again which packages and languages you want toinstall.

When all required software has been read from tape, you are ready to runinstall6.2 to install the software. Skip to the section, “Install the software”, inthis chapter.

Remote software loadThis section describes how to load the BAAN software from a remote tapedevice—a tape device attached to a server other than the UNIX server on whichthe BaanERP software is to be installed. To load the software, follow these steps:

1 Log on as user root and create the directory in which to load the BAANsoftware, for example, /usr2/tape50a.

Never load the software into a directory in an existing BSE environment orinto a directory that contains existing BAAN tables. If you do so, theinstallation script will not work.

2 Change directories to the directory created in Step 1 and be sure that the tapeis positioned at the beginning of the tape. You can the following command torewind the tape:

# remote_shell system_name “mt -t remote_device rewind”

CAUTION

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-5

The variables in this command are explained here:

− remote_shellThis is the remote shell command on the local system; it is typicallyremsh.

− system_nameThis is the system name of the remote system where the tape is connected.For example, if the local system is named delta and the system where thetape is connected is named haro, specify haro. Make sure that delta isspecified in the /.rhosts file on haro.

− remote_deviceThis is the tape device name on the remote system. This can be a rewindor a no-rewind device.

You can enter the following command at the system prompt to check if themt command is available on the remote system. (If there is no magnetic tapemanipulation program available, you must use the cpio command for thispurpose):

# remote_shell system_name "type mt"

3 Enter the following command at the system prompt to retrieve the installationscript from tape:

# remote_shell system_name dd if=remote_device bs=64k | cpio -icvdB

The variables in this command are the same as those described in Step 2

4 Start the mas.read6.2 utility to read the software from tape by entering oneof the following commands.

# sh mas.read6.2

# mas.read6.2 -d remote device

5 A screen with help information is displayed. Read this information and pressENTER.

6 You are asked if the streamer is connected to the local system. Press Nfollowed by ENTER.

7 The following message is displayed:

Give the remote-system: [ ]

Type the remote hostname.

NOTE

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-6

8 The following message is displayed:

Give the remote-shell commandExamples: remsh, rcmd, rshell: [ ]

Type the remote shell to be used.

9 The following message is displayed:

Give the username on the remote -system: [root]

Type the logon name to be used on the remote system.

10 At this point of the installation mas.read6.2 tries to connect to the remotesystem using the data you entered in the Steps 7 through 9. If it succeeds, itwill continue the procedure with Step 11. If mas.read6.2 does not succeed inconnecting to the remote system, a message such as the following isdisplayed (in this example the name of the remote system is haro and thename of the local system is delta):

System haro is not available for deltaPossible causes:1) Check “.rhosts” at “haro” for access this system to “haro”2) Is “haro” filled in “/etc/hosts”?3) Is “delta” filled in “haro:/etc/hosts”?4) Is “remsh” the right remote-shell command?5) Use -l option to specify the username on the remote system.

After this message, mas.read6.2 will interrupt the installation. If this happensyou must check the possible causes indicated by mas.read6.2 and restartmas.read6.2 after you have solved the problem.

11 From this point on, the procedure is the same as for loading the softwarelocally. Continue with step 8 in the previous section, “Local software load”.

When all required software has been read from tape you are ready to runinstall6.2 to install the software. Continue with the following section, “Install thesoftware.”

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-7

Install the softwareAfter the software is read from tape using the mas.read6.2 utility, it must beinstalled with the installation script install6.2.

The Sybase RDBMS must already be installed and running on the system asdescribed in Chapter 2 before the BAAN installation can be started.

Take the following steps to install the BAAN software.

1 Log on as user root (do not use the su command) and set the TERM variableto vt100 or any other valid value. Use env to display the UNIX environmentsettings. Be sure that the environment variable USER is not set. To determinewhich values are valid for BAAN, check the subdirectories ofln.0000/bse/lib/terminf under the installation directory. After installation,this directory will be moved to $BSE/lib/terminf.

2 Change directories to the directory where the BAAN files were read by themas.read6.2 script and enter the following command:

# sh install6.2

You can stop the installation script at any point before the final question,“Are you ready for installation?”. To stop the script, press the interruptCTRL+C. The script can be restarted as often as you like. From the script, asubshell can be activated by pressing the ! key (exclamation point). To endthis subshell, type exit at the UNIX prompt. You will return to the script atthe point where you had left.

Never use the tee command to create a log file. The installation script willstart the bshell and if the tee command has been used, no bshell window willappear on the screen. During the installation, the logfile log.install6.2 isgenerated in the directory where the installation was started.

3 After a temporary bse environment is created under the installation directory,you are asked to supply the path to the BSE directory. Be sure to enter thecomplete path. The path must be at least two directories deep, for example,/usr2/bse.

Use a BSE path such as /usr2/BAAN5/bse. If you have multiple installations,a path name such as this allows you to easily see what software belongs toeach environment.

4 You are asked to specify the environment variable BSE_TMP. Supply thepath or accept the displayed default.

NOTE

NOTE

CAUTION

NOTE

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-8

5 You are asked if you want to write the values of the $BSE related variable tothe system-wide profile /etc/profile. You are recommended to write them tothe .profile files of the individual users, instead of to the system-wide profile.So, press N.

6 You are asked to enter the host names of the systems for which a license isrequired. The installation procedure displays the name of the local system asdefault. Supply the host name(s) and press ENTER. Then press ENTER tocontinue.

7 You are asked to specify a database driver for Company 000. Type thenumber corresponding to Sybase in the list of database drivers. PressENTER.

8 You are asked to supply the values of the SYBASE and DSQUERYenvironment variables. These are the names that you created in Chapter 1while preparing for the Sybase installation. In the example installation,SYBASE is the path to the Sybase installation directory and DSQUERY isbaanV.

9 You are asked to specify information for one or more other companies. Enterthe same information as you did for Company 000 or select different databasedrivers and instances for the other companies.

10 A list of drivers selected for each company is displayed. If the displayed listis correct, press ENTER to continue. If the list is not correct, enter the correctinformation.

11 You are asked to supply the path for the directories where the Dictionarytables are to be stored. Type a directory path or press ENTER to accept thedefault path. Press ENTER to continue.

12 You are asked to supply the path for the directories where the dumps of theDemo tables are to be stored. Type a directory path or press ENTER to acceptthe default path. Press ENTER to continue. Press ENTER again to continue.

13 You are asked which VRC of the BaanERP packages you want to include inthe package combination. Select B50 (version), b (Release) for all BaanERPpackages.

14 You are now asked to enter the name of the package combination to becreated. Type the name of the package combination or press ENTER toaccept the default.

For example, if only standard VRCs are available, create a standard packagecombination with the name b50Srelease, for example b50Sa.

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-9

15 You are asked for a description of the package combination. Type thedescription or press ENTER to accept the default.

16 A list of packages that will be installed for the package combination enteredis displayed. Press ENTER to accept.

17 You are asked if you want to run multiple bshells, to speed up the installation.If your system has sufficient CPU power (one bshell per CPU), it isrecommended to answerYES. Press Y and then ENTER. Enter the number ofbeshells. Press ENTER to continue.

18 If the binaries to be installed can accommodate multibyte languages, you areasked questions relating to multibyte. Select multibyte if you want to installlanguages with multibyte character sets such as Arabic, Hebrew, Japanese,Chinese, and Korean. You are asked whether you intend to use multibyte. Ifyou answerYES, you must indicate how the multibyte data must be stored,native or TSS (BAAN Superset). If you answerNO, the system will skip theother questions and ask you if you want to continue.

19 You are now asked if the installation can be started. Press Y, then ENTER tostart the installation.

An error message may be displayed indicating that the preinstallation toolpreinst encountered errors. If so, you must check the displayed log.preinstfile.

20 You are asked if you want to go to the UNIX shell to prepare the Sybaseinstallation for BaanERP. Press ENTER to go to the shell.

21 Type the following command from the UNIX prompt:

bshell6.2> syb_install6.2

22 Supply this information:

S.A Login saS.A Password password for sa loginWant to create initial group? YInitial group baanGroup Passwd password for initial group

(minimum 6 characters)Add group ‘baan’ YDo you want to create a device YWant to see list of devices N

WARNING

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-10

23 At this point you must supply the names of and the path names to the rawdevices you created in Chapter 1. For each device you must supply a uniquedevice number and the size of the device. The size of each device must be thesame as what you specified in Chapter 1. You must not mirror the devices.Specify the following devices:

− baandbs01This is the name of the device to be used to store the BaanERP metainformation. As the path name you must insert the path name of the rawdevice of 100 MB you created in Chapter 1, “Installation preparation.”Note that you must use device number 3.

− baanlog01This is the name of the device to be used to store the BaanERP logginginformation. As the path name you must insert the path name of the rawdevice of 100 MB you created in Chapter 1, “Installation preparation.”

− baandata01This is the name of the device to be used to store the BaanERP data. Asthe path name you must insert the path name of the raw device of 2 GByou created in Chapter 1, “Installation preparation.”

− baanindex01This is the device name of the device to be used to store the BaanERPindexes. As the path name you must insert the path name of the rawdevice of 2 GB you created in Chapter 1, “Installation preparation”.

After you created the devices, you must answerNo on the question if youwant to create a device.

24 After you created the devices, supply the following information:

O.K. to create the database baan YSpecify device for database YDevice Name baandbs01Specify size for database YSize of Part (MB) 100 (same size as physical device)Specify device for database YDevice Name baandata01Specify size for database YSize of Part (MB) 1000 (same size as physical device)Specify device for database YDevice Name baanindex01Specify size for database YSize of Part (MB) 1950 (same size as physical device)Specify device for database NSpecify device for log Y

NOTE

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-11

Device Name baanlog01Specify size for log YSize of Part (MB) 1950 (same size as physical device)Specify device for log NOK to continue? [Y] YDo you want to create segments YSegment Name baandataDevice Name baandata01OK to continue? [Y] YDo you want to create segments YSegment Name baanindexDevice Name baanindex01O.K. To continue YDo you want to create segments NWant to dump database/transaction Y

25 At this point a prompt is displayed. Enter the following commands:

1>use baan (same name as the name of the Initial group entered in step 5)2> go1> dump tran baan with truncate_only2> go1> exit

26 You are returned to the syb_install6.2 script. Enter the followinginformation:

O.K. to create Group File YAdd Baan user ‘root’ YDB User rootDB Password passwordAdd BaanERP user ‘bsp’ YDB User bspDB Password passwordCreate Default Storage Entries Y

The passwords must be six characters at minimum.

27 Use vi to edit the $BSE/lib/sybase/syb_storage. This file must look like theone shown here (in the example, the segments for the BAAN tables andindexes are called baandata and baanindex respectively):

*:*:T:group:001:5:SEGMENT baandata*:*:I::001::SEGMENT baanindex

NOTE

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-12

28 Enter the following commands to enable automatic flushing of the log devicefor the database (in our example database baan):

bshell6.2> isql -U sa -P sa password1> use baan2> go1> create procedure sp_thresholdaction2> @dbname varchar(30),3> @segmentname varchar(30),4> @space_left int,5> @status int6> as7> dump transaction @dbname with truncate_only8> print “LOG DUMP ‘%1!’ for ‘%2!’ dumped”, @segmentname, @dbname9> go1> grant exec on sp_thresholdaction to dbo2> go1> sp_addthreshold baan, “logsegment”, 512, sp_thresholdaction2> go1> exit

29 At this point, syb_install6.2 is complete. Type the following command at theUNIX prompt:

bshell6.2> exit

30 You are returned to the screen you left when you went to the UNIX prompt tostart the syb_install6.2 script. Press ENTER to continue.

31 You are informed that the shared memory for the temporary environment isbeing stopped. At this point, you must install BI or BW to complete theinstallation.. The host name and directory paths will be different for yourinstallation. The following message is displayed:

Installation interrupted: Thu Feb 26 13:12:17 MET 1998You can use BI or BW to continue the installation

When using BI:--------------------------------------------------------------------------------- install BI on your HTTP server- copy the HTML page ‘/usr1/tape/install.html to the BI subdirectory ‘client’- start your internet browser and select page ‘install.html’-------------------------------------------------------------------------------

When using BW:------------------------------------------------------------------------------- install BW on your workstation (from /usr4/Baan/bse/mswindows)- start BW using the following configuration: Hostname: cosmos Connect As: root BSE /usr1/Baan/bse Command: --ottiex1287 /usr1/tape------------------------------------------------------------------------------

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-13

When BI or BW has finished executing, you can continue this installationContinue? (y/n):

32 Do not press Y to continue until you have installed BW.

33 To install BW, you must download the BW binary files to your Windows NTworkstation. First, create a new directory for the BW binary files on yourWindows NT workstation. In the following example, the directory is \temp.

34 Open a DOS command prompt and change to the directory where you wantto place the files:

cd \temp

35 Start ftp with the following command:

ftp hostname

where hostname is the name of the UNIX host system.

36 You are prompted for your user name and password on the host. Log in asUNIX user root.

37 Type the following commands to change to the UNIX directory where theBW files are stored and to find the name of the BW directory:

cd bse/mswindows/BWls

where bse is the complete path to the BSE.

38 Change directories to i386 or alpha, depending on which client you areinstalling.

39 Type the following commands to retrieve the BW binary files in binary modewith the interactive mode turned off for convenience:

binpromptmget *

40 The files will be downloaded to the directory you created for BW. Enter byeto leave ftp and go to Windows Explorer and open this directory. Double-click the file setup. This starts the BW installation program.

41 A Welcome message appears. Click Next.

42 A Licence Agreement message screen appears. Click Yes.

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-14

43 The Select environment dialog box appears.

Click Install new environment if you perform a fresh installation, and entera name for the new installation. If you want to upgrade an existing BWinstallation, you must click Select existing environment to select theexisting environment to be upgraded. Click Next to continue.

44 The Choose Destination Location dialog box is displayed. The layout of thedialog box depends on whether you are installing BW on a PC client or aWindows NT server.

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-15

If you are installing on a PC client, the following dialog box appears:

If you are installing on a Windows NT server, the following dialog boxappears

Accept the default path or click Browse to enter another path. Click Next tocontinue.

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-16

45 The Select Program Folder dialog box is displayed. Select the ProgramFolder to which the BaanERP Windows icons must be added (defaultBaanERP) and click Next.

46 The Setup Information dialog box is displayed. Click Next to continue withthe displayed setup (or click Back to change the displayed setup).

47 When setup is complete, click OK. Start BW by selecting BW from theBaanERP program group. The BW Configuration screen is displayed. Typethe name of the UNIX host computer in the Hostname field. Connect asroot. Type the complete path name to the BSE, the bshell name, and thecommand. Click RUN!

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-17

48 When the installation is complete, switch back to the UNIX window:

Installation interrupted: Thu Feb 26 13:12:17 MET 1998You can use BI or BW to continue the installation

When using BI:------------------------------------------------------------------------------------ install BI on your HTTP server- copy the HTML page ‘/usr1/tape/install.html’ to the BI subdirectory ‘client’- start your internet browser and select page ‘install.html’-----------------------------------------------------------------------------------

When using BW:------------------------------------------------------------------------------------ install BW on your workstation (from /usr4/Baan/bse/mswindows)- start BW using the following configuration: Hostname: cosmos Connect As: root BSE /usr1/Baan/bse Command: --ottiex1287 /usr1/tape----------------------------------------------------------------------------------

When BI or BW has finished executing, you can continue this installationContinue? (y/n):

49 Press Y to continue. You are returned to the bshell prompt.

A patch tape (if present) must be installed after the installation of BaanERP iscompleted. Use the install6.2 script in the directory in which the patch tape isread. Before installing the patch, first read the readme file in the patchdirectory. Refer to the installation manual of the patch tape for more details.

Post-installation tasks

After the installation has finished, you must check the following points:

n The Sybase database is created with the Truncate log on checkpoint optionon. After installation is complete, the DBA must change this option to suit thesite requirements.

n After the installation, the installation directory must be empty. The log filesfor the installation are in $BSE/log. Check these log files, especiallylog.install6.2.

n Make sure the home directories of the standard users are the home directoriescreated during the installation. Modify the .profiles if necessary.

BaanERP installation

Sybase Installation Guide for BaanERP on UNIX

3-18

n It is useful to create an environment settings file in the $BSE directory (usethe file name setbse). This file can be used to set the BAAN environmentvariables any time by giving . ./setbse while you are in the $BSE directory.In this file set the variables for BSE, BSE_TMP, PATH=$BSE/bin:$PATHand TERM (for example =vt100). Do not forget to insert the line exportBSE BSE_TMP PATH TERM. An example setbse file is provided.

BSE=/usr2/bseBSE_TMP=$BSE/tmpPATH=$BSE/bin:$PATHTERM=vt100export BSE BSE_TMP PATH TERM

Sybase Installation Guide for BaanERP on UNIX

4-1

After BaanERP is installed, the demo tables must be created and filled andseveral aspects must be configured. These tasks are performed on the WindowsNT or Windows 95 machine where BW was installed in the previous chapter.This chapter describes the following topics:

n Install the demo tablesn Create tables for the demo modelsn Import the version dumpsn Initialize parametersn Reorganize tablesn Configure shared memoryn Create the audit database and assigning tablesn Validate the systemn Define the default currenciesn Change passwords

In the following descriptions, you must use Convert to Runtime several times.Save the changes before you use the Convert to Runtime option.

4 BaanERP configuration

NOTE

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-2

To install the demo tablesAt this point you must install the demo tables for Company 000 and for the democompany or companies. To install the demo tables, carry out the following:

1 Start BW and log on as bsp. From the Menu browser window, select RunProgram from the File menu.

2 Type ttiex1290m000 in the Program/Session field. Click OK.

3 The Install Demo Tables (ttiex1290m000) screen is displayed. In the Fromfield, enter 000. Click the browse button next to the To field (the triangle tothe right of the field).

4 A screen appears showing information on all the BAAN companies. Click thecompany you want to install tables for and click OK. If you want to installthe demo tables for all companies, click the company with the largestcompany number and click OK. The company number appears in the Tofield of the Install Demo Tables screen.

5 Select the Overwrite Existing Tables check box. Click Install. An hourglasspointer appears.

6 When the cursor once again takes the arrow shape, click Close.

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-3

Create tables for the demo modelsYou must now create tables for each company for which you installed demotables in the previous section. To create these tables, do the following (in thefollowing example, tables are created for company 813 through 900):

1 From the Menu browser window, select Run Program from the File menu.

2 Type ttaad4230m000 in the Program/Session field. Click OK.

3 The Create Tables (ttaad4230m000) window is displayed. Type 813 in theFrom field and 900 in the To field and click Create.

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-4

4 The Select Device window appears. Select the device where you wantmessages to appear. For example, type d in the Device field to have messagesprinted to the screen. Click Continue.

5 When the tables have been created, click Close.

To import the version dumpsNow that the tables have been created for the demo companies, you must importthe version dump for each demo company. To import the version dumps, do thefollowing:

1 Start BW. From the Menu browser window, Select Change Company…from the Options menu. Change to one of the demo companies.

Company 000 is not a demo company, so do not select Company 000.

2 Select Run Program option from the File menu.

3 Type tgbrg1245m000 in the Program/Session field and click OK .

CAUTION

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-5

4 The Import Version Dump (tgbrg1245m000) window is displayed. In theFile field, type the file name for the demo company. Note that you mustselect the Overwrite check box. The following example shows the file namefor demo company 813:

path/test/tgB50_b/813/813/BAANERP-PD.Z

where path is the path of the BAAN directory, for example /usr2/baan.

5 Click Import. The cursor changes to the hour glass-shape while the versiondumps are being imported. A screen will appear asking if you want to importcomponents from BAAN ERP 1. Click Yes.

6 When the import is complete, and there is more than one demo company,repeat Steps 2-5 for each demo company.

7 Click Close on the Import Version Dump (tgbrg1245m000) window.Closing may take several minutes.

Initialize parametersTake the following steps to initialize the parameters:

1 Log on as user bsp and switch to a company other than 000. You can switchto another company by choosing the Change Company option from theOptions menu.

2 Select the Run Program option from the File menu and enter the InitializeParameters (tcmcs0295m000) session.

3 Click Continue.

4 Repeat the steps 2 and 3 for all demo companies except company 000.

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-6

Reorganize tablesTake the following steps to reorganize the tables:

1 Log on as user bsp and switch to a company other than 000. You can switchto another company by choosing the Change Company command from theOptions menu.

2 Select Run Program from the File menu and enter the session codettaad4225m000 (Reorganize tables).

3 Click Reorganize.

4 Repeat the steps 2 and 3 for all demo companies except company 000.

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-7

Configure shared memoryTo improve processing speed, frequently used data objects can be stored inshared memory where all running BAAN processes can access them.

Set up shared memory

To specify which objects are stored in shared memory, do the following:

1 Start BaanERP. From the Menu browser window, select Run Programfrom the File menu. Type ttaad4150m000 in the Program/Session field.Click OK. The Shared Memory Data screen is displayed. From the Groupmenu, select Find.

2 From the Shared Memory Data Type dropdown box, select Program Objects.

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-8

3 From the Specific menu, select Copy Object from DD.

4 The Copy Program Objects (ttaad4252s000) session is started. Enter thefollowing information.

5 The Shared Memory Data (ttaad4150m000) session is redisplayed, this timefilled with data.

6 Repeat Steps 4 and 5 for the programs dsk to dskzzzzzzz and stp tostpzzzzzzz. Click OK in the screen that appears.

7 Select the Convert to Runtime option from the Specific menu.

8 Exit the BaanERP session and logon to the BaanERP server as user root.

9 Enter the following commands to reload shared memory:

# cd $BSE/bin# ./srdd_init6.2 -i

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-9

Create the audit database and assigningtablesBaanERP includes an audit facility that can log all parameter changes. To usethis audit, you must first create an audit database and assign tables to it. To do so,follow these steps:

1 Log on as user bsp.

2 Select the Database Management menu from the Tools main menu.

3 Select the Audit File Directories (ttaad4116m000) session from theDatabase Definitions and Directories menu.

4 Select All (other) tables in the Table Selection field and insert the path namefor the audit directory, $BSE/audit /# (the number sign indicates that foreach company a separate directory is created under $BSE/audit).

5 Select the Convert to Runtime option from the Specific menu and close andrestart the bshell.

6 Log on as user bsp.

7 Select the Database Management menu from the Tools main menu.

8 Select the Tables by Databases (ttaad4111m000) session from the DatabaseDefinitions and Directories menu.

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-10

9 Insert all tables you want to be audited. Note that the database field must befilled with the 001 database. The Table Selection field enables you to specifyindividual tables, all tables within certain modules, and all (other) tables. Youcan insert the mandatory tables by choosing the Load Mandatory Tables forAudit option from the Specific menu.

10 Select the Convert to Runtime option from the Specific menu and close andrestart the bshell.

Validate the systemThis section describes how to validate your BaanERP system. The procedureassumes that the customer and license code are known. So, the Baan Companymust have sent these codes after having received the order form.

Take the following steps to validate the system:

1 Log on as root.

2 Select Software Installation in the BaanERP Tools package.

3 Select the Requested System Configuration (ttiex3101m000) session fromthe Validation folder.

You are asked to supply a password. You must enter the default passwordYi984. Do not give the default password to unauthorized people.

4 Select the New option in the Group menu.

5 Enter the start date in the FromDate field and press TAB. Enter the end dateof your license in the EndDate field and press TAB again to supply theNumber of Seats (that is, the number of concurrent users).

NOTE

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-11

6 To select the supported database (the RDBMS on which the BaanERPinstallation is running), select the corresponding Runable check box. Selectthe Runable check box also for the other licensed parts.

7 Save and exit the session.

8 Select the Print Requested System Configuration (ttiex3400m000) sessionfrom the Validation folder and print your system configuration.

9 Supply the requested information and click Continue.

10 The Select Device session is started. Select a printer and use Continue.

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-12

11 Provide this printout to the Baan Company. This will be used to create thevalidation key. When you receive this key in a printout from the BaanCompany, you can proceed with the validation.

12 Select the Security Code/Validation Key (ttiex3102m000) session in theValidation folder.

13 Fill in the Validation Key (Tools) field and the Validation Key Software(Standard) field. Make sure the Security Key matches the security key onthe Baan printout.

14 Save and exit the session and start the Validate Tools Set (ttiex3220m000)session in the Validation folder. Click Continue. If the validation processsucceeds, the following message is displayed. Click OK.

15 A warning message is displayed. Read the message and click Close.

16 Exit the BaanERP session, and start a command line session on yourBaanERP server by logging on as user root.

17 Check the license daemon by entering the ps –ef | grep licd or licmon6.2 –bcommand. The license daemon is a process with the name licd6.2. Ifnecessary, start the license daemon by entering the $BSE/bin/licd6.2command.

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-13

18 Log out as root and start a new BaanERP session by logging in as bsp.

19 Select the Configure Application (ttiex3225m000) session from theValidation menu.

20 You are asked if you want to start the license daemon, click Yes.

Define the default currenciesTake the following steps to define the default currencies:

1 Log on as user bsp.

2 Select the Application Configuration menu from the Tools main menu.

3 Select the Companies (ttaad1100m000) session from the Companies andPackage Combinations menu.

4 Define the default currency for all companies, for example, USD.

5 Select the Convert to Runtime command from the Specific menu.

Change passwordsTake the following steps to define the default currencies:

1 Log on as user bsp.

2 Select the Database Management menu from the Tools main menu.

3 Select the Change Password for General Table Maintenance(ttadv0144m000) session from the General Table Sessions menu.

4 The current password is blank, so press ENTER. Insert the new password, forexample, baan.

5 Select the User Management menu from the Tools main menu.

6 Select the Developers Data menu.

7 Select the Change Password for Developer Authorizations(ttadv0143m000) session from the Maintenance menu.

8 The current password is blank, so press ENTER. Insert the new password, forexample, baan.

BaanERP configuration

Sybase Installation Guide for BaanERP on UNIX

4-14

Sybase Installation Guide for BaanERP on UNIX

5-1

The DBA module is designed to make the job of the database administrator(DBA) easier. The DBA module provides a graphical user interface that allowsthe DBA to add database groups and database users, and link BaanERP users todatabase users. The DBA module allows you to work with individual userrecords or to perform the same procedures on multiple user records at once.BaanERP users are added in a session outside the DBA module, but sincecreating BaanERP users is a necessary step in creating database users, a briefdescription of that session is included here.

This appendix provides an overview of the DBA module. More information canbe found in the BaanERP online Help.

The following functions are described in this appendix:

n Add a BaanERP usern Add a database groupn Add a database usern Link a BaanERP user to a database usern Link multiple BaanERP users to database usersn Move between the DBA module sessions

In the following sections, the Run Program command from the File menu isused to start the relevant sessions. You can find these sessions in the RDBMSmenu. The RDBMS menu can be found in the Database Management menu inBaanERP Tools.

Add a BaanERP userAnyone who uses BaanERP must be a BaanERP user. A BaanERP user does nothave access to the database until that user is linked to a database user, but thefirst step is to create a BaanERP user. This section provides a brief description ofhow to add a BaanERP user. For more information, refer to the Online Help.

To create a new BaanERP user do the following:

1 Create a UNIX user by using the appropriate system administration utility.

2 In the BaanERP Menu Browser window, select Run Program from the Filemenu.

5 Appendix A: The DBA Module

NOTE

Appendix A: The DBA Module

Sybase Installation Guide for BaanERP on UNIX

5-2

3 In the Program/Session field, type ttaad2500m000 and click OK.

4 The User Data (ttaad2500m000) session is started. Click New or select Newfrom the File menu.

5 The User Data (ttams1100m000) session is started. Fill in the necessary datafor the new user and click Save.

Appendix A: The DBA Module

Sybase Installation Guide for BaanERP on UNIX

5-3

6 Select the Convert Baan Users to Database Users from the Specific menuto activate the user.

To add a database groupAll database users belong to at least one database group. A database group allowsthe DBA to assign a specific set of privileges to multiple users. All members of agroup have the same privileges. Before creating a database user, the databasegroup to which the user will be assigned must already exist.

To create a database group, do the following:

1 In the BaanERP Menu Browser window, select Run Program from the Filemenu.

2 In the Program/Session field, type ttdba0520m000 and click OK.

3 The Database Groups (ttdba0520m000) session is started. Select a databaseby typing the database number in the Database field.

Appendix A: The DBA Module

Sybase Installation Guide for BaanERP on UNIX

5-4

4 Add a new group by clicking the New button or by choosing New from theFile menu.

5 The Database Groups (ttdba0120m000) session is started. To create a newdatabase group, be sure that Using BAAN is selected in the Create Groupfield and type the database group name in the Database Group field. PressTAB or click in the Database Group Password field.

6 The Enter Password dialog box appears. Enter and reenter a password forthe database group. Click OK.

7 The Database Groups (ttdba0120m000) session is redisplayed. Click Save,then click Close.

8 The Enter Database Administrator Password dialog box appears. Type thedatabase administrator name and password and click OK.

9 The Database Groups (ttdba0520m000) session appears again. Click tohighlight the new group name. From the Specific menu, select Create andConvert to Runtime. Click Close.

Add a database userA database user is a user who has access privileges to specified databases storedin the database server. The access privileges are determined by the group towhich the user belongs. Before adding a database user, the database group towhich the user will be assigned must have been created. For more information,refer to the previous section “Add a database group”.

To add a new database user, do the following:

1 In the BaanERP Menu Browser window, select Run Program from the Filemenu.

Appendix A: The DBA Module

Sybase Installation Guide for BaanERP on UNIX

5-5

2 In the Program/Session field, type ttdba0515m000 and click OK.

3 The Database Users (ttdba0515m000) session is started. Select a database bytyping the database number in the Database field.

4 Add a new user by clicking the New button or by choosing New from theFile menu.

5 The Database Users (ttdba0115m000) session is started. To add a databaseuser, do the following:

6 Type the database user name in the Database User field.

Appendix A: The DBA Module

Sybase Installation Guide for BaanERP on UNIX

5-6

7 Make sure that Using BAAN is selected in the Create User field.

8 Type the database group name in the Database Group field or select a groupby clicking the zoom button (the small triangle) to the right of the DatabaseGroup field. Press the TAB key or click in the Database Group Passwordfield.

9 The Enter Password dialog box appears. Enter and reenter a password forthe database group. Click OK.

10 Click Convert Users.

11 The Enter Database Administrator Password dialog box appears. Type thedatabase administrator name and password and click OK.

12 Click Close.

In addition to allowing you to create new database users, the Database Users(ttdba0115m000) session also allows you to change an existing database user’spassword.

From the Database Users (ttdba0115m000) session, you can go directly to theDatabase Groups (ttdba0520m000) session by clicking the browse button (thesmall triangle) to the right of the Database Group field.

Link a BaanERP user to a database userA BaanERP user is a user who has access to BaanERP. A BaanERP user doesnot have access privileges to any part of the database until that user is convertedto a database user. To create a BaanERP user, you can use the BaanERP UserData (ttaad2500m000) session described in a previous section.

To create a link between a BaanERP user and a database user, or to maintain thelinks between existing BaanERP users and database users, use the Links BetweenBAAN Users and Database Users (ttdba0510m000) session.

If the BAAN user has not yet been created, use the User Data (ttaad2500m000)session to create the user. If the database user has not yet been created, use theDatabase User (ttdba0515m000) session.

To link an existing BAAN user to an existing database user, do the following:

1 In the BaanERP Menu Browser window, select Run Program from the Filemenu.

NOTE

Appendix A: The DBA Module

Sybase Installation Guide for BaanERP on UNIX

5-7

2 In the Program/Session field, type ttdba0510m000 and click OK.

3 The Links Between BAAN Users and Database Users (ttdba0510m000)session is started. If you are linking a new BAAN user to a database user, theuser does not appear on this screen because the user is not yet linked. Tocreate a link between the BAAN user and the database user, click the Newbutton or select New from the File menu. To modify an existing link, double-click the link you wish to modify.

4 The Links Between BAAN Users and Database Users (ttdba0110m000)session is started.

Appendix A: The DBA Module

Sybase Installation Guide for BaanERP on UNIX

5-8

5 Select a BaanERP user by typing a BaanERP user name in the BAAN Userfield or by clicking the zoom button (the small triangle) to the right of theBAAN User field.

6 Select the database user to which you want to link the BAAN user by typingthe database user name in the Database User field, or by clicking the zoombutton (the small triangle) to the right of the Database User field.

7 Click OK. The BAAN user is linked to the database user.

In addition to allowing you to link a single BAAN user to a single database userof the same name, the Links Between BAAN Users and Database Users(ttdba0110m000) session allows for additional flexibility. For example, you canuse this session to link many BAAN users to a single database user, or to link aBAAN user with a database user of a different name.

From the Links between BAAN Users and Database Users (ttdba0110m000)session, you can directly go to the User Data (ttaad2500m000) session byclicking the browse button (the small triangle) to the right of the BAAN Userfield. In addition, you can directly go to the Database Users (ttdba0515m000)session by clicking the browse button (the small triangle) to the right of theDatabase User field.

Link multiple BaanERP users to databaseusersIf various new BaanERP users need database access, it is not always convenientto link these users one at a time. The Convert BAAN Users to Database Users(ttdba0915m000) session allows you to convert one or more BAAN users todatabase users without first creating database users. This session automaticallycreates a database user for each BAAN user and links the BAAN user to thedatabase user in one step.

NOTE

NOTE

Appendix A: The DBA Module

Sybase Installation Guide for BaanERP on UNIX

5-9

Once the new BAAN users have been entered by using the User Data(ttaad2500m000) session, you can link individual BAAN users can be linked todatabase users as follows:

1 In the User Data (ttaad2500m000) session, select a single user record or agroup of user records.

2 From the Specific menu, select Convert BAAN Users to Database Users.

3 The Convert BAAN Users to Database Users (ttdba0915m000) session isstarted.

Appendix A: The DBA Module

Sybase Installation Guide for BaanERP on UNIX

5-10

4 Verify that the Database field contains the correct database. If not, click thebrowse button (the small triangle) to the right of the Database field andselect the appropriate database.

5 To convert a single user, enter the name of the BaanERP user in both theFrom and the To subfields of the BAAN User field. To convert a range ofusers, enter the name of the first user you want to convert in the Fromsubfield and the name of the last user you want to convert in the To subfield.If you want to convert every BaanERP user, leave the From subfield blankand type zzzzzzzzzzzz in the To subfield.

6 If you want to make the BAAN user a system user, click the checkbox Usesystem logon for Database User.

7 Click Convert.

8 To ensure that only the DBA modifies the users in the user file, the EnterData Base Administrator Password screen is displayed. Type the DBA nameand password and click OK.

9 A database user is created for each BAAN user and is given the same name asthe BAAN user. The BAAN users are linked to the database users.

10 The User Data (ttaad2500m000) session is started again. Close the sessionwindow.

Move between the DBA module sessionsMany of the DBA module sessions include links to other DBA module sessions.These links are designed to make the DBA’s work more efficient. This sectiondescribes how you can use these links. For a more complete description of eachof the sessions, refer to the previous sections in this Appendix.

If you are creating a new BAAN user who will need to be linked to a databaseuser, you can use the following steps to create a database user and to link theBAAN user to the database user.

1 Create a BaanERP user with the User Data (ttaad2500m000) session.

2 Open the Links between BAAN Users and Database Users (ttdba0510m000)session.

3 Click New. This opens the Links between BAAN Users and Database Users(ttdba0110m000) session.

4 Zoom from the BAAN User field. This starts the User Data (ttaad2500m000)session.

Appendix A: The DBA Module

Sybase Installation Guide for BaanERP on UNIX

5-11

5 Select a BAAN user and click OK. This returns you to the Links betweenBAAN Users and Database Users (ttdba0110m000) session.

6 Zoom from the Database User field. This starts the Database Users(ttdba0115m000) session.

7 The Database User field is filled in with the BAAN user name. Accept thisname or type a new name. Enter the database user password and databasegroup. Click Convert Users, then click Save.

8 If the database user does not exist, you will get an error message. At thispoint you can zoom to the Database Users (ttdba0515m000) session whereyou can create a new database user.

9 When the database user has been created, you return to the Database Users(ttdba0515m000) session. Click Convert Users.

10 A screen is displayed asking for the DBA name and password. Type the nameand password and click OK.

11 You return to the Database Users (ttdba0515m000) session. Click Close.

12 You return to the Links between BAAN users and Database Users(ttdba0510m000) session. Click New and enter the new user name.

13 The Links Between BAAN Users and Database Users (ttdba0510m000)session is started with the new user information inserted in the user fields.Click Save.

14 You return to the Links between BAAN users and Database Users(ttdba0510m000) session. On the Specific menu, select Convert Users toRuntime.

Appendix A: The DBA Module

Sybase Installation Guide for BaanERP on UNIX

5-12