SSA Baan IVc4. Deployment Guide for Unix and Windows

Transcription

1 SSA Baan IVc4 Deployment Guide for Unix and Windows

2 Copyright 2006 Infor Global Technology Solutions GmbH and/or its affiliates and subsidiaries All rights reserved. The word and design marks set forth herein are trademarks and/or registered trademarks of Infor Global Solutions Technology GmbH and/or its affiliates and subsidiaries. All rights reserved. All other trademarks listed herein are the property of their respective owners. Important Notices The material contained in this publication (including any supplementary information) constitutes and contains confidential and proprietary information of Infor Global Solutions. 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 Infor Global Solutions 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 Infor Global Solutions 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 Infor Global Solutions has taken due care to ensure that the material included in this publication is accurate and complete, Infor Global Solutions 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, Infor Global Solutions 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. Trademark Acknowledgements All other company, product, trade or service names referenced may be registered trademarks or trademarks of their respective owners. Publication Information Document code Release Document title : U7949I US : SSA Baan IVc4 Publication date : December 06 : Deployment Guide for Unix and Windows

3 Table of Contents Chapter 1 Installation and deployment procedure for SSA Baan IVc Technical Notes Extensions To install and deploy SSA Baan IVc Chapter 2 Postinstallation Tasks To install the Baan Windows (BW) Client To configure the locale To install the demo tables To create the remaining tables To import the demo models To define the default currencies To reorganize tables To initialize parameters To validate the system To create the audit database and assigning tables To install and configure Baan IVc4 services To configure the Baan Licensing Service To configure the Baan Logic Service services To set up shared memory To configure the Baan Shared Memory service Changing passwords

4 ii Table of Contents Set development parameters and authorizations To set up the Enterprise Modeler To define the run-time resource settings Chapter 3 Language Update on Unix To load the software Language update Chapter 4 Language Update on Windows Chapter 5 Logfiles of the installation Terms and definitions in the following section Client BaanERPClient.log BaanERPClient.info Server BaanERPServer<datetime>.log BaanERPServer.info ExistingIUs.info Installing Porting sets: Installing dump sets REXEC/FTP TMP files Failed installations...5-8

5 iii Table of Contents

6

7 About this Guide This document is a Deployment Guide that outlines how to install and deploy the SSA Baan IVc4 software. The information in this guide is intended for system administrators and installers. To understand this document, you must have elementary knowledge of UNIX or Windows. In addition, understanding the contents is easier if you are familiar with the structure of SSA Baan IV. This document is subdivided into the following chapters: Chapter 1, Installation and deployment procedure for SSA Baan IVc4, describes the installation and deployment procedure for SSA Baan IVc4. Chapter 2, Post installation Procedure, describes the post installation task to run after the complete install of Baan IVc4. Chapter 3, To update an existing SSA Baan IV environment with a language on UNIX, describes the steps you must take to update the SSA Baan IVc4 standard with a language update on a UNIX platform. Chapter 4, To update an existing SSA Baan IV environment with a language on Windows, describes the steps that you must perform to update the Baan IVc4 standard with a language update on a Windows platform. 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 documentation@infor.com. In your , refer to the document number and title. More specific information will enable us to process feedback efficiently.

8 vi About this Guide

9 Chapter 1 Installation and deployment procedure for SSA Baan IVc4 1 The information provided in this chapter is intended for system administrators and installers. This chapter outlines how to install and deploy the SSA Baan IVc4 software. Technical Notes For additional technical information and the latest solutions, refer to the SSA One point Online support Services Web site at the following link: You must check solution number for the latest SSA BaanIVc4 Technical notes.

10 1-2 Installation and deployment procedure for SSA Baan IVc4 Extensions For information on how to install extensions on Windows, refer to the Installation guide for Extensions on Windows (U7101 US). If your installation runs on a UNIX machine, you can consult the following documents: Title Installation Guide for Baan IVc4 Supply Chain Installation Guide for Baan IVc4 Controlling Installation Guide for Baan IVc4 Supply Chain/Controlling Installation Guide for Baan IVc4 Multicurrency Installation Guide for Baan IVc4 Automotive Document ID U7084 US U7085 US U7086 US U7088 US U7385 US These documents provide information about how to set up the extension software. To install and deploy SSA Baan IVc4 To install and deploy SSA Baan IVc4, take the following steps: 1 Install the files on the SSA Baan IVc4 Standard distribution CD-ROM, including the porting set for Windows or the Baan IVc4 Standard distribution CD-ROM, including the porting set for UNIX. Install the software as described in the relevant Installation Guide, depending on your operating system and RDBMS. For more information, see the following table.

11 Installation and deployment procedure for SSA Baan IVc4 1-3 RDBMS Installation guides for UNIX Installation guides for Windows Oracle U7016 US + U7028 US U7051 US Informix U7016 US + U7029 US U7018 US DB2 U7016 US + U7030 US U7181 US MSSQL U7210 US Note: The Installation Guide for SSA Baan IV on UNIX (U7016 US) contains a chapter that describes how to customize the SSA Baan IV software. You must perform these tasks. 2 Complete the postinstallation tasks described in Chapter 2 of this guide. After these tasks are finished you can proceed with step 3. 3 Initialize and set up the Product Maintenance and Control (PMC) tool, as described in Quick Guide Product Maintenance and Control, available on the Service Pack CD-ROM Batch Install (BD ). For additional instructions on how to initialize PMC, refer to the Installation Guide for Baan IVc4 SP 1-21 Batch Install Solution (U9146 US). 4 Install the patches for the new commercial functions for the databases of ORACLE, and DB2 and Linux Operating System. The patches are available under solution number and through the support Web site. Click the following link to retrieve the solution(s): Note: If you run MSSQL, validate under MSSQL7.0 and, if you run DB2, validate under DB2V5 and, if you run Oracle, validate under Oracle8. Linux System Take the following steps, to license the Linux System. Install the solution from the web through PMC. Run correction program ottcorlinux You are now able to activate Porting Set Linux x86 Suse" in the Maintain Requested System Configuration (ttadv0145m000).

