From owner-p4-projects@FreeBSD.ORG Mon Nov 22 14:01:47 2010 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 4238F1065697; Mon, 22 Nov 2010 14:01:47 +0000 (UTC) Delivered-To: perforce@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 042A91065679 for ; Mon, 22 Nov 2010 14:01:47 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from skunkworks.freebsd.org (skunkworks.freebsd.org [IPv6:2001:4f8:fff6::2d]) by mx1.freebsd.org (Postfix) with ESMTP id E3F998FC0C for ; Mon, 22 Nov 2010 14:01:46 +0000 (UTC) Received: from skunkworks.freebsd.org (localhost [127.0.0.1]) by skunkworks.freebsd.org (8.14.4/8.14.4) with ESMTP id oAME1kxZ058437 for ; Mon, 22 Nov 2010 14:01:46 GMT (envelope-from rene@FreeBSD.org) Received: (from perforce@localhost) by skunkworks.freebsd.org (8.14.4/8.14.4/Submit) id oAME1kdL058434 for perforce@freebsd.org; Mon, 22 Nov 2010 14:01:46 GMT (envelope-from rene@FreeBSD.org) Date: Mon, 22 Nov 2010 14:01:46 GMT Message-Id: <201011221401.oAME1kdL058434@skunkworks.freebsd.org> X-Authentication-Warning: skunkworks.freebsd.org: perforce set sender to rene@FreeBSD.org using -f From: Rene Ladan To: Perforce Change Reviews Precedence: bulk Cc: Subject: PERFORCE change 186105 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 22 Nov 2010 14:01:47 -0000 http://p4web.freebsd.org/@@186105?ac=10 Change 186105 by rene@rene_acer on 2010/11/22 14:01:34 Pre-7.X cleanup of Handbook (from bcr@): - remove "rene" comments, they are on the DocIdeaList on the wiki now - Bye bye SAP-on-FreeBSD section Affected files ... .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/config/chapter.sgml#13 edit .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml#22 edit .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml#9 edit .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/mac/chapter.sgml#9 edit .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/mail/chapter.sgml#4 edit .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml#9 edit Differences ... ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/config/chapter.sgml#13 (text+ko) ==== @@ -2124,7 +2124,7 @@ In older FreeBSD releases, the default value of kern.maxfiles is derived from the option in your - kernel configuration file. kern.maxfiles grows + kernel configuration file. kern.maxfiles grows proportionally to the value of . When compiling a custom kernel, it is a good idea to set this kernel configuration option according to the uses of your system. From @@ -2148,7 +2148,7 @@ /boot/defaults/loader.conf file for some hints) or as described elsewhere in this document. - In older releases, the system will auto-tune + In older releases, the system will auto-tune maxusers for you if you explicitly set it to 0 The auto-tuning algorithm sets @@ -2228,7 +2228,7 @@ use. kern.ipc.nmbclusters loader tunable should - be used to tune this at boot time. Only older versions of &os; + be used to tune this at boot time. Only older versions of &os; will require you to use the NMBCLUSTERS kernel &man.config.8; option. ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml#22 (text+ko) ==== @@ -2124,7 +2124,7 @@ installworld. If your old version of mergemaster does not support , use the new version in the source tree when running for the first - time: + time: &prompt.root; cd /usr/src/usr.sbin/mergemaster &prompt.root; ./mergemaster.sh -p ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml#9 (text+ko) ==== @@ -1200,2028 +1200,6 @@ - - - - - Holger - Kipp - Contributed by - - - - - - Valentino - Vaschetto - Original version converted to SGML by - - - - - Installing &sap.r3; - - - applications - SAP R/3 - - - Installations of &sap; Systems using FreeBSD will not be - supported by the &sap; support team — they only offer support - for certified platforms. - - - Preface - - This document describes a possible way of installing a - &sap.r3; System - with &oracle; Database - for Linux onto a FreeBSD machine, including the installation - of FreeBSD and &oracle;. Two different - configurations will be described: - - - - &sap.r3; 4.6B (IDES) with - &oracle; 8.0.5 on FreeBSD 4.3-STABLE - - - - &sap.r3; 4.6C with - &oracle; 8.1.7 on FreeBSD 4.5-STABLE - - - - Even though this document tries to describe all important - steps in a greater detail, it is not intended as a replacement - for the &oracle; and - &sap.r3; installation guides. - - Please see the documentation that comes with the - &sap.r3; - Linux edition for &sap; and - &oracle; specific questions, as well - as resources from &oracle; and - &sap; OSS. - - - - Software - - The following CD-ROMs have been used for &sap; installations: - - - &sap.r3; 4.6B, &oracle; 8.0.5 - - - - - - Name Number Description - - - - - KERNEL 51009113 SAP Kernel Oracle / - Installation / AIX, Linux, Solaris - - - - RDBMS 51007558 Oracle / RDBMS 8.0.5.X / - Linux - - - - EXPORT1 51010208 IDES / DB-Export / - Disc 1 of 6 - - - - EXPORT2 51010209 IDES / DB-Export / - Disc 2 of 6 - - - - EXPORT3 51010210 IDES / DB-Export / - Disc 3 of 6 - - - - EXPORT4 51010211 IDES / DB-Export / - Disc 4 of 6 - - - - EXPORT5 51010212 IDES / DB-Export / - Disc 5 of 6 - - - - EXPORT6 51010213 IDES / DB-Export / - Disc 6 of 6 - - - - - - Additionally, we used the &oracle; 8 - Server (Pre-production version 8.0.5 for Linux, - Kernel Version 2.0.33) CD which is not really necessary, and - FreeBSD 4.3-STABLE (it was only a few days past 4.3 - RELEASE). - - - - &sap.r3; 4.6C SR2, &oracle; 8.1.7 - - - - - - Name Number Description - - - - - - KERNEL 51014004 SAP Kernel Oracle / - SAP Kernel Version 4.6D / DEC, Linux - - - - RDBMS 51012930 Oracle 8.1.7/ RDBMS / - Linux - - - - EXPORT1 51013953 Release 4.6C SR2 / Export - / Disc 1 of 4 - - - - EXPORT1 51013953 Release 4.6C SR2 / Export - / Disc 2 of 4 - - - - EXPORT1 51013953 Release 4.6C SR2 / Export - / Disc 3 of 4 - - - - EXPORT1 51013953 Release 4.6C SR2 / Export - / Disc 4 of 4 - - - - LANG1 51013954 Release 4.6C SR2 / - Language / DE, EN, FR / Disc 1 of 3 - - - - - - Depending on the languages you would like to install, additional - language CDs might be necessary. Here we are just using DE and EN, so - the first language CD is the only one needed. As a little note, the - numbers for all four EXPORT CDs are identical. All three language CDs - also have the same number (this is different from the 4.6B IDES - release CD numbering). At the time of writing this installation is - running on FreeBSD 4.5-STABLE (20.03.2002). - - - - - &sap; Notes - - The following notes should be read before installing - &sap.r3; and proved to be useful - during installation: - - - &sap.r3; 4.6B, &oracle; 8.0.5 - - - - - - Number - Title - - - - - - 0171356 SAP Software on Linux: Essential - Comments - - - - 0201147 INST: 4.6C R/3 Inst. on UNIX - - Oracle - - - - 0373203 Update / Migration Oracle 8.0.5 --> - 8.0.6/8.1.6 LINUX - - - - 0072984 Release of Digital UNIX 4.0B for - Oracle - - - - 0130581 R3SETUP step DIPGNTAB terminates - - - - 0144978 Your system has not been installed - correctly - - - - 0162266 Questions and tips for R3SETUP on Windows - NT / W2K - - - - - - - - &sap.r3; 4.6C, &oracle; 8.1.7 - - - - - - Number - Title - - - - - 0015023 Initializing table TCPDB (RSXP0004) - (EBCDIC) - - - - 0045619 R/3 with several languages or - typefaces - - - - 0171356 SAP Software on Linux: Essential - Comments - - - - 0195603 RedHat 6.1 Enterprise version: - Known problems - - - - 0212876 The new archiving tool SAPCAR - - - - 0300900 Linux: Released DELL Hardware - - - - 0377187 RedHat 6.2: important remarks - - - - 0387074 INST: R/3 4.6C SR2 Installation on - UNIX - - - - 0387077 INST: R/3 4.6C SR2 Inst. on UNIX - - Oracle - - - - 0387078 SAP Software on UNIX: OS Dependencies - 4.6C SR2 - - - - - - - - - Hardware Requirements - - The following equipment is sufficient for the installation - of a &sap.r3; System. For production - use, a more exact sizing is of course needed: - - - - - - Component - 4.6B - 4.6C - - - - - Processor - 2 x 800MHz &pentium; III - 2 x 800MHz &pentium; III - - - - Memory - 1GB ECC - 2GB ECC - - - - Hard Disk Space - 50-60GB (IDES) - 50-60GB (IDES) - - - - - - For use in production, &xeon; Processors with large cache, - high-speed disk access (SCSI, RAID hardware controller), USV - and ECC-RAM is recommended. The large amount of hard disk - space is due to the preconfigured IDES System, which creates - 27 GB of database files during installation. This space is - also sufficient for initial production systems and application - data. - - - &sap.r3; 4.6B, &oracle; 8.0.5 - - The following off-the-shelf hardware was used: a dual processor - board with 2 800 MHz &pentium; III processors, &adaptec; 29160 Ultra160 - SCSI adapter (for accessing a 40/80 GB DLT tape drive and CDROM), - &mylex; &acceleraid; (2 channels, firmware 6.00-1-00 with 32 MB RAM). - To the &mylex; RAID controller are attached two 17 GB hard disks - (mirrored) and four 36 GB hard disks (RAID level 5). - - - - &sap.r3; 4.6C, &oracle; 8.1.7 - - For this installation a &dell; &poweredge; 2500 was used: a - dual processor board with two 1000 MHz &pentium; III processors - (256 kB Cache), 2 GB PC133 ECC SDRAM, PERC/3 DC PCI RAID Controller - with 128 MB, and an EIDE DVD-ROM drive. To the RAID controller are - attached two 18 GB hard disks (mirrored) and four 36 GB hard disks - (RAID level 5). - - - - - Installation of FreeBSD - - First you have to install FreeBSD. There are several ways to do - this, for more information read the . - - - Disk Layout - - To keep it simple, the same disk layout both for the - &sap.r3; 46B and &sap.r3; 46C - SR2 installation was used. Only the device names - changed, as the installations were on different hardware (/dev/da - and /dev/amr respectively, so if using an AMI &megaraid;, one will see - /dev/amr0s1a instead of /dev/da0s1a): - - - - - - File system - Size - Mounted on - - - - - /dev/da0s1a - 1 GB - / - - - - /dev/da0s1b - 6 GB - swap - - - - /dev/da0s1e - 2 GB - /var - - - - /dev/da0s1f - 8 GB - /usr - - - - /dev/da1s1e - 45 GB - /compat/linux/oracle - - - - /dev/da1s1f - 2 GB - /compat/linux/sapmnt - - - - /dev/da1s1g - 2 GB - /compat/linux/usr/sap - - - - - - Configure and initialize the two logical drives - with the &mylex; or PERC/3 RAID software beforehand. - The software can be started during the - BIOS boot phase. - - Please note that this disk layout differs slightly from - the &sap; recommendations, as &sap; suggests mounting the - &oracle; subdirectories (and some others) separately — we - decided to just create them as real subdirectories for - simplicity. - - - - <command>make world</command> and a New Kernel - - Download the latest -STABLE sources. Rebuild world and your - custom kernel after configuring your kernel configuration file. - Here you should also include the - kernel parameters - which are required for both &sap.r3; - and &oracle;. - - - - - Installing the Linux Environment - - - Installing the Linux Base System - - First the linux_base - port needs to be installed (as root): - - &prompt.root; cd /usr/ports/emulators/linux_base-fc4 -&prompt.root; make install distclean - - - - - - Installing Linux Development Environment - - The Linux development environment is needed, if you want to install - &oracle; on FreeBSD according to the - : - - &prompt.root; cd /usr/ports/devel/linux_devtools -&prompt.root; make install distclean - - The Linux development environment has only been installed for the &sap.r3; - 46B IDES installation. It is not needed, if - the &oracle; DB is not relinked on the - FreeBSD system. This is the case if you are using the - &oracle; tarball from a Linux system. - - - - - - Installing the Necessary RPMs - RPMs - - To start the R3SETUP program, PAM support is needed. - During the first &sap; Installation on FreeBSD 4.3-STABLE we - tried to install PAM with all the required packages and - finally forced the installation of the PAM package, which - worked. For &sap.r3; 4.6C SR2 we - directly forced the installation of the PAM RPM, which also - works, so it seems the dependent packages are not needed: - - -&prompt.root; rpm -i --ignoreos --nodeps --root /compat/linux --dbpath /var/lib/rpm \ -pam-0.68-7.i386.rpm - - For &oracle; 8.0.5 to run the - intelligent agent, we also had to install the RedHat Tcl package - tcl-8.0.5-30.i386.rpm (otherwise the - relinking during &oracle; installation - will not work). There are some other issues regarding - relinking of &oracle;, but that is - a &oracle; Linux issue, not FreeBSD specific. - - - - - Some Additional Hints - - It might also be a good idea to add linprocfs - to /etc/fstab, for more information, see the &man.linprocfs.5; manual page. - Another parameter to set is kern.fallback_elf_brand=3 - which is done in the file /etc/sysctl.conf. - - - - - Creating the &sap.r3; Environment - - - Creating the Necessary File Systems and Mountpoints - - For a simple installation, it is sufficient to create the - following file systems: - - - - - - mount point - size in GB - - - - - /compat/linux/oracle - 45 GB - - - - /compat/linux/sapmnt - 2 GB - - - - /compat/linux/usr/sap - 2 GB - - - - - - It is also necessary to created some links. Otherwise - the &sap; Installer will complain, as it is checking the - created links: - - &prompt.root; ln -s /compat/linux/oracle /oracle -&prompt.root; ln -s /compat/linux/sapmnt /sapmnt -&prompt.root; ln -s /compat/linux/usr/sap /usr/sap - - Possible error message during installation (here with - System PRD and the - &sap.r3; 4.6C SR2 - installation): - - INFO 2002-03-19 16:45:36 R3LINKS_IND_IND SyLinkCreate:200 - Checking existence of symbolic link /usr/sap/PRD/SYS/exe/dbg to - /sapmnt/PRD/exe. Creating if it does not exist... - -WARNING 2002-03-19 16:45:36 R3LINKS_IND_IND SyLinkCreate:400 - Link /usr/sap/PRD/SYS/exe/dbg exists but it points to file - /compat/linux/sapmnt/PRD/exe instead of /sapmnt/PRD/exe. The - program cannot go on as long as this link exists at this - location. Move the link to another location. - -ERROR 2002-03-19 16:45:36 R3LINKS_IND_IND Ins_SetupLinks:0 - can not setup link '/usr/sap/PRD/SYS/exe/dbg' with content - '/sapmnt/PRD/exe' - - - - Creating Users and Directories - - &sap.r3; needs two users and - three groups. The user names depend on the - &sap; system ID (SID) which consists - of three letters. Some of these SIDs are reserved - by &sap; (for example - SAP and NIX. For a - complete list please see the &sap; documentation). For the IDES - installation we used IDS, for the - 4.6C SR2 installation PRD, as that system - is intended for production use. We have - therefore the following groups (group IDs might differ, these - are just the values we used with our installation): - - - - - - group ID - group name - description - - - - - 100 - dba - Data Base Administrator - - - 101 - sapsys - &sap; System - - - 102 - oper - Data Base Operator - - - - - - For a default &oracle; installation, only group - dba is used. As - oper group, one also uses group - dba (see &oracle; and - &sap; documentation for further information). - - We also need the following users: - - - - - - user ID - user name - generic name - group - additional groups - description - - - - - 1000 - idsadm/prdadm - sidadm - sapsys - oper - &sap; Administrator - - - 1002 - oraids/oraprd - orasid - dba - oper - &oracle; Administrator - - - - - - Adding the users with &man.adduser.8; - requires the following (please note shell and home - directory) entries for &sap; Administrator: - - Name: sidadm -Password: ****** -Fullname: SAP Administrator SID -Uid: 1000 -Gid: 101 (sapsys) -Class: -Groups: sapsys dba -HOME: /home/sidadm -Shell: bash (/compat/linux/bin/bash) - - and for &oracle; Administrator: - - Name: orasid -Password: ****** -Fullname: Oracle Administrator SID -Uid: 1002 -Gid: 100 (dba) -Class: -Groups: dba -HOME: /oracle/sid -Shell: bash (/compat/linux/bin/bash) - - This should also include group - oper in case you are using both - groups dba and - oper. - - - - - Creating Directories - - These directories are usually created as separate - file systems. This depends entirely on your requirements. We - choose to create them as simple directories, as they are all - located on the same RAID 5 anyway: - - First we will set owners and rights of some directories (as - user root): - - &prompt.root; chmod 775 /oracle -&prompt.root; chmod 777 /sapmnt -&prompt.root; chown root:dba /oracle -&prompt.root; chown sidadm:sapsys /compat/linux/usr/sap -&prompt.root; chmod 775 /compat/linux/usr/sap - - Second we will create directories as user - orasid. These - will all be subdirectories of - /oracle/SID: - - &prompt.root; su - orasid -&prompt.root; cd /oracle/SID -&prompt.root; mkdir mirrlogA mirrlogB origlogA origlogB -&prompt.root; mkdir sapdata1 sapdata2 sapdata3 sapdata4 sapdata5 sapdata6 -&prompt.root; mkdir saparch sapreorg -&prompt.root; exit - - For the &oracle; 8.1.7 installation - some additional directories are needed: - - &prompt.root; su - orasid -&prompt.root; cd /oracle -&prompt.root; mkdir 805_32 -&prompt.root; mkdir client stage -&prompt.root; mkdir client/80x_32 -&prompt.root; mkdir stage/817_32 -&prompt.root; cd /oracle/SID -&prompt.root; mkdir 817_32 - - The directory client/80x_32 is used - with exactly this name. Do not replace the x - with some number or anything. - - In the third step we create directories as user - sidadm: - - &prompt.root; su - sidadm -&prompt.root; cd /usr/sap -&prompt.root; mkdir SID -&prompt.root; mkdir trans -&prompt.root; exit - - - - Entries in <filename>/etc/services</filename> - - &sap.r3; requires some entries in file - /etc/services, which will not be set - correctly during installation under FreeBSD. Please add the - following entries (you need at least those entries - corresponding to the instance number — in this case, - 00. It will do no harm adding all - entries from 00 to - 99 for dp, - gw, sp and - ms). If you are going to use a SAProuter - or need to access &sap; OSS, you also need 99, - as port 3299 is usually used for the SAProuter process on the - target system: - - -sapdp00 3200/tcp # SAP Dispatcher. 3200 + Instance-Number -sapgw00 3300/tcp # SAP Gateway. 3300 + Instance-Number -sapsp00 3400/tcp # 3400 + Instance-Number -sapms00 3500/tcp # 3500 + Instance-Number -sapmsSID 3600/tcp # SAP Message Server. 3600 + Instance-Number -sapgw00s 4800/tcp # SAP Secure Gateway 4800 + Instance-Number - - - - Necessary Locales - locale - - &sap; requires at least two locales that are not part of - the default RedHat installation. &sap; offers the required - RPMs as download from their FTP server (which is only - accessible if you are a customer with OSS access). See note - 0171356 for a list of RPMs you need. - - It is also possible to just create appropriate links - (for example from de_DE and - en_US ), but we would not recommend this - for a production system (so far it worked with the IDES - system without any problems, though). The following locales - are needed: - - de_DE.ISO-8859-1 -en_US.ISO-8859-1 - - Create the links like this: - - &prompt.root; cd /compat/linux/usr/share/locale -&prompt.root; ln -s de_DE de_DE.ISO-8859-1 -&prompt.root; ln -s en_US en_US.ISO-8859-1 - - If they are not present, there will be some problems - during the installation. If these are then subsequently - ignored (by setting the STATUS of the offending steps to - OK in file CENTRDB.R3S), it will be impossible to log onto - the &sap; system without some additional effort. - - - - Kernel Tuning - kernel tuning - - &sap.r3; systems need a lot of resources. We therefore - added the following parameters to the kernel configuration file: - - # Set these for memory pigs (SAP and Oracle): -options MAXDSIZ="(1024*1024*1024)" -options DFLDSIZ="(1024*1024*1024)" -# System V options needed. -options SYSVSHM #SYSV-style shared memory -options SHMMAXPGS=262144 #max amount of shared mem. pages -#options SHMMAXPGS=393216 #use this for the 46C inst.parameters -options SHMMNI=256 #max number of shared memory ident if. -options SHMSEG=100 #max shared mem.segs per process -options SYSVMSG #SYSV-style message queues -options MSGSEG=32767 #max num. of mes.segments in system -options MSGSSZ=32 #size of msg-seg. MUST be power of 2 -options MSGMNB=65535 #max char. per message queue -options MSGTQL=2046 #max amount of msgs in system -options SYSVSEM #SYSV-style semaphores -options SEMMNU=256 #number of semaphore UNDO structures -options SEMMNS=1024 #number of semaphores in system -options SEMMNI=520 #number of semaphore identifiers -options SEMUME=100 #number of UNDO keys - - The minimum values are specified in the documentation that - comes from &sap;. As there is no description for Linux, see the - HP-UX section (32-bit) for further information. As the system - for the 4.6C SR2 installation has more main memory, the shared - segments can be larger both for &sap; - and &oracle;, therefore choose a larger - number of shared memory pages. - - With the default installation of FreeBSD on &i386;, - leave MAXDSIZ and DFLDSIZ at 1 GB maximum. Otherwise, strange - errors like ORA-27102: out of memory and - Linux Error: 12: Cannot allocate memory - might happen. - - - - - Installing &sap.r3; - - - Preparing &sap; CDROMs - - There are many CDROMs to mount and unmount during the - installation. Assuming you have enough CDROM drives, you - can just mount them all. We decided to copy the CDROMs - contents to corresponding directories: - - /oracle/SID/sapreorg/cd-name - - where cd-name was one of KERNEL, - RDBMS, EXPORT1, - EXPORT2, EXPORT3, - EXPORT4, EXPORT5 and - EXPORT6 for the 4.6B/IDES installation, and - KERNEL, RDBMS, - DISK1, DISK2, - DISK3, DISK4 and - LANG for the 4.6C SR2 installation. All the - filenames on the mounted CDs should be in capital letters, - otherwise use the option for mounting. So use the following - commands: - - &prompt.root; mount_cd9660 -g /dev/cd0a /mnt -&prompt.root; cp -R /mnt/* /oracle/SID/sapreorg/cd-name -&prompt.root; umount /mnt - - - - Running the Installation Script - - First you have to prepare an install directory: - - &prompt.root; cd /oracle/SID/sapreorg -&prompt.root; mkdir install -&prompt.root; cd install - - Then the installation script is started, which will copy nearly - all the relevant files into the install directory: - >>> TRUNCATED FOR MAIL (1000 lines) <<<