EXPSRV_E

HTML Export Service Installation Guide

Release SAP KW 6 .0 V 1 . 0

SAP AG y Neurottstr. 16 y D-69190 Walldorf

HTML Export Service Installation

Copyright Copyright 2003 SAP AG. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice.

Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.

Microsoft, WINDOWS, NT, EXCEL, Word, PowerPoint and SQL Server are registered trademarks of Microsoft Corporation.

IBM, DB2, OS/2, DB2/6000, Parallel Sysplex, MVS/ESA, RS/6000, AIX, S/390, AS/400, OS/390, OS/400, IBM eServer iSeries, IBM eServer zSeries and z/OS are registered trademarks of IBM Corporation.

ORACLE is a registered trademark of ORACLE Corporation.

INFORMIX-OnLine for SAP and Informix Dynamic ServerTM

are registered trademarks of Informix Software Incorporated.

UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group.

Citrix, the Citrix logo, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, MultiWin and other Citrix product names referenced herein are trademarks of Citrix Systems, Inc.

HTML, DHTML, XML, XHTML are trademarks or registered trademarks of W3C, World Wide Web Consortium, Massachusetts Institute of Technology.

JAVA is a registered trademark of Sun Microsystems, Inc.

JAVASCRIPT is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape.

SAP, SAP Logo, R/2, RIVA, R/3, SAP ArchiveLink, SAP Business Workflow, WebFlow, SAP EarlyWatch, BAPI, SAPPHIRE, Management Cockpit, mySAP.com Logo and mySAP.com are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other products mentioned are trademarks or registered trademarks of their respective companies.

Documentation in the SAP Service Marketplace You can find this documentation at the following address: http://service.sap.com/installation

2 Dezember 2002


Typographic Conventions

Type Style Represents

Example Text Words or characters that appear on the screen. These include field names, screen titles, pushbuttons as well as menu names, paths and options.

Cross-references to other documentation

Example text Emphasized words or phrases in body text, titles of graphics and tables

EXAMPLE TEXT Names of elements in the system. These include report names, program names, transaction codes, table names, and individual key words of a programming language, when surrounded by body text, for example, SELECT and INCLUDE.

Example text Screen output. This includes file and directory names and their paths, messages, names of variables and parameters, source code as well as names of installation, upgrade and database tools.

Example text Exact user entry. These are words or characters that you enter in the system exactly as they appear in the documentation.

Variable user entry. Pointed brackets indicate that you replace these words and characters with appropriate entries.

EXAMPLE TEXT Keys on the keyboard, for example, function keys (such as F2) or the ENTER key

Icons

Icon Meaning

Caution

Example

Note

Recommendation

Syntax

Dezember 2002 3


Contents

HTML Export Service....................................................................................................................................... 5 Purpose.......................................................................................................................................................... 5

HTML Export Service - Installation Requirements ....................................................................................... 5 Hardware........................................................................................................................................................ 5 Software ......................................................................................................................................................... 5

Executing the HTML Export Service Setup-Program................................................................................... 6 Prerequisites .................................................................................................................................................. 6 Procedure....................................................................................................................................................... 6

Call the setup program ........................................................................................................................... 6 Select the installation directory ............................................................................................................... 7 Select the SAP HTML export components ............................................................................................. 8 Select the program folder ....................................................................................................................... 8 Start the installation ................................................................................................................................ 9 Install the Microsoft HTML Help Workshop 1.3 .................................................................................... 10 Select the HTML Help Workshop installation directory ........................................................................ 10 Status notification.................................................................................................................................. 11 SAP HTML Export Services 6.0............................................................................................................ 11

Setting Up Services on the R/3 Application Server.................................................................................. 12 Setting Up Export Services on Windows 2000 Export Servers................................................................ 13 Assigning Export Jobs to Windows 2000 Export Servers ........................................................................ 14 Automatic Instantiation After Content Import ........................................................................................... 15 Adding HTML Export Number Areas for File Names ............................................................................... 15 Selecting a Number Area for HTML Export.............................................................................................. 15

Configuration on the Windows 2000 Export Server..................................................................................... 16

Uninstalling the HTML Export Service ........................................................................................................ 17 Prerequisites ................................................................................................................................................ 17 Procedure..................................................................................................................................................... 17

4 Dezember 2002