12 1-4 Installation and deployment procedure for SSA Baan IVc4 IA64/HP-UX Take the following steps, to license the IA64/HP-UX platform. Install the solution from the web through PMC to license HP- UX11.23 (Itanium). Run correction program ottcoritanium You are now able to activate Porting Set IA64/HP-UX" in the Maintain Requested System Configuration (ttadv0145m000). 5 If you are installing a non-english language version of SSA Baan IVc4, you must install the SSA Baan IVc4 <language> update on top of the standard. For more information about the language update on UNIX, refer to Chapter 3, Language update on UNIX, or Chapter 4, Language update on Windows, depending on your operating system. 6 If you want to use the extension software you must now install and set up this software. Localization B40Lc4cnt0 B40Lc4mcr0 B40Lc4nas0 B40Lc4scc1 B40Lc4sch1 Description Controlling Multi currency Automotive Supply Chain Controlling Supply Chain 7 Install all standard Service Packs by using the Batch Installer as described in the Installation Guide for Baan IVc4 SP1-21 Batch Install Solution (U9146 US). 8 If you have installed a non-english language version of SSA Baan IVc4 with a language code of 5 or higher (all languages apart from English, Dutch, German, or French), you must use the Batch Installer again to install the all Service Packs for <language>.

13 . Installation and deployment procedure for SSA Baan IVc4 1-5

14

15 Chapter 2 Postinstallation Tasks 2 After you install the Baan IVc4 software, you must perform some additional tasks. This chapter describes how to do the following: To install the Baan Windows (BW) Client To configure the locale To install the demo tables. To create the remaining tables To import the demo models. To define the default currencies To reorganize tables To install and configure the Baan IVc4 services. To validate the system. To create the audit database and assigning tables To configure the Enterprise Modeler. To install the Baan Windows (BW) Client Insert the Baan Master Distribution CD-ROM in the client s CD-ROM drive. For more detailed information, refer to the SSA Baan IV / Baan ERP 5.0 / ERP LN 6.1- Installation and Configuration Guide SSA BW (U7434).

16 2-2 Postinstallation Tasks To configure the locale After a fresh installation of Baan IVc4 on Windows, you must configure the locale to avoid printing issues. 1 Log on as user baan. 2 Start the session Create Table from Sequential Dump (ttaad4227m000). 3 Fill the field Directory for Searching table files with information, for example: <media> \server\installableunits\mastercdbaanivc4\tss_dumps 4 Click Form 2

17 Postinstallation Tasks Specify the name for the error file for example: ${BSE}\log\tss.log 6 Click Continue. The table will be created from the sequential dump. To install the demo tables Install the tables of demo companies, which come with the Baan IV installation. Whether to install all demo tables is left to the discretion of the user. However, for best results, you must perform the process from company 000 until the company number that you want to install. Company 000 is not a demo company, but some relevant data for this company must be installed. To install the demo tables, take the following steps: 1 Log on as user baan. 2 Start Baan IVc4. 3 On the Menu Browser, double-click BAAN IV Tools Software Installation Miscellaneous Install Demo Tables to start the Install Demo Tables (ttiex1290m000) session. 4 Insert the appropriate demo company numbers:

18 2-4 Postinstallation Tasks 5 In the From field, enter 000. Click the Company To browse arrow. A screen appears that shows information on all the Baan companies. Click the company for which you want to install tables, and click OK. To install the demo tables for all companies, select the company with the largest company number and click OK. Select the Remove Dumps after Installation and Overwrite Existing Tables check boxes and click Continue. 6 The cursor changes to the hourglass shape while the demo tables are installed. When the cursor once again takes the arrow shape, click Close. To create the remaining tables To create the remaining tables, take the following steps. In this example, the tables for company 550 are created. 1 Log on as user baan. 2 Start the Baan IV Menu Browser. 3 On the File menu, click Run Program. 4 Type ttaad4230m000 in the Program/Session field and click OK. 5 Insert the demo company number 550 in the From: and To: fields. 6 On the Special menu, click Continue:

19 Postinstallation Tasks Click Continue. 8 Repeat Steps 5 through 7 for additional companies. To import the demo models During the Baan IVc4 installation, several dumps of demo models are copied to disk. The following table shows the installed dumps: Type of company Company number Path to dump Standard c Company 550 $BSE\test\tgB40_c4\550\550\tg550.imp.Z Standard c Company 750 $BSE\test\tgB40_c4\750\750\tg750.imp.Z To import the demo models, take the following steps. In this example, the demo models for company 550 are imported: 1 Log on as user baan and start Baan IVc4. 2 On the Menu Browser, on the Options menu, click Change Company to change to company On the menu browser, on the File menu, click Run Program.

