enfsuite64_admin_database.pdf

Enfinity Suite 6.4 Database Setup Guide This document covers the feature set delivered with Enfinity Suite 6.4. The information contained in this document is subject to change without notice at any time. These materials are subject to change without notice. These materials are provided by Intershop Communications AG and its affiliated companies (“Intershop Group”) for informational purposes only, without representation or warranty of any kind, and Intershop Group shall not be liable for errors or omissions with respect to the materials. The only warranties for Intershop Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. This document and all of its parts are protected by copyright. All rights, including those of duplication, reproduction, translation, microfilming, storage on electronic media and processing in electronic form are expressly reserved. Intershop® and Enfinity™ are trademarks or registered trademarks of Intershop Communications. All other company, product and brand names are trademarks or registered trademarks of their respective owners. Copyright ©2005-2010 Intershop Communications. All Rights Reserved. 2010-01-31 Document ID: EMS-LIB-64-51-01 Table of Contents Chapter 1 – Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Before You Start. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Verify Content of Installation DVD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 7 7 7 9 9 9 Chapter 2 – Database Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Installing the Oracle Database Software . . . . . . . . . . . . . . . . . . . . . . . . 13 Linux x86-64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Solaris SPARC 64-Bit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Solaris x86_64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Windows (x64) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Creating an Enfinity Suite 6 Database . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Database Setup Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Testing the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Log On as Sysdba. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Check Character Set Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Check Database Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Stop and Restart the Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Perform Project-Specific Database Adjustments . . . . . . . . . . . . . . . . 29 Preparing the Database for Data Replication . . . . . . . . . . . . . . . . . . . . . 29 Local Data Replication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Remote Data Replication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Manual Update of Network Configuration Files . . . . . . . . . . . . . . . . . . . 33 Manual Database Creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Create New Instance Manually Using Scripts . . . . . . . . . . . . . . . . . . . 34 Prepare Existing Instance for Enfinity Suite 6 . . . . . . . . . . . . . . . . . . . 37 CHAPTER 1 Introduction . . directories. init(). attribute names. Chapter 1: Introduction Page 7 . Sun Solaris and Microsoft Windows. the # sign refers to the number of an Enfinity Suite 6 instance.4 on SUSE Linux Enterprise Server. Reserved or Special Words Names of files. Example code. Typographical Conventions The following typographical conventions are used throughout the guide: ■ Cross-references References to other parts of this guide and to other documentation appear in italics. ■ ■ This guide uses the <Placeholder_Name> syntax to denote the Enfinity Suite 6 installation directory (<IS.SHARE>) as well as various other directory. Installing the Oracle Database Software.About this Guide Typographical Conventions About this Guide This guide explains how to set up an Oracle 10g or 11g database for Enfinity Suite 6. IDs etc. Commands All commands to be typed at command prompts appear in Courier font. Installing the Oracle software and configuring a database includes the following steps.DIR>). 13 This section specifies the required software packages to be installed for all supported operation environments. NOTE: Intershop recommends to install the database server on dedicated host(s).4 application servers communicate with the Oracle database. through which the Enfinity Suite 6. for example.INSTANCE. where each step is covered in a separate section of this guide: 1. you have to install and configure an Oracle database for Enfinity Suite 6. group and user names. whereas a database client is to be installed on every Enfinity Suite 6 application server host. the location of the Shared File System (<IS. and points to the corresponding Oracle documentation. The guide also mentions the installation of the Oracle client. methods and database table names appear in Courier.INSTANCE. Chapter Overview Before installing Enfinity Suite 6. In addition. or cartridges appear in italics. See the Enfinity Suite 6 Installation Guide for your operating system for a complete list of placeholders. on p. Red Hat Enterprise Linux. on p. redo log files. this chapter uses the term “database” to refer both to the files that hold the data and to the processes and memory structures that operate on top. NOTE: To simplify the discussion. The section also provides hints regarding manual execution of tasks performed by the database setup. In addition to the installation sequence. Note that technically. Creating an Enfinity Suite 6 Database. 18 This task is performed using the Enfinity Suite 6 Suite database setup.Chapter Overview About this Guide 2. the term “database” refers to the physical collection of files which make up the database (such as data files. whereas “instance” refers to the processes (and the respective memory structures) operating on the database. Using the Oracle server software. the Enfinity Suite 6 database setup program creates a database and an instance operating on this database. this section describes tests to make sure the database instance is working properly before proceeding with the installation. Page 8 Chapter 1: Introduction . and control files). as well as a discussion of special settings necessary to prepare a database for local and remote data replication scenarios. 4.0.xml -mode verify -basedir / mnt/iso -exclude checksum. contact INTERSHOP to get help. Intershop therefore recommends to use Oracle 10gR2 (10. contact Intershop to make sure that these patches do not interfere with Enfinity Suite 6. To verify the checksum: 1. the newest available Oracle 11g version for Microsoft Windows was 11.7. service levels and for additional software and hardware requirements.xml.2.class If the test fails.1.2.1. The patch level mentioned is the most recent patch available at the time of the release. Run the following Java command (all on a single line).Before You Start System Requirements Before You Start System Requirements Enfinity Suite 6. 3. java -cp . The DVD should be mounted automatically to a mount point (<mount_point>) such as /media/cdrom or /media/dvd. Chapter 1: Introduction Page 9 .pdf in the /docs/pdf directory on the installation DVD for details on supported operating systems.0. NOTE: At the date of editing this guide.xml on the DVD) against the content of the installation DVD.0) on Windows platforms. Navigate to the root of the Enfinity Suite 6 installation DVD.0) or 11gR2 (11. If you need to use higher patch levels. Verify Content of Installation DVD To check the content of the Enfinity Suite 6 installation DVD.Checksum.2.4 requires Oracle 10gR2 (10.0. you can verify a checksum (contained in file checksum. 2. Checksum -checksumfile checksum.0. Insert the installation DVD into your DVD-ROM drive.0.4. See the document system_requirements.0). . CHAPTER 2 Database Setup . . password in <IS. located in the /install sub directory of the Oracle installation package.jdbc. When installing the Oracle database software.ini file. Enfinity Suite 6 uses <IS. For the Oracle 10gR2 and 11gR2 Database Client. which can be found on the Oracle CD and on the Oracle Web site. For installation options and details on individual installation steps. Note that these files will not be used by Enfinity Suite 6. • • The client setup process includes the installation of network configuration files (<ora_home>/network/admin/*. set NLS_ENABLED = FALSE in the oraparam. you must either • • • adjust the key intershop.*).SHARE>/system/config/oracle/*. To disable the installation session translation. the Oracle Universal Installer runs in the operating environment’s native language. However. perform a “Software Only” installation. The minimum required database editions are “Standard Edition” or “Standard Edition One”.SHARE>/ system/config/cluster/orm. Chapter 2: Database Setup Page 13 . perform a custom installation.* via setting the TNS_ADMIN environment variable. selecting the following components: • • • • Oracle Database Utilities SQL*Plus Oracle JDBC/THIN Interfaces Oracle Net • • • On Linux/Solaris: Due to a public Oracle defect. you must manually adjust file permissions after installing the Oracle 10gR2 Database Client executing (as root) chmod -R 755 <oracle_home> The following sections specify the required software packages for the supported operation environments. For newly created Oracle 11gR2 databases.INSTANCE. As the database sessions of the Enfinity Suite 6 application servers ignore these settings by default. it is recommended to install the network configuration files as this makes it possible to test immediately whether the client can connect to the database. This means that each client session is served by a dedicated server process (or thread). the passwords are case sensitive by default.ora file. Enfinity Suite 6 communicates with the Oracle database in the “dedicated server mode”.INSTANCE. be aware of the following issues: • By default. refer to the respective Oracle documentation. For the Oracle 10gR2 and 11gR2 Database Server.Installing the Oracle Database Software Installing the Oracle Database Software The installation of the Oracle database software is not part of the Intershop database setup program but is performed by the Oracle Universal Installer.properties. or set sec_case_sensitive_logon=false in your database’s init. launch the Oracle Universal Installer as oracle using . The corresponding documentation includes • • Oracle® Database Quick Installation Guide 10g Release 2 (10.2) for Linux x86-64. and p6810189_10204_Linux-x86-64.zip for the server.x64_11gR2_database_1of2. September 2005. Part Number E10860-04.x64_11gR2_database_2of2. NOTE: When installing Oracle 10gR2 on SLES 10. and linux. Page 14 Chapter 2: Database Setup . November 2009.x64_11gR2_client.zip as required patch set for both server and client. ■ Oracle 10gR2 The packages to be installed are • • • 10201_database_linux_x86_64. ■ Oracle 11gR2 The packages to be installed are • • linux.Linux x86-64 Installing the Oracle Database Software Linux x86-64 The supported Linux platforms include the 64bit versions of SUSE Linux Enterprise Server 10 (SLES 10) and Red Hat Enterprise Linux 5 (RHEL 5). May 2008 Oracle® Database Client Quick Installation Guide 10g Release 2 (10. The corresponding documentation includes • • Oracle® Database Quick Installation Guide 11g Release 2 (11.zip for the client.zip and linux. Part Number E10861-03.cpio.2) for Linux x86-64. The Oracle software to be installed is the same for both SLES 10 and RHEL 5.gz for the client.gz for the server. Part Number B15670-01. November 2009 Oracle® Database Client Quick Installation Guide 11g Release 2 (11./runInstaller -ignoreSysPrereqs.2) for Linux x86-64. Part Number B15668-02.2) for Linux x86-64.cpio. 10201_client_linux_x86_64. cpio.zip and solaris.Installing the Oracle Database Software Solaris SPARC 64-Bit Solaris SPARC 64-Bit ■ Oracle 10gR2 The packages to be installed are • • • 10gr2_db_sol.sparc64_11gR2_client.gz for the server. The corresponding documentation includes • Oracle® Database Quick Installation Guide 10g Release 2 (10.gz for the client. • Chapter 2: Database Setup Page 15 . • ■ Oracle 11gR2 The packages to be installed are • • solaris. 10gr2_client_sol.2) for Solaris Operating System (SPARC 64-Bit). Part Number E10864-01.sparc64_11gR2_database_2of2.zip as required patch set for both server and client. November 2009 Oracle® Database Client Quick Installation Guide 11g Release 2 (11. November 2005.2) for Solaris Operating System (SPARC 64-Bit). Part Number B28053-01. and solaris.2) for Solaris Operating System (SPARC 64-Bit). The corresponding documentation includes • Oracle® Database Quick Installation Guide 11g Release 2 (11.cpio.zip for the client. February 2006 Oracle® Database Client Quick Installation Guide 10g Release 2 (10. Part Number E10863-01.2) for Solaris Operating System (SPARC 64-Bit). and p6810189_10204_Solaris-64. Part Number B15693-02.sparc64_11gR2_database_1of2. November 2009.zip for the server. zip for the client.zip for the server.2) for Solaris Operating System (x86-64).x64_11gR2_database_2of2. November 2009. Part Number B15707-01. February 2006 Oracle® Database Client Quick Installation Guide 10g Release 2 (10. November 2009 Oracle® Database Client Quick Installation Guide 11g Release 2 (11.zip for the server.2) for Solaris Operating System (x86-64). The corresponding documentation includes • Oracle® Database Quick Installation Guide 10g Release 2 (10. • Page 16 Chapter 2: Database Setup . Part Number E16362-01. • ■ Oracle 11gR2 The packages to be installed are • • solaris.zip for the client. The corresponding documentation includes • Oracle® Database Quick Installation Guide 11g Release 2 (11. and solaris.x64_11gR2_database_1of2. 10201_client_solx86_64.2) for Solaris Operating System (x86-64).zip and solaris. and p6810189_10204_Solaris86-64.x64_11gR2_client. Part Number B15705-01.Solaris x86_64 Installing the Oracle Database Software Solaris x86_64 ■ Oracle 10gR2 The packages to be installed are • • • 10201_database_solx86_64.zip as required patch set for both server and client. Part Number E16363-01.2) for Solaris Operating System (x86-64). February 2006. Installing the Oracle Database Software Windows (x64) Windows (x64) NOTE: At the date of editing this guide.0. and 10204_vista_w2k8_x64_production_client.zip for the server.0.0) for Microsoft Windows (x64) and includes the following packages: • • • 102010_win64_x64_database.4.zip for the server.7.1.2.0.0. The corresponding documentation for both installations is the Oracle® Database Quick Installation Guide 10g Release 2 (10. and p6810189_10204_MSWIN-x86-64. 102010_win64_x64_client.0) for Microsoft Windows Vista x64 and Microsoft Windows Server 2008 x64 and includes the following packages: • • 10204_vista_w2k8_x64_production_db.1.zip for the client. ■ Oracle 10gR2 for Windows Server 2008 The software to be installed is Oracle Database 10g Release 2 (10. ■ Oracle 10gR2 for Windows Server 2003 The software to be installed is Oracle Database 10g Release 2 (10.4. the newest available Oracle 11g version for Microsoft Windows was 11. Intershop therefore recommends to use Oracle 10gR2 (10.zip for the client.0) on Windows platforms.0. Part Number B15682-04. Chapter 2: Database Setup Page 17 .2) for Microsoft Windows (x64).2.2.zip as required patch set for both server and client. January 2009. Prerequisites Before creating an Intershop database instance. IS_INDX. log on as root. Database Setup Process To create a database for Enfinity Suite 6. The Oracle database server software must already be installed. then run # .ora file) to work with this database. Page 18 Chapter 2: Database Setup . such as IS_TEMP. The machine must have at least 2 GB of disk space. proceed as follows: 1. As already mentioned in section Installing the Oracle Database Software. execute the setup. On Linux/Solaris. and also involves creating appropriate parameter files (such as an init. ensure that the target machine meets the necessary system requirements. Use the executable or script located on the installation CD in /setup/database. and IS_INDX_CTX. • • On Windows. 13. • • On Windows.exe. creating the database includes (among other things) creating special tablespaces and associated data files required by Enfinity Suite 6. Log on. on p. the term “database” is used slightly simplified in this guide to refer both to the database (a collection of files) and the instance operating on the database. Hence. 2. launch the setup wizard. On the Enfinity Suite 6 Installation CD (Server CD).Prerequisites Creating an Enfinity Suite 6 Database Creating an Enfinity Suite 6 Database This section describes how to create a database for Enfinity Suite 6 using the Enfinity Suite 6 database setup program./install. export the DISPLAY variable to your X client. log on as administrator or as user with administrative rights. IS_USERS.sh -gui This opens the Welcome Page (Figure 1). On Linux/Solaris. The Oracle home directory (<ora_home>) is the home for Oracle software users and has been set during database server software installation. To use text mode. • • Linux/Solaris only: Provide oracle as dba user and oinstall as dba group. log files.Creating an Enfinity Suite 6 Database Database Setup Process Figure 1: Welcome page Click Next to continue. • • The Oracle base directory (<ora_base>) is the root directory for Oracle software components. you can run the Enfinity Suite 6 database setup in text mode. templates. Provide settings for Oracle dba user and group (Linux/Solaris only) and for home and installation directories. instead of using the GUI mode. start the installation with . NOTE: The name of the installation directory must not contain any whitespace characters. 3.sh -text. and other resources./install. It includes the Oracle home directories for all installed Oracle product components. Chapter 2: Database Setup Page 19 . The installation directory <ora_install> is used to unpack scripts. NOTE: On Linux/Solaris. DOMAIN>) is drawn from the sqlnet.ora file (NAMES. you should check the listener.DEFAULT_DOMAIN). Provide settings for database host and service.HOSTNAME>) is obtained from the local host where the setup program is executed. you have to provide it when installing the Oracle client and when configuring the database connection during Enfinity Suite 6 setup. • • • The Database Service Name (<DB. If you set a different port number. 4. The Database Listener is a server-based process that provides basic network connectivity for clients and external processes. The Database Hostname (<SYSTEM.NAME>) defines the name under which the database is known to a domain. The standard port is 1521.ora in the <ora_home>/ network/admin to make sure to use the same port. Page 20 Chapter 2: Database Setup .DB. • The System Identifier (SID) [<DB. It has been set by the Net Configuration Assistant and cannot be modified in the panel.Database Setup Process Creating an Enfinity Suite 6 Database Figure 2: System Parameters Click Next to continue. The Database Domain name (<DB. The SID must not consist of more than eight (alphanumeric) characters.SID>] is a non-ambiguous term for a specific database instance. • NOTE: In addition. Click Next to continue. Select User/Schema Structure. The additional settings are described in detail in Preparing the Database for Data Replication. This option is assumed in the remainder of this section. The database setup program provides two options: • Single Database Account This creates a single database user/schema and is suitable for a single machine installation. on p. Two User Accounts This option provides additional panels to support advanced deployment scenarios.Creating an Enfinity Suite 6 Database Database Setup Process Figure 3: Database Parameters CAUTION: Database service name and SID must be unique on the database server. Figure 4: User Account Creation • Chapter 2: Database Setup Page 21 . 29. 5. The settings provide the values for the system parameters <IS. Enter user name and password. for information of manual execution of these tasks in case you deselect a check box. 34. Specify Net configuration settings. on p. Figure 5: User Account Details Click Next to continue. 7. Page 22 Chapter 2: Database Setup .Database Setup Process Creating an Enfinity Suite 6 Database Select “Single database account” and click Next to continue. on p.CONNECTION. 29 for additional settings necessary when creating two users/schemes. 6. See Preparing the Database for Data Replication.CONNECTION.AS.PASSWD>. 33. and Manual Database Creation.USER> and <IS. See Manual Update of Network Configuration Files.DB. On this panel. on p.AS.DB. you can choose to update Oracle network configuration files and execute SQL scripts immediately after generation It is recommended to have both tasks executed automatically unless otherwise forced. NOTE: The following description continues with “Single Database Account”. Define location of installation components. redo log files. Chapter 2: Database Setup Page 23 . etc. click Next to continue with Step 10. 8. With the settings assumed so far (for Windows). 24. Figure 7: Overwrite existing network configuration 9.) are written into a single directory <ora_base>/<sid>/oradata. control files. The database setup program provides two options: • Default Locations This means that all database files (data files. the location for the database files would be D:\oracle\isorcl1\oradata If you accept the default location. Overwrite existing network configuration files. on p.Creating an Enfinity Suite 6 Database Database Setup Process Figure 6: Net/SQL Options Select both checkboxes and click Next to continue. for example. AMERICAN or GERMAN.Select the language. 24.Database Setup Process Creating an Enfinity Suite 6 Database • Locations for Custom Installations If you want to define custom locations. Figure 8: Specify OFA settings Click Next to continue. Possible values are. This setting provides the default for Oracle Text. Page 24 Chapter 2: Database Setup . Figure 9: Specify NLS settings Click Next to continue. you are first presented with panels to define the locations before proceeding with Step 10. on p. 10. the setup program starts the Oracle listener.Creating an Enfinity Suite 6 Database Database Setup Process 11. During the installation. If this fails. Successful installation is confirmed by the summary panel as shown in Figure 11.Verify all settings and click Start to start the installation process. Chapter 2: Database Setup Page 25 . Figure 10: Verify setup settings Click Start to continue. Figure 11: Installation summary Note that at the end of the setup process. a panel is displayed providing information on the component currently installed and the overall installation progress. an according note is displayed in the summary panel. you may check the listener. All rights reserved. Testing the Database After creating the Enfinity Suite 6 database instance.SID>) ) In addition. 2005.%PATH% D:\oracle>sqlplus "sys/intershop as sysdba" SQL*Plus: Release 10.Testing the Database Creating an Enfinity Suite 6 Database In this case.0\db_1 D:\oracle>set PATH=%ORACLE_HOME%\bin. D:\oracle>set ORACLE_SID=ISORCL1 D:\oracle>set ORACLE_HOME=D:\oracle\product\10.4. Log On as Sysdba The command sqlplus "sys/intershop as sysdba" will open the SQL*Plus prompt and log on as sysdba.0.NAME>) (ORACLE_HOME = <ora_home>) (SID_NAME = <DB.2.2.0.2. Page 26 Chapter 2: Database Setup . check the listener configuration file listener. For more details on testing the database. On Windows Open a command prompt. Connected to: Oracle Database 10g Release 10.Production SQL> You can leave SQL*Plus with the command exit.4. located in <ora_home>/network/admin: • for a corresponding address entry in the LISTENER section (ADDRESS = (PROTOCOL = TCP)(HOST = <db_host>)(PORT = 1521)) • and for a corresponding SID entry in the SID_LIST_LISTENER section (SID_DESC = (GLOBAL_DBNAME = <DB.Production on Mon Jul 25 08:42:30 2005 Copyright (c) 1982.0 . on p. Oracle. 26. change to the <ora_base> directory (D:\oracle in the example below) and proceed as follows: NOTE: Make sure to adjust settings for ORACLE_HOME and ORACLE_SID to your installation.log for possible errors.ora. perform the following tests to make sure that the Oracle database is working properly.0 . refer to Testing the Database. PARAMETER VALUE -----------------------------------NLS_CHARACTERSET AL32UTF8 The character set must be set to AL32UTF8. Oracle.2.2.0 .0/db_1 PATH=$PATH:$ORACLE_HOME/bin NOTE: For details about further Oracle Database and operating system environment variables. Check Character Set Settings Log on as sysdba (see Log On as Sysdba.0.4. 2008. switch to user oracle and proceed as follows: $ sqlplus "sys/intershop as sysdba" SQL*Plus: Release 10.Production SQL> You can leave SQL*Plus with the command exit. All rights reserved.Production on Fri Jul 25 10:35:25 2008 Copyright (c) 1982. Once the settings have been adjusted. ORACLE_HOME. Connected to: Oracle Database 10g Release 10. 26) and issue the following statement: SQL> select * from v$nls_parameters where parameter like '%CHARACTERSET%'. Chapter 2: Database Setup Page 27 . refer to the corresponding Oracle® Database Administrator’s Reference. ORACLE_SID and PATH for the user oracle.4.2. on p.0 .Creating an Enfinity Suite 6 Database Testing the Database On Linux/Solaris Adjust the settings for ORACLE_BASE.0. for example: ORACLE_SID=ISORCL1 ORACLE_BASE=/opt/oracle ORACLE_HOME=$ORACLE_BASE/product/10. Oracle.Production on 25-JUL-2008 12:48:34 Copyright (c) 1991. On Linux/Solaris.4.4. Exit SQL*Plus.2.2. log on as user oracle. All rights reserved..Production on 25-JUL-2008 Copyright (c) 1991. 26) and issue the following statement: SQL> select username from dba_users.0. USERNAME -----------------------------CTXSYS OUTLN DBSNMP INTERSHOP SYS SYSTEM DIP WMSYS Check that the users INTERSHOP and CTXSYS are returned.0. on p. open a command prompt and change to the Oracle base directory.Testing the Database Creating an Enfinity Suite 6 Database Check Database Users Log on as sysdba (see Log On as Sysdba.0 . Starting tnslsnr: please wait. 2008.Production System parameter file is <ora_home>\network\admin\listener.\pipe\EXTPROCipc))) All rights reserved.0.ora Log messages written to <ora_home>\network\log\listener. Stop and Restart the Listener Stop Listener On Windows.2.0 . Page 28 Chapter 2: Database Setup .log Listening on: (DESCRIPTION=(ADDRESS=(PROTOCOL=ipc)(PIPENAME=\\. Issue the following command: $ lsnrctl stop The command returns the following output: LSNRCTL for 32-bit Windows: Version 10. Oracle.4. Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=IPC)(KEY=EXTPROC))) The command completed successfully Restart the Listener Issue the following command: lsnrctl start The command returns the following output: LSNRCTL for 32-bit Windows: Version 10. 2008..0 . TNSLSNR for 32-bit Windows: Version 10. 0 min.0. This may include. you may need to tune several database details. Preparing the Database for Data Replication The database setup program provides means to automatically prepare the environment for a data replication scenario connecting a source and a target system. Service "isdb1. status READY.0 Production Start Date 20-JUL-2008 12:48:37 Uptime 0 days 0 hr.log Listening Endpoints Summary.Creating an Enfinity Suite 6 Database Preparing the Database for Data Replication Listening on: (DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=<db_host>)(PORT=1521))) Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=IPC)(KEY=EXTPROC))) STATUS of the LISTENER -----------------------Alias LISTENER Version TNSLSNR for 32-bit Windows: Version 10.log. additional tasks are necessary to set up a data replication scenario. NOTE: For details about specific database settings. check the listener log file in <ora_home>/network/log/listener..4.. has 1 handler(s) for this service. Chapter 2: Database Setup Page 29 . 2 sec Trace Level off Security ON: Local OS Authentication SNMP OFF Listener Parameter File <ora_home>\network\admin\listener. Instance "ISORCL1".world in the example above) has started properly.2.\pipe\EXTPROCipc))) (DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=<db_host>)(PORT=1521))) Services Summary. In case of errors. (DESCRIPTION=(ADDRESS=(PROTOCOL=ipc)(PIPENAME=\\. Perform Project-Specific Database Adjustments Based on your individual project-specific needs. recreating the stopword list. The Administration and Configuration Guide also describes how to create the database link manually in order to connect existing installations for data replication. See the Administration and Configuration Guide for details.world" has 1 instance(s).. etc. for instance..ora Listener Log File <ora_home>\network\log\listener.. adapting the context index to your locale.. refer to the Intershop Technical Paper Enfinity Suite 6 Database Tuning. The command completed successfully Make sure the service (isdb1. The database setup • • creates user/schemes for source and target system creates the database link connecting target and source system NOTE: Apart from preparing the database. Two general data replication scenarios can be distinguished. Proceed as follows: 1. for details. 30. NOTE: The parameters entered on the panel in Figure 2. ■ Local Data Replication The local data replication scenario assumes a single instance for both the source and the target system. On the User Account panel. Proceed from Step 2 to Step 5.Preparing the Database for Data Replication Creating an Enfinity Suite 6 Database The workflow and the specific options to use when preparing a database for data replication depend on the data replication scenario. the database setup program needs to be executed twice. on p. 32. 2. select Two User Accounts. two different instances are used. on p. 20 are interpreted to refer to the live system. on p. 18. Workflow and settings are described in Local Data Replication. possibly residing on different hosts. The database setup creates two database users/schemes in the database: one schema for the source system and one for the target system. See Remote Data Replication. Figure 12: Creating two user accounts Click Next to continue. as described in section Database Setup Process. Remote Data Replication In the remote data replication scenario. on p. Page 30 Chapter 2: Database Setup . In this scenario. ■ Local Data Replication This section describes how to proceed in case the database is prepared for a local database replication scenario. Provide User details for source and target system.Creating an Enfinity Suite 6 Database Preparing the Database for Data Replication 3. the setup assumes the values provided in Step 4. The following parameters must be entered: • • • • • • Database Hostname: <STAGING. Provide Parameters for the Source System. on p. 4.DOMAIN> Database Listener Port: <STAGING.EDIT. Chapter 2: Database Setup Page 31 .SID> Database User Name: <STAGING.USER> Database User Password: <STAGING. In case of local data replication. the Intershop database setup program creates the necessary database link between the source and the target system. Figure 13: Defining user accounts for source and target system Click Next to continue. provided in Step 4. 20.DB.DB.LISTENER.PASSWD> NOTE: For the target system. Use default names and password or modify settings if necessary.PORT> Database System Identifier: <STAGING.DBCONNECTION.EDIT.DB. 20 (also see Figure 2. on p. 20).DB. on p. make sure the settings provided for the source system in this panel are identical with the settings for the target system.DBCONNECTION.HOSTNAME> Database Domain: <STAGING.EDIT.EDIT.EDIT.EDIT. Therefore. source and target system use the same database. Using these parameters. Page 32 Chapter 2: Database Setup . then on the target system. 32. using the process described in Local Data Replication. 1. the database setup program must be run twice: first on the source system system. on p. The database setup program creates a database instance and a user/ schema for the source system. on p. Remote Data Replication This section describes how to proceed in case the database is prepared for a remote data replication scenario. 2. on p. 22. on p. Run the database setup on the target system. must be identical to the database user account and password generated on the source system in Step 1. 32. 30. on p. on p. Database parameters entered on the panel in Figure 14. When preparing the database for a remote data replication scenario. 18. Run the database setup on the source system. The setup now continues with Step 7. on p. Database user name and password for the source system provided on the panel in Figure 14. Take care of the following issues: • • • Database parameters entered on the panel in Figure 2. refer to the source system. in which source and target system use two separate instances that reside on different hosts. 32. using the process described in Database Setup Process.Preparing the Database for Data Replication Creating an Enfinity Suite 6 Database Figure 14: Defining the source system configuration Click Next to continue. refer to the target system. 20. 23).EDIT. A manual update affects the following files: • • • sqlnet.HOSTNAME>) (PORT =<STAGING. Check the following entries in the sqlnet. 2.LISTENER.DOMAIN>) of your system (see Figure 2).ora The files are located in the <ora_home>/network/admin directory. EZCONNECT) • 3. add the entry ISEDITING.EDIT.g.EDIT.DB.EDIT. for example. NOTE: The manual update only affects these files on the server-side. NAMES. Add the following entry at the bottom of the file.ora file in the <ora_home>/network/admin directory..DB. 4. world) identifies the database domain name (<DB.DIRECTORY_PATH The value must include TNSNAMES.DOMAIN> to the tnsnames.DB.DB. TNSNAMES. ISEDITING.DOMAIN> = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = <STAGING. Replace the place holders with values appropriate for your environment. if you have chosen not to update the Oracle network configuration automatically during the database instance creation process (see Figure 6. This section describes how to manually update the network configuration files. Open the tnsnames.ora file. Go to the <ora_home>/network/admin directory and open the sqlnet. In a data replication scenario.DIRECTORY_PATH= (HOSTNAME.ora file.ora configuration file. as illustrated by the sample below: NAMES.ora tnsnames.SID>) ) ) Chapter 2: Database Setup Page 33 .EDIT. on p. This is necessary.DEFAULT_DOMAIN The value (e. Proceed as follows: 1.<STAGING.Creating an Enfinity Suite 6 Database Manual Update of Network Configuration Files Manual Update of Network Configuration Files CAUTION: Manual update of network configuration files requires experience with Oracle administration.DB. • NAMES.<STAGING.ora listener.PORT>)) (CONNECT_DATA = (SID = <STAGING. DOMAIN>.SID> vary depending on the system environment and the platform. Manual Database Creation CAUTION: Manual database creation is recommended for experienced users only. uncheck the option “Execute SQL scripts after generation” (see Figure 15.Manual Database Creation Creating an Enfinity Suite 6 Database 5. See Stop and Restart the Listener. on p. Adjust these settings according to your system.ora file. 37). Stop and restart the Listener for changes to take effect.world) (ORACLE_HOME = <ora_home>) (SID_NAME = ISORCL1) ) (SID_DESC = (SID_NAME = PLSExtProc) (ORACLE_HOME = <ora_home>) (PROGRAM = extproc) ) )) 6. Create New Instance Manually Using Scripts This section describes how to manually create a new database instance for Enfinity Suite 6 using the SQL scripts provided by the Enfinity Suite 6 database setup. # LISTENER. on p. You need to execute the database setup at least once to be able to access the scripts. you can run the database instance setup program again. <DB. Instead of creating a database instance manually. An example file which is already configured is shown below.ora # Generated by Oracle configuration tools. Page 34 Chapter 2: Database Setup . This installs the scripts that you can then execute manually afterwards. Locate the <ora_home>/network/admin directory and open the listener. 28.NAME>. LISTENER = (DESCRIPTION_LIST = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC)) ) (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = <db_host>)(PORT = 1521)) ) ) )) SID_LIST_LISTENER = (SID_LIST = (SID_DESC = (GLOBAL_DBNAME = isdb1.ORACLE. During the setup process.ORA Network Configuration File: <ora_home>/network/admin/ listener. <SYSTEM. Note that the settings for <DB.HOME> and <DB. sh INTERSHOP. • The directory <ora_install>/database/templates contains configuration file and SQL script templates with placeholders for all configuration parameters. these placeholders are substituted by real values. For each SQL script executed. Contains settings that control various aspects of Net´s operation Translates net service names to specific server addresses and instance names. SQL file to alter user-default table spaces SQL file to set grants tnsnames. • Table 1 provides an overview of all configuration files and executable SQL files.ora Description Template configuration directory Parameter template file Contains settings that control the operation of the Net Listener. a log file is created in the <DB.db. INTERSHOP.ora.Creating an Enfinity Suite 6 Database Manual Database Creation The SQL scripts reside in the directory <ora_install>/database.bat.SID>/script.SID>/log directory.ora tnsnames. and redo-log files SQL file to create table spaces This script only creates table spaces that are not Intershop-specific.ora sqlnet.INSTALL.sql SQL file to create a catalog SQL file to install Oracle Text.link . DBconfigure. Intershop-specific table spaces are created by the script INTERSHOPcreateTablespacesISH.sql INTERSHOPgrantsToSystem. Table 1: Configuration files and executable SQL files for database creation <IS./templates/config/ init. Entry of the database link template Template script directory Batch file/script to create directories./templates/script DBconfigure.sql INTERSHOPalterTablespace.sql INTERSHOPcontext. and to set the administrator password Main batch file/script to wrap the SQL command sequences SQL file to create the database. services.sql INTERSHOPcreateCatalog.sql INTERSHOPcreateTablespaces.sql Chapter 2: Database Setup Page 35 .SID>/config and <ora_install>/database/<DB.bat. The files with real values are copied to the directories <ora_install>/ database/<DB.ora listener.DIR>/database . During the installation. the system table space.sh INTERSHOPcreateDB. sql INTERSHOPcreateUserEditing. The setup creates the new <DB. Table spaces that are not Intershop-specific are created by the SQL script INTERSHOPcreateTablespaces. To create a set of SQL files for a new database instance. such as installing SQL Plus help files. Log on. • • On Windows.sql Description SQL file to set system passwords SQL file to create source system database user SQL file to create target system database user.sql SQL to perform additional Oracle installation tasks.SID> directory.sql INTESHOPcreateUserLive. This script is also invoked in case the system works with a single user/schema only. Page 36 Chapter 2: Database Setup . Run the Enfinity Suite 6 Database Setup to create the scripts and SQL files for the new database instance. proceed as follows: 1.Manual Database Creation Creating an Enfinity Suite 6 Database <IS. log on as administrator or as user with administrative rights. make sure to deselect the option “Execute SQL scripts after generation on the panel “Net and SQL Script Options” (see Figure 15).INSTALL.DIR>/database INTERSHOPsetSystemPasswords. INTERSHOPcreateDBlink.sql INTERSHOPcreateTablespacesISH. 2.sql In order to create a new database instance manually using the scripts. On Linux/Solaris. SQL file to create database link SQL file to create Intershop-specific table spaces. copies the SQL files and replaces all placeholders with values appropriate for your installation. sql INTERSHOPpostCreation. log on as root user. Change to the template directory of the new database instance. This section describes how to prepare an existing database instance for use with Enfinity Suite 6. 5. In this case. Change to <ora_install>/database/<DB.Creating an Enfinity Suite 6 Database Manual Database Creation Figure 15: Net and SQL Script Options 3.bat file (Windows) or INTERSHOP. Linux/Solaris only: Run the DBconfigure. make sure to replace all placeholders in the scripts with values appropriate for your installation. Run the INTERSHOP.sh script (Linux/Solaris). NOTE: Instead of running the Enfinity Suite 6 database setup.oracle 6.SID>/script. Prepare Existing Instance for Enfinity Suite 6 CAUTION: The procedures described in this section must be performed as sysdba. Linux/Solaris only: Switch to user oracle. you can create the template directories for the new database instance (in <ora_install>/database/ <DB. The batch file/script invokes all SQL scripts in the directory. Chapter 2: Database Setup Page 37 .SID>) and copy the scripts manually. # su . 4.sh script as root. Preparing the database instance requires to ■ ■ create the tablespaces required by Enfinity Suite 6 create the Enfinity Suite 6 database user(s). CREATE TABLESPACE IS_INDX_CTX DATAFILE '<path>/IS_INDX_CTX_01.DIR>/share/system/config/ cluster) by the key intershop. CREATE TABLESPACE IS_INDX DATAFILE '<path>/IS_INDX_01. CREATE TABLESPACE IS_USERS DATAFILE '<path>/IS_USERS_01. on p. See Check Character Set Settings.tablespaces. fast disks. The database user needs to be provided later on when installing Enfinity Suite 6.Manual Database Creation Creating an Enfinity Suite 6 Database Before You Start Before you start creating tablespaces and user accounts. check whether the database user CTXSYS exists.INSTANCE. Oracle Text must be installed.jdbc. on p. Spread the files over several controllers/disks to improve the I/O performance. CREATE TEMPORARY TABLESPACE IS_TEMP TEMPFILE '<path>/IS_TEMP_01. The sample below illustrates how to create the tablespaces. See Check Database Users. IS_TEMP and IS_USERS are also referred to when creating the database user • (see Create Database User.dbf' SIZE 1G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE UNLIMITED EXTENT MANAGEMENT LOCAL UNIFORM SIZE 2M. IS_INDX and IS_INDX_CTX.INSTANCE.properties file (located in <IS. Redo log files and their copies should be placed on dedicated. IS_USERS.DIR>/share/system/config/cluster) by the key intershop. 27. Page 38 Chapter 2: Database Setup . Note that the placeholder <path> must be replaced with path settings appropriate for your system.jdbc.user.dbf' SIZE 1G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE UNLIMITED EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO. To test this. directories and filenames meet your needs. • All tablespaces are referenced in the orm. Create Tablespaces Enfinity Suite 6 requires the tablespaces IS_TEMP. check whether your database instance meets the following requirements: • • The character set has to be set to AL32UTF8. It is referenced in the orm. NOTE: Make sure the physical locations.dbf' SIZE 1G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE UNLIMITED EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO. Create Database User At least one database user is required.dbf' SIZE 1G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE UNLIMITED EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO. 28.properties file (located in <IS. on p. 38). properties file (located in <IS.INSTANCE. CREATE SYNONYM TO &AUSER.DIR>/share/system/config/cluster) by the key staging. ALTER USER &AUSER DEFAULT ROLE ALL. EXECUTE ON CTX_DDL TO &AUSER. The example below illustrates how to create the database user INTERSHOP. CREATE TYPE TO &AUSER. ALTER USER &AUSER QUOTA UNLIMITED ON IS_USERS. Chapter 2: Database Setup Page 39 . CREATE PROCEDURE TO &AUSER."RESOURCE". an additional database user is required for the source system. CREATE TABLE TO &AUSER. CREATE TRIGGER TO &AUSER. CREATE VIEW TO &AUSER. DEFINE AUSER='INTERSHOP' CREATE USER &AUSER IDENTIFIED BY &AUSER DEFAULT TABLESPACE "IS_USERS" TEMPORARY TABLESPACE "IS_TEMP" PROFILE DEFAULT ACCOUNT UNLOCK. ALTER USER &AUSER QUOTA UNLIMITED ON IS_INDX.editing. in data replication scenarios. GRANT GRANT GRANT GRANT GRANT GRANT GRANT GRANT GRANT GRANT GRANT GRANT CREATE CLUSTER TO &AUSER. CREATE MATERIALIZED VIEW TO &AUSER.Creating an Enfinity Suite 6 Database Manual Database Creation More complex Enfinity Suite 6 deployments may require additional database users."CTXAPP" TO &AUSER. referenced in the staging. GRANT "CONNECT".schema. For example.name. ALTER USER &AUSER QUOTA UNLIMITED ON IS_INDX_CTX. REVOKE UNLIMITED TABLESPACE FROM &AUSER. CREATE SNAPSHOT TO &AUSER. CREATE SEQUENCE TO &AUSER. CREATE DATABASE LINK TO &AUSER. Manual Database Creation Creating an Enfinity Suite 6 Database Page 40 Chapter 2: Database Setup .