HTML Export Service Purpose The HTML Export Service is used to generate static versions of document collections, which are maintained in the SAP Knowledge Warehouse. In this process, all references to logical info objects are defined as references to physical info objects. Static versions can be generated in two different formats:

Compiled HTML (*.chm), which can be displayed using the Microsoft HTML Help Viewer Standard HTML (PlainHTML), which can be displayed using standard Web browsers

Besides R/3 functions, the service also incorporates components that have to be installed directly on a Windows 2000 Server. These components are: SAP HTML Export Services and Microsoft HTML Help Workshop 1.3.

HTML Export Service - Installation Requirements The system on which the server components of the HTML Export Service are to be installed has to fulfill the following requirements:

Hardware Hard disk capacity 2 GB

Main memory 128 MB

Processor Pentium Processor 150 MHz

Software Operating system Microsoft Windows 2000 Server (English

version), Internet Explorer 5.0 or 5.5

File system NTFS

Before you can use the HTML Export Service on a Windows 2000 Server (by starting the sapiwexp.exe program), you have to:

Execute Customizing activities for the HTML Export Service in the R/3 System (see below: Configuring the SAP Knowledge Warehouse)

Add the host name and the gateway of your R/3 application server and the destination number that you assigned for the Windows 2000 Server when configuring the Knowledge Warehouse to the SAPIWEXP.INI file on the Windows 2000 Server (see transaction SI24 in the Knowledge Warehouse -> Settings in the Knowledge Warehouse System HTML Export for Generating Static Display Formats Server).

Dezember 2002 5


Executing the HTML Export Service Setup-Program Prerequisites The installation requirements have to be fulfilled (see HTML Export Service - Installation Requirements).

The HTML Export Service setup program has to be started on the computer on which the export components are to be installed. You have to log on to the operating system locally with administrator rights and exit all programs before starting the setup program.

Procedure Call the setup program

Place the CD Server Components 2 in the CD ROM disk drive.

Start the Setup.exe program in directory \EXPSERV\sapiwexp. The setup program greets you before starting the installation.

In the next window, you are informed about the status of the Internet Explorer.

6 Dezember 2002


Select the installation directory You are requested to specify the installation directory. The setup program proposes the target directory C:\Program Files\SAP\SAP HTML-Export Services. To change this, choose Browse and select the required directory, and then choose Next.

Dezember 2002 7


Select the SAP HTML export components A dialog box is displayed, requesting you to select the SAP HTML export components. Select the following components:

MICROSOFT HTML HELP Workshop 1.3 SAP HTML Export Services 6.0

Choose Next.

Select the program folder You are requested to select the directory under which the SAP HTML Export Service is to appear. Choose Next.

8 Dezember 2002


Start the installation An overview of the settings selected is displayed for you to check.

If you want to change the settings, choose Back. To start the installation, choose Next.

Dezember 2002 9


Install the Microsoft HTML Help Workshop 1.3

In the next step, the installation of the Microsoft HTML Help Workshop 1.3 is started. First, you have to accept the License Agreement.

The installation procedure continues once you have accepted the terms of the agreement.

Select the HTML Help Workshop installation directory In the next step, you select the installation directory. C:\Program Files\HTML Help Workshop is proposed as the standard directory. If you want to change this, choose Browse. To continue with the installation, choose OK.

10 Dezember 2002


If the directory does not exist, you can create it.

Status notification A status message is displayed, informing you that the HTML Export Service has been installed successfully.

SAP HTML Export Services 6.0 The setup program continues to install the SAP HTML Export Service 6.0. Choose OK.

Finally, choose Finish to complete the setup. You can open the Read Me file and start the SAP HTML Export Service 6.0 at the same time.

Dezember 2002 11


At the end of the installation routine and the server reboot, carry out the following activities on the Microsoft Windows 2000 machine:

1. Download the file htmtltidy_*.exe from the SAP Service Marketplace: Alias patches Navigation path: SAP KW -> SAP KW 6.0 -> Binary Patches -> HTMLTIDY 6.0 SAPGUI -> Win32

2. The file htmltidy_*.exe is a self-extracting ZIP archive. Double-click on the file to unzip the content. The file contains five files: htmltidy.dll, htmltidy.ini, htmltidy.cor, htmltidy_source.zip and README.txt.