20 2-6 Postinstallation Tasks 4 Type tgbrg1245m000 in the Program/Session field and click OK. 5 Type the path, which you can obtain from the previous table, to the relevant dump for the demo models. The following figure provides an example: You must accept the default settings on the other forms. 6 Click Import. 7 Click Yes when asked if you want to add the version. 8 Click Yes when asked if you want to import the components of the version. 9 Click OK in the message box that shows the import is complete. 10 Click Yes when asked if you want to change the current version to the imported version. 11 Repeat Steps 2 through 10 for additional companies. To define the default currencies To define the default currencies, take the following steps: 1 On the Menu Browser, double-click Tools Application Configuration Companies and Package Combinations Companies to start the Companies (ttaad1100m000) session.

21 Postinstallation Tasks Define the default currency for all companies, for example, USD. 3 On the Specific menu, click Convert to Runtime. To reorganize tables To reorganize the parameters, take the following steps: 1 Log on as user baan and switch to a company other than 000. To switch to another company, on the Options menu, click Change Company. 2 Select the Database Management menu from the Baan IV Tools main menu. 3 Select Reorganize Tables from the Miscellaneous menu to start the Reorganize Tables (ttaad4225m000) session and enter a company other than company 000, for which all tables and all packages must be reorganized. In the Reorganize Tables session, select the Data and Indices, Reference Integrity, and Repair Reference Counter check boxes. 4 Repeat Steps 2 and 3 for all demo companies.

22 2-8 Postinstallation Tasks To initialize parameters To initialize the parameters for each imported demo company, take the following steps. 1 Log on as user baan. 2 Start the Baan IV Menu Browser. 3 On the Menu Browser, on the Options menu, click Change Company to change to the relevant company. 4 On the Menu Browser, on the File menu, click Run Program. 5 Type tcmcs0295m000 in the Program/Session field and click OK. 6 On the Special menu, click Continue: 7 Repeat Steps 3 through 6 for all demo companies except company 000.

23 Postinstallation Tasks 2-9 To validate the system This section describes how to validate your Baan IVc4 system. The procedure assumes that you know the customer and license code. Baan sends you these codes after your order form is received. To validate the system, take the following steps: 1 Log on as user baan or bsp. 2 Start the Baan IV Menu Browser. 3 In BAAN IV Tools, click Software Installation: 4 In the Validation folder, click Maintain Requested System Configuration to start the Maintain Requested System Configuration (ttiex3100m000) session. The system asks for a password. 5 Enter the default password Yi984. Note: Do not provide the default password to unauthorized people because inexperienced users can cause serious damage to your system. 6 Enter the start date in the From Date field and press TAB. Note: You must enter the date in the following format: DDMMYY. Do not enter dashes or any other punctuation. 7 Enter the end date of your license in the End Date field and press TAB. 8 Select the Runable check box.

24 2-10 Postinstallation Tasks 9 On the File menu, click Save+Exit. 10 Click Maintain Requested System Configuration (Tools) to start the Maintain Requested System Configuration (Tools) (ttiex3101m000) session. The system asks for a password. 11 Enter the default password Yi Select Group, then Go To. This positions the cursor in the Package field. 13 Press TAB to reposition the cursor. 14 Enter the From Date and press TAB. 15 Enter the End Date. 16 Enter the number of seats (concurrent users) in the Number of Users field: 17 Select the corresponding Runable check box to select the supported database, which is the RDBMS on which the Baan IVc4 installation is running. 18 Select the Runable check boxes for the other licensed parts. 19 On the File menu, click Save+Exit.

25 Postinstallation Tasks Click Print Requested System Configuration in the Validation folder to start the Print Requested System Configuration (ttiex3400m000) session to print your system configuration. The system asks for a password. 21 Enter the default password Yi Supply the requested information. Click Continue. The Select Device session starts: 23 Select a printer in the Device field and click Continue. 24 Send this printout to validation@ssaglobal.com This printout is used to create the validation key. After you received this key, you can proceed with the next validation step.

26 2-12 Postinstallation Tasks 25 Click Maintain Security Code/Validation Key in the Validation folder to start the Maintain Security Code/Validation Key (ttiex3102m000) session. The system asks for a password. 26 Enter the default password Yi Fill in the Validation Key (Tools) field and the Validation Key Software (Standard) field. Make sure the Security Key field matches the security key you received back. 28 On the File menu, click Save+Exit. Warning: On Unix you must now logon as user root before you can proceed with the following step. 29 Click Validate Tools Set in the Validation folder to start the Validate Tools Set (ttiex3220m000) session. On the Special menu, click Continue. If the validation process succeeds, the following message appears: 30 Click OK. A warning message appears. 31 Read the message and, on the File menu, click Save+Exit.

27 Postinstallation Tasks 2-13 Warning: On Unix log off and log on again as user bsp. 32 Click Configure Application in the Validation folder to start the Configure Application (ttiex3225m000) session. The system displays the following alert: 33 Click OK. 34 Click Yes when asked if you want to start the license daemon. 35 Click Continue. 36 Click OK in the Patch Process Ready message box.

28 2-14 Postinstallation Tasks To create the audit database and assigning tables SSA Baan ERP includes an audit facility that can log all parameter changes. To use this audit, you must first create and assign tables to an audit database. Take the following steps: 1 Log on as user bsp or baan. 2 Point to Database Management on the Tools menu. 3 Start the Audit File Directories (ttaad4116m000) session from the Database Definitions and Directories menu. 4 Select All (other) tables in the Table Selection field and insert the path name for the audit directory, $BSE/audit /#, in which the number sign indicates that a separate directory is created for each company under $BSE/audit. 5 Click Convert to Runtime on the Specific menu and close and restart the bshell. 6 Log on as user bsp. 7 Point to the Database Management menu on the Tools main menu. 8 Start the Tables by Databases (ttaad4111m000) session from the Database Definitions and Directories menu. 9 Insert all tables that you want audited. Note that the Database field must be filled with the 001 database. The Table Selection field enables you to specify individual tables, all tables within certain modules, and all other tables. To insert the mandatory tables, you can click Load Mandatory Tables for Audit on the Specific menu.

29 Postinstallation Tasks The Database field must be filled with the 001 database. Click Convert to Runtime on the Specific menu and close and restart the bshell. If you want to authorize user bsp to print the Audit reports, you must logon as user root and use session Audit Authorizations (ttaad4562m000) to specify the authorizations. To install and configure Baan IVc4 services By default, the Baan Logic Service and Baan Shared Memory Service run after the installation. You can stop, start, and configure the Baan IVc4 services with the SSA manager. Note: Baan Licensing and the job daemons are also available, but do not start automatically. The following sections describe how to configure the Baan IVc4 services. To configure the Baan Licensing Service Note: You must never install the Baan Licensing Service before you receive the license from Baan. After you succeed in validating the system, the Baan Licensing Service must be enabled and started automatically. You can stop, start, enable, and disable the Baan Licensing Service. To configure the Baan Licensing Service, take the following steps: 1 Start the SSA manager.

30 2-16 Postinstallation Tasks 2 Right-click the BaanLicensing icon. 3 If the Licensing Service has not been started, on the shortcut menu, click Start Service. 4 The system displays a message that the Licensing Service is started. 5 If the Licensing Service has been started and you want to disable the Licensing Service, click Stop Service. The system displays a message that the Licensing Service has stopped. 6 Click Disable. To configure the Baan Logic Service services The Baan Logic Service is set to start automatically after installation. To configure the protocol in the Baan Logic Service services, take the following steps: 1 Start the SSA manager and open your Server icon. 2 Right-click the BaanLogic Service icon. 3 Click Stop Service. You must stop the Baan Logic Service before you configure the protocol. Baan displays a message that the Logic Service has stopped. 4 Right-click the BaanLogicService icon. 5 Select Properties

31 Postinstallation Tasks 2-17 The Baan Logic Service offers you the following methods to connect to the Baan server: Rexec, which is the standard remote execution protocol. Rexec does not use password encryption. Baan login, which encrypts the Baan password of the users. The BaanLogin protocol is mandatory if you use ASM/OpenWorld. Security Support Provider Interface (SSPI), which is only available on Windows. SSPI makes single-sign-on (SSO) available. You can check the properties of the BECS.bwc file on which protocol is used. Make sure that the protocol types are the same. 6 Click OK. 7 Right-click the BaanLogicService icon. 8 Click Start ServiceThe Baan Logic Service starts. This starts the Baan Logic Service.

32 2-18 Postinstallation Tasks To set up shared memory To set up shared memory, take the following steps: 1 Click Maintain Shared Memory Data to start the Maintain Shared Memory Data (ttaad4150m000) session, as shown in the following figure. 2 On the Group menu, click Go To.

33 Postinstallation Tasks In the Shared Memory Data Type list, click Program Objects. 4 On the Special menu, click Copy Objects from DD.

34 2-20 Postinstallation Tasks 5 Supply the information, as shown in the following figure, and click Continue: 6 Click OK. 7 Repeat Steps 4 through 6 for the programs dsk to dskzzzzzzzzz. 8 Repeat Steps 4 through 6 for the programs stp to stpzzzzzzzzz. 9 From the Special menu, choose Convert to Run Time, as shown in the following figure:

35 Postinstallation Tasks Click OK in the message box that shows that ${BSE}/lib/srdd_tab6.1 was created. You must restart shared memory to put the changes into effect. To configure the Baan Shared Memory service The Baan Shared Memory is set to start automatically after installation. To configure the Baan Shared Memory services, take the following steps: 1 Start the SSA manager, select your Server icon and open the environment icon.. 2 Right-click the BaanSharedMemory baaniv icon. 3 Select Properties.

36 2-22 Postinstallation Tasks The Shared Memory Configuration dialog box appears: You can set the following options: Memory Options Start Address: The start address will be calculated automatically. Maximum size (MB): This field defines the maximum size of shared memory allocated for Baan IVc4 applications. Note that, if the Baan IVc4 applications require less than the size defined in this field, the rest of the reserved shared memory is released as nonshared memory. Load Options Load Shared Memory at Startup: Select this check box to load shared memory at system startup. Load as User: This text box defines the user account that will be used to load shared memory. Accept the default user baan. Diagnostic options:

37 Postinstallation Tasks 2-23 Show All Messages. Show Errors Only. Silent: This option displays no message. You can use the BAAN IVc4 Shared Memory Manager to view the messages. Maintain Shared Memory Timer: Do not enable this option. This option is reserved for future use. 4 Click OK to accept the new shared memory configuration. You return to the SSA manager. 5 Right-click the icon and, on the shortcut menu, click Stop Service and Start Service in succession to start and stop the Baan Shared Memory service. To check these new settings, you can start the Shared Memory Manager. 6 Right-click the BaanSharedMemory Services icon and, select Properties. Check if settings are correct, click OK. Changing passwords Take the following steps to change the default passwords: 1 Log on as user baan. 2 Choose the Database Management menu from the Tools main menu. 3 Choose 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, for example, baan. 5 Choose the User Management menu from the Tools main menu. 6 Choose the Developers Data menu. 7 Choose 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, for example, baan.