3. Copy the files htmltidy.dll and htmltidy.ini into the directory \system32. 4. Register the DLL using regsvr32.exe.

After the successful registration of HTMLTIDY the server-side installation is complete.

Configuration in the R/3 System Setting Up Services on the R/3 Application Server In this Customizing activity, you set up background processes for scheduling export jobs, analyzing contents to be exported, and exporting contents to the Windows 2000 host on which the server components of the HTML Export Service are installed. At least three background processes must exist in the R/3 System of the Knowledge Warehouse.

1. Start transaction SI24 in your Knowledge Warehouse.

2. Choose Settings in the Knowledge Warehouse System HTML Export for Generating Static Display Formats System.

12 Dezember 2002


3. The System Settings dialog box appears. To make entries, choose Change Display.

4. If you want to use the same configuration of the HTML Export Service for all languages, leave the Language field blank. Otherwise, choose the language for which you want to configure the HTML Export Service.

5. In the Gateway Server or Gateway Service field, enter the host name or the gateway of the R/3 application server that is used to connect the Windows 2000 Export Server to the R/3 System.

6. In the Scheduler Server, Analysis Server, and Export Server fields, enter the name of your R/3 application server in the form __, where stands for the host name of the application server, stands for the name of the R/3 System, and stands for the system number.

7. In the Scheduler Server: Period field, enter the time period (the number of minutes) after which the scheduler is to check on the Windows 2000 Export Server for inactive export instances that can process jobs to be exported.

Make sure that the time period entered here is at least as long as the general scheduling time period, which is stored in the rdisp/btctime profile parameter (in seconds) for background jobs in the R/3 System.

8. In the Analysis Server: Number of Jobs field, enter the number of jobs that the analysis service is to process at one time.

9. In the Export Server: Number of Jobs field, enter the number of jobs that the export service is to process at one time. The number entered here has to be less than or equal to the number of instances that you set up on the Windows 2000 Export Server (see below).

Language (blank) Gateway Server ds0015 Service sapgw32 Scheduler Server ds0015_KWH_32 Period 2 Analysis Server ds0015_KWH_32 Number of Jobs 5 Export Server ds0015_KWH_32 Number of Jobs 3

Setting Up Export Services on Windows 2000 Export Servers In this Customizing activity, you set up an export service on the Windows 2000 host on which you have installed the server components of the HTML Export Service.


Dezember 2002 13


2. Choose Settings in the Knowledge Warehouse System HTML Export for Generating Static

Display Formats Server. 3. Choose Create Destination.

4. The system automatically assigns a destination number to the export service. This number has to correspond to the destination of the ini file sapiwexp.ini (for example, 001).

5. Enter the host name of the Windows 2000 host in the Server field and a short description in the Server Name field.

6. In the Inst. field, enter the number of export service instances that you want to run on this host.

7. In the Active field, set the Active (x) indicator to activate the export service.

8. In the Exp. Path field, enter the path for the jobs to be exported (input).

9. In the Con. Path field, enter the path for completed jobs (output). The directory has to be created manually on your server.

10. In the Trace field, choose the trace level for the export service.

11. Save the data.

Dest. No. 1 Server p12345 Server name Export server for German Inst. 3 Active Active Exp. Path C:\Export Con. Path C:\Consolidate Trace 0

Assigning Export Jobs to Windows 2000 Export Servers In this Customizing activity, you define assignment rules that are used to assign specific contents to be exported to specific Windows 2000 Export Servers (destinations).


2. Choose Settings in the Knowledge Warehouse System HTML Export for Generating Static Display Formats Assignments.

3. Choose Create Destination.

4. Define the contents to be exported to a specific server by making appropriate entries in the following fields: (information) Area, R/3 Release, (source) Language, Enhancement, (enhancement) Release, Technical Name (of folders), and so on. If you do not fill these fields, all contents are exported to the specified destination.

5. In the Dest. No. field, use the input help to choose the destination to which the contents specified are to be exported.

6. Save the data.

Note The Priority and Variant fields are only relevant if you have activated automatic instantiation of contents that were imported into a dedicated Knowledge Warehouse consolidation system (see below).

14 Dezember 2002


If you have installed and configured more than one export server (destination), you can define multiple assignment rules and assign different contents to different export servers.

Automatic Instantiation After Content Import In this Customizing activity, you can specify that contents are to be automatically instantiated as soon as they have been imported into the R/3 System.