38 2-24 Postinstallation Tasks Set development parameters and authorizations In this section, you can find definitions for the development parameters and authorizations. However, the following data serves merely as an example. 1 Log on as user baan. 2 Select the User Management menu from the Baan IV Tools main menu. 3 Select the Developers Data menu. 4 Choose Maintain Development Parameters by User from the Maintenance menu to start the Maintain Development Parameters by User (ttadv0110m000) session. 5 In the Maintain Development Parameters by User session, you can enter the following values in the Commands and Options section for all standard users: Editor Read-Only Command: View. Editor Read/Write Command: View. Use the default values for all other entries. 6 Choose Maintain General Developer Authorizations from the Maintenance menu to start the Maintain General Developer Authorizations (ttadv0142m000) session. Note that you will be asked for a password. 7 On the Edit menu, click insert. Insert the users bsp and tools (or baan in case of windows) to provide these users with authorization for all package VRCs. No other standard user can have this authorization. 8 Choose Maintain Developer Authorizations by Package VRC from the Maintenance menu to start the Maintain Developer Authorizations by Package VRC (ttadv0141m000) session. 9 For all users except baan and tools, enter the authorizations for specific modules or all modules, for the relevant derived-from packages. 10 Choose Change Current Package VRC of User from the Maintenance menu to start the Change Current Package VRC of User (ttadv0140m000) session. 11 For all users, except for user root, choose the relevant package. Select the Only Show Current VRC check box for all users, except for bsp and tools.

39 Postinstallation Tasks 2-25 To set up the Enterprise Modeler This section describes how to configure the Enterprise Modeler, and explains how to: Configure the printer to print the diagrams. Define the run-time resource settings to display the diagrams. To define the run-time resource settings How the editors and the process flow menus of the Enterprise Modeler are displayed depends on the run-time resource settings for the Enterprise Modeler. For example, if a process flow menu does not fit on the monitor, then the resource settings must be modified with the Maintain Run-time Resources (ttdsk3160m000) session. To start this session, in the Enterprise Modeler editor, on the Options menu, click Resource Settings, or open the Miscellaneous menu of the Desktop Management module in Baan IVc4 Tools. You can use this session to define user-specific run-time resource settings for the Enterprise Modeler, such as fonts, colors, sizes of editor components, and default options.

40 2-26 Postinstallation Tasks The run-time resources for the Enterprise Modeler are divided into the following four groups: 1 Organizer resources, which relate to the complete Enterprise Modeler. 2 Organization resources, which relate to the Organization Model Editor. 3 Process resources, which relate to the Business Process Model Editor. 4 Function resources, which relate to the Business Function Model Editor. The default value of the settings can always be restored through the Restore Default option on the Application menu in the Maintain Run-time Resources (ttdsk3160m000) session. One of the most important resource settings for the Enterprise Modeler is the Display Identification field, which is one of the resource settings in the Organizer group. You cannot zoom in this field, but the following combinations have been predefined and can, therefore, be entered in this field: 10 inch 640x inch 800x inch 1024x inch 800x inch 640x inch 800x inch 1024x inch 1280x inch 800x inch 1024x inch 1280x inch 1280x1124 The modified display identification settings become active the next time you start Baan IVc4. To define new display identifications, you must use the Maintain Display Identifications (tgbrg1120m000) session (Enterprise Modeler menu, Master Data, Miscellaneous).

41 Postinstallation Tasks 2-27 Because of this session, the size and resolution of the editor screens in the Enterprise Modeler are set to the type of monitor that is used. Another important resource setting field for the Enterprise Modeler is the Normal Font field, which is also one of the resource setting fields in the Organizer group.

42 2-28 Postinstallation Tasks

43 Chapter 3 Language Update on Unix 3 This chapter describes how to update an existing SSA Baan environment with a language on a UNIX system and describes how to do the following: Load the software. Update the existing environment with a language. Note: You must log on as root and use the rc.stop command in $BSE/etc to stop the SSA Baan IVc4 environment before you start to update the environment. To load the software This section describes how to load the SSA Baan IV software from a local CD-ROM device attached to the UNIX server. Take the following steps: 1 Log on as user root and create the directory in which to load the SSA Baan IV software, for example, /usr2/cdrom. To create this directory, type the following commands: #mkdir /usr2/cdrom #chmod 777 /usr2/cdrom Note: Never load the software into a directory of an existing BSE environment, because this can destroy the existing environment or the installation script might not work.

44 3-2 Language Update on Unix 2 Type the following command to change directories to the directory you created in Step 1: #cd /usr2/cdrom 3 Insert and mount the Portingset installation CD-ROM. 4 Enter the following command at the system prompt to retrieve the installation script from CD-ROM: #cp /cdrom/unix/cd.read6.1 /usr2/cdrom 5 Start the cd.read6.1 utility from the UNIX shell to read the software from the CD-ROM. If you start the cd.read6.1 script from the CD-ROM directly, you can mount the next CD-ROM. Enter the following command: # sh cd.read6.1 A window with help information appears. 6 Read the information and press ENTER to continue. The following menu appears, which asks you which option must be installed: Available options for this cd.read6.1 1) Select Operating System and Packages 2) Select Operating System only 3) Select Packages only 4) Select components for Workstation installation Choice: [1] 7 Choose one of the following options: Press ENTER to choose 1 for a complete installation of the Package VRCs and operating system (full server installation). Press 2 if you want to read the executables for the chosen operating system from the CD-ROM. The cd.read6.1 script skips the steps that describe the VRC and language selection. Press 3 if you want to read the Package VRCs from the CD-ROM. The cd.read6.1 script will skip step 9 and 10. Press 4 if you want to read the workstation software from the CD- ROM. The default is 1 so press ENTER for a complete installation of Package VRCs and the operating system, in other words, a full server installation.

45 Language Update on Unix 3-3 A question appears that asks you where the Porting set CD-ROM is mounted. Mount the CD-ROM with the operating system (Portingsets) Enter the location of the CD-ROM file system: [/cdrom] Next, a menu usually appears that asks you which operating system you want to install. The following message now appears: Warning: No operating system on this CD-ROM, nothing to copy The script continues automatically with the next step. A menu appears that asks you which packages you want to install. 8 Press ENTER if you want to install the displayed packages. Press N followed by ENTER if you want to choose different packages. 9 A menu appears that asks you which languages you want to install. Press ENTER if you want to install the displayed languages. Press N followed by ENTER if you want to choose different languages. A message appears that shows the available amount of disk space. If insufficient disk space is available to read the software, you must create additional disk space. Another option is to choose fewer languages or packages and restart the process. 10 Press ENTER to continue. After all the required software has been read from the CD-ROM you are ready to run Install6.1 to install the software.

46 3-4 Language Update on Unix Language update Note: Before you start the update, notify the SSA One point Online support Services, who can provide you with the latest information about the update. Use the following steps to update the Tools and Application packages: 1 Log on as user root (do not use the su command) and set the TERM variable to vt100 or any other valid value. 2 Change directories to the directory in which the Baan files were read by the cd.read6.1 script and enter the following command: # sh./install6.1 The selection phase of the installation script can be stopped at any time, in other words, before you are asked if you are ready for installation, by pressing an interrupt sequence, for example, CTRL+C. The script can be restarted as often as desired. From the script, to activate a subshell, you can press the exclamation point (!). To end this subshell, type exit at the UNIX prompt. You then return to the script where you left off. CAUTION: Never use the tee command to create a log file. The installation script starts the bshell and, if you used the tee command, no bshell window appears on the screen. During the installation, the Log.install6.1 log file is generated in the directory where you started the installation. After you create a temporary bse environment, you are asked to supply the path to the already installed Baan Software Environment (BSE) directory. 3 Specify the path and be sure to enter the complete path. The default value $BSE/tmp is suggested for the BSE_TMP environment variable. 4 Press ENTER to accept the default and press ENTER to continue. Note 1: The process can prompt you to write the values of the $BSE-related variables to the system-wide profile /etc/profile. Do not write these variables to the system-wide profile. Note 2: The process can prompt you to write the $BSE variables to the profiles of the users. If you do not want to write the variables to the.profile files of the individual users, press ENTER to accept the default answer, which is No.

47 Language Update on Unix 3-5 The following message appears: THIS IS AN UPDATE Do you want to reinstall old components too? (Full Update)? No 5 Type No. If you type Yes, all language components and former installed PMC solutions will be overwritten. This can cause severe problems. 6 Press ENTER. The following message appears: Do you want to run multiple bshells to speed up the installation? No 7 Type No and press ENTER. A warning appears that informs you that you must remove all processes that use shared memory. You must stop the Baan IVc4 environment before you start the Tools package update. If you did not do so, you must use the rc.stop command to stop the environment now. 8 Type Yes and press ENTER to continue. The following message appears: Are you ready for installation? 9 Type Yes and press ENTER. A Check Fixes error message can appear, which indicates that the preinst preinstallation tool encountered errors. If so, check the displayed Log.preinst file. 10 Press ENTER to continue. 11 Return to Chapter 1, Installation and Deployment Procedure for Baan IVc4, in this document and continue with Step 6.

48 3-6 Language Update on Unix

49 Chapter 4 Language Update on Windows 4 This chapter describes how to update an existing SSA Baan IV environment with a language on a Windows system. Note: Before you start the update, notify the SSA One point Online support Services, who can provide you with the latest information about the update. The installation order: You have installed, for example, US English with the new master medium. During this standard installation, you have already chosen the appropriate locale, for example, Brazilian / ISO , for the update language CD- ROM. However, if you want to install a language that requires multibyte, you must already have selected Multibyte in Native Format during the standard install. To install a new language, take the following steps: 1 Log on as user baan. 2 Close all running applications. 3 Insert the Master distribution CD-ROM for Baan IVc4 in the CD-ROM drive. 4 The Welcome screen appears automatically. Click Next. 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.

50 4-2 Language Update on Windows Click Next. The Environment dialog box appears. Choose an existing Baan environment from the list. 5 Click Next. The Select Installable Units dialog box appears: Select the installable unit that you want to use for installation. In this case, select From update CD. 6 Click Next. The question Select update CD installation source or Insert Update CD pops up. Insert the Extension CD-ROM or enter the location where the system can find the extension CD-ROM and continue the installation. 7 The SSA Environment Location dialog box appears. If any choice is allowed to be made, make the choice Local. 8 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 Click Next. The Destination Directory dialog appears. If allowed, fill in the Directory of the Baan environment (also known as the BSE directory). 10 Click Next. The Upgrade Configuration dialog appears:

51 Language Update on Windows Select the required update configuration and click Next. 12 Click Next. The Configuration Files dialog appears. 13 Click Next. The Ready to Install dialog appears. 14 Click Install to start the installation. It is possible that the system displays a Login screen. 15 Fill Username and Password and click Connect. As soon as the installation is completed, the system displays an Information screen that informs you that the installation has been completed. Click Finish to finish. 16 Return to Chapter 1, Installation and deployment procedure, and continue with Step 6.

52

53 Chapter 5 Logfiles of the installation 5 To enable users to trace problems during an installation, log files are created. In these log files, the installable unit logs progress and problems. The SSA Installation Wizard can detect errors through these log files. SSA Global recommends that you do not change or delete these files, unless told to do so, for example, in Release Notes. In general, if an installation fails, the user of the Installation Wizard must check log files to find out why the installation failed. The Installation Wizard contains several inner programs that each logs their information to different locations under different circumstances. This chapter describes where to find the various log files and what to expect. SSA Global recommends that you compare date and time of the logged strings with the time the failure occurred. In many cases, this can help to locate the problem. The Installation Wizard is always started on a Windows Client machine. If the installation must be carried out to a none-windows machine, for example, UNIX, the Client and Server are different. This situation is discussed in the section Client, later in this chapter. The Installation Wizard handles all the issues for the machine on which you start the Installation Wizard.

54 5-2 Logfiles of the installation Terms and definitions in the following section ASM $BSE Baan 3GL Dump set FTP IU Porting set REXEC SLM Staging Area Staging Wizard Application Service Manager Baan Software Environment. The base directory where the SSA Server Software is installed Baan s third generation language. IU of type dumpset, for example, SSA Enterprise Server, SSA ERP LN, and so on. File Transfer Protocol: Used for file handling on a remote computer (UNIX). Installable Unit: Part of the SSA ERP LN software IU of type portingset. SSA ES Porting Set Remote Executing Service: Used to start a remote application on UNIX. SSA License Manager A folder on the Windows client machine that contains all IUs that can be installed with the Installation Wizard A wizard that installs IUs from CD-ROM to a Staging Area Client Depending on the type of the IU, the user can decide to use the Staging Wizard that creates a Staging Area, or run the installation from the IU itself. From the Staging Area, the SSA ERP LN software will be installed. The other option is to skip the Staging Wizard and Staging Area and directly run the installation for one IU. However, most of the IUs must be installed using the Staging Wizard. Only if an IU contains a so called setup.exe file the installation can be started for this specific IU. Note: The section BaanERPClient.log describes all the issues for the machine on which you install the software.

55 Logfiles of the installation 5-3 Using a Staging Area, log files can be found in: <Staging Area>\Logging files\<environment> where <Staging Area> refers to the directory where the Staging Area is located. In the other case, log files can be found in: %TEMP%\BaanERP Setup\<environment> where %TEMP% refers to the directory name of the windows variable TEMP. In the log directories, you can also find the file BaanERPClient.info. The BaanERPClient.info file contains the settings that the installation user has chosen. As soon as the user defines an environment and a destination for the installation, the Installation Wizard will check the system for an existing installation. If the file $BSE/lib/install/BaanERPServer.info is found, the settings are copied from the server to the client to the file BaanERPClient.info. After the copy from the server, all configuration settings are stored in both files BaanERPServer.info and BaanERPClient.info. The BaanERPServer.info file overrules BaanERPClient.info file. The same applies for the BaanERPServer.log, the BaanERPClient.log files and the ExistingIUs.info files. Note: Client files can freely be removed, though SSA Global does not recommend this unless you encounter severe errors that may have to do with settings in BaanERPClient.info. BaanERPClient.log The BaanERPClient.log file is usually the first file to look into if an error occurs. The file contains information about what the Installation Wizard detects and shows the more general error descriptions, if any.