This option is not normally relevant. Note that the runtimes for content imports are greatly increased.


2. Choose Settings in the Knowledge Warehouse System HTML Export for Generating Static Display Formats Automatic Instantiation After Import.

3. Select Automatic Instantiation.

4. Choose Save.

Adding HTML Export Number Areas for File Names In this Customizing activity, you maintain table entries that can be used as two-character prefixes in the file names of compiled HTML files generated by the HTML Export Service. The prefixes identify the Knowledge Warehouse system from which the compiled HTML files originate.


2. Choose Settings in the Knowledge Warehouse System HTML Export for Generating Static Display Formats HTML Export Number Areas for File Names.

3. Enter a number between 80 and 99 and a description.

4. Choose Save.

Selecting a Number Area for HTML Export In this Customizing activity, you select the number that you defined as the file name prefix for compiled HTML files in the preceding activity.


2. Choose Settings in the Knowledge Warehouse System HTML Export for Generating Static Display Formats Selection of a Number Area for HTML Export.

3. Select a number from the input help.

4. Choose Save.

Dezember 2002 15


Configuration on the Windows 2000 Export Server When you have completed the Customizing activities in the R/3 System, you have to make some of the settings that you made in the sapiwexp.ini configuration file on the Windows 2000 Server. Edit the sapiwexp.ini file on the Windows 2000 Server and make the following entries: In the [GATEWAY] section, enter the gateway server (host name of the application server) and the

gateway service (sapgw + instance number of the application server).

In the [IDENTIFICATION] section, enter the destination number of the export server(s) (see Settings in R/3: Transaction SI24: Settings in the Knowledge Warehouse System HTML Export for Generating Static Display Variants Server).

In the[PROGRAM] section, enter the trace level. In the [GLOBAL] section, specify whether you want to keep the source files (this is recommended in

case errors should occur).

[GATEWAY]

; --- Host (R/3 application server triggering the HTML Export Service)

Host = "ds0015"

; --- Service (consists of "sapgw" + )

Service = "sapgw32"

[IDENTIFICATION]

; --- Destination ID (as specified in the server settings of SI88 or SI24)

Destination = "001"

[PROGRAM]

; --- Trace level

; 3 = Trace errors, warnings, and info

; 2 = Trace errors and warnings

; 1 = Trace errors

TraceLevel = 0

[GLOBAL]

; --- Keep the exported source files in the file system?

; 1 = Keep source files, 0 = Do not keep source files

KeepSourceFiles = 1

You have to start the HTML Export Service manually by choosing Start -> Programs -> SAP HTML Export Services -> SAP HTML Export Services. Both the sapiwexp.exe and the saphttp.exe then appear in the task manager of the Windows 2000 Server.

The R/3 jobs are then started in transaction SI88 from the following menu:

HTML Export > Scheduler Job HTML Export > Analysis Job HTML Export > Export Job.

16 Dezember 2002


According to the definition of the servers (transaction SI24), other instances and therefore other processes of sapiwexp.exe and saphttp.exe are now started. In transaction SI88, you can also select and release folders for export.

Uninstalling the HTML Export Service Prerequisites You are logged on to the operating system locally with administrator rights. You have stopped the processes sapiwexp.exe and saphttp.exe using the Task Manager. Procedure

1. Choose Start -> Settings ->Control Panel -> Add/Remove Programs.

2. A list of programs that can be removed automatically from the computer is displayed in the following dialog box.

3. Select the SAP HTML Export Services entry.

4. Choose Change/Remove.

The uninstall program is started.

5. Confirm the confirmation prompt.

Dezember 2002 17


6. The HTML Export Service uninstall process is started. The progress of the uninstall process is shown graphically. The process can take some time.

If you are not sure whether files may be used by other programs, choose No to All.

7. When the uninstall process is complete, an appropriate message is displayed.

18 Dezember 2002


Dezember 2002 19

8. Choose OK.

The HTML Export Service uninstall process is complete.

HTML Export ServicePurpose

HTML Export Service - Installation RequirementsHardwareSoftware

Executing the HTML Export Service Setup-ProgramPrerequisitesProcedureConfiguration on the Windows 2000 Export Server

Uninstalling the HTML Export ServicePrerequisitesProcedure

Documents

EXPSRV_E