56 5-4 Logfiles of the installation For example: BaanERPClient.log 4/26/2006[13:30:34(UTC-02:00)]:I:bsp: INFO - Detected Platformtype: Windows_NT 4/26/2006[13:39:22(UTC-02:00)]:E:bsp: ERROR - ttbsi : Error opening file C:\Staging Area\InstallableUnits\InstallableUnit_ERP_Installer\Setup_debug\..\..\..\Install ableunits\ow ERP 6_1\\applfiles\bw_import! This time stamp is related to the time on the Client machine. If the time on the Client differs from the time on the Server machines, you must take that time difference into account when you compare time stamps. Better is to synchronize the time setting for both machines before you start the Installation Wizard. See also the following section, Server. BaanERPClient.info The BaanERPClient.info file contains the information about which configuration is used and what the current status of the installation is. In the following table, some of the most important settings are described: Parameter Environment=ibaanerp Location=0 ProductName=BaanERP TmpDir=C:\Staging Area\Logging Files\ibaanerp SupportDir=C:\DOCUME~1\pleers ni\locals~1\temp\{3c5a8c2f- AD B78B- 0488FBE8E1BC}\ Hostname=CNL09834 User=bsp SuperUser= BsePath=c:\ibaanerp Description Environment for installation Local Windows machine Product name Directory for this info file and log-file Temporary installation directory of User Hostname where to install Installation User Super user (only Unix) $Bse (path where the software will be installed

57 Logfiles of the installation 5-5 PlatformType=Windows_NT BseRel=6.2 PreReger=0 DbType=msql7 BaanMAS=1 InstallStatus=4000 IUStatus= PortingSetInstalled=1 ApplSetInstalled=1 BCLMLogin. ASMLogin.. GenParams.szSelectedKeys=,ERP_To ols, ERP_Applications szvrcs[0][0].szbasevrc=7.6_a_tt szvrcs[0][0].szupdatevrcs= 7.6_a Platform type 6.1 for Baan IV; 6.2 for BaanERP5.0, BaanERP5.2 or ERP LN for BaanERP5.2 or ERP LN 6.1; 1 for Baan IV or BaanERP5.0 Database type: SQL server 0 for AS; 1 for MAS installation 0 for new; 4000 for finished; 0<InstallStatus<4000 for a failed installation IU key where the installation was crashed 1: a porting set was installed before 1: tools was installed before Settings for a SLM installation Settings for a ASM installation List with selected IUs to install List with base VRCs to install solutions for List with update VRCs to install solutions for Server All log and info files on the server can be found in the directory tree where the SSA ERP is installed. Further on in this section the name of the top level of this directory tree is mentioned as $BSE. For installations done to a Windows machine all directory forward (/) slashes must of course be read as backward (\) slashes. At the moment the Installation Wizard supports fresh installations as well as updates for SSA ERP LN 6.1. For Baan IV and Baan ERP 5.0 only updates are supported for the Adapter for ERP. Porting set updates are supported for Baan IV and Baan ERP 5.0 on Windows. The update for Baan IV and Baan ERP 5.0 differs slightly from the Baan ERP 5.2 and SSA ERP LN 6.1 updates. Important to note is the missing

58 5-6 Logfiles of the installation BaanERPServer.info file, as mentioned earlier in the Client section, in the previous versions. However, as soon as an update is done with the Installation Wizard, the BaanERPServer.info file will also exist for Baan IV and Baan ERP 5.0 versions. The same applies to the file ExistingIUs.info, which contains information about what Installable Units have been installed before, and all subdirectories of $BSE\lib\install. These files may not be removed in Baan ERP 5.2 releases and later, but can freely be removed in Baan IV and Baan ERP 5.0 in case unexpected errors occur. Warning: Do not remove the directory $BSE\lib\install or one of the other files! Next updates will fail in case files are missing. BaanERPServer<datetime>.log The BaanERPServer<datetime>.log can be found in the following directory: $BSE/lib/install The BaanERPServer<datetime>.log file contains all logging as described in the section Client. In contrary with BaanERPClient.log the BaanERPServer<datetime>.log has been split up into log files indicating the dates and times that the setup was started. After every update or restart a new BaanERPServer.log is added. This file will only appear when the Installation Wizard has finished. The BaanERPClient.log on the client is a merge of all these files. All info found on the Client machine can also be found on the server. This directory serves as a backup if the files on the Client machine are deleted or if, for instance, the installation is restarted from another Client machine. For the info files the files in this directory are leading. BaanERPServer.info This file can be found in the following directory: $BSE/lib/Install See for a description the section Client mentioned earlier in this Appendix.

59 Logfiles of the installation 5-7 ExistingIUs.info The ExistingIUs.info file contains information about what Installable Units have been installed before. The file is located in: $BSE\lib\install An example of the ExistingIUs.info file: ExistingIus.info ERP_RuntimeTools_WINDOWS OW_ERP_Adapter ERP_Applications ERP_Tools This file is also written to the client in the directory: <Staging Area>\Logging files\<environment> But, the ExistingIUs.info file on the server is always leading. Installing Porting sets: During the installation of a porting set a folder is created/updated named: $BSE/lib/install/vm This virtual machine (VM) folder contains a part of the virtual machine, necessary for the installation of the porting set. During the installation of the porting set logging is done in the subdirectory log. Installing dump sets During installation of dump sets, DEM models, demo companies, and so on, calls are made to Baan 3GL functions. These functions usually log their information in the following directory: $BSE/log Depending on the date and time that these log files are created/updated, you can find out where an error has occurred. If the installation fails during the import, the main log file created by the import is named log.ottiex1287.

60 5-8 Logfiles of the installation REXEC/FTP During the installation, remote commands or ftp calls are often executed. If an error occurs during such an action, the Windows Event Viewer (application) will show the reason of this error. TMP files Temporary files are created during an installation. If the installation fails, these temporary files are not always removed. Sometimes they can contain some more information about the crash. You can remove the files from one of the following directories: $BSE/lib/install/vm/tmp $BSE/tmp Failed installations If an installation fails, the installer must check the log-files and try to solve the problem. If the problem was found and solved, the installation can be restarted. The dialogs to select the Installable Units appear with the previously selected installable units, except for the ones that were already successfully installed. Here, the user can add or remove Installable Units to select. After the user clicks Next in the Destination Directory dialog box, the installation program discovers that a failure has occurred during the previous installation (check the InstallStatus in the BaanERPClient.info file).

61 Logfiles of the installation 5-9 If so, the following dialog box appears: Explanation of the options: Restart Current: Select this option if you want to remove old installation settings and start the installation of the currently selected installable units all over again.* Restart Previous Select this option if you want to remove old installation settings and start the installation of the previously selected installable units all over again.* Retry Select this option if you want to continue with the installation at the point where it crashed. This is faster, but less secure than the other options. This option always continues with the previous selection. Abort Select this option to cancel the installation. * In BaanERPServer.info: InstallStatus, IUstatus, SelectedKeys, PaccCheckSum and PaccSel are reset, for example, InstallStatus is set to The $BSE/temp directory will also be emptied.