One of the key benefits of the SAP xApp Manufacturing Integration and Intelligence (SAP xMII) is its ultra-thin client architecture that requires zero client administration. SAP xMII clients require a standard Web browser only which minimizes installation and management. No SAP xMII software needs to be installed on any of the client systems. Setup and installation of SAP xMII is performed entirely on your Web server. The client browser does require that a Java Runtime Environment (JRE) plug-in to be installed in order to use the full set of user interface objects. The supported JRE for a client machine is version 1.4.2 from Sun Microsystems, Inc.® (the latest release of 1.4.2 is recommended for the client).
Note: It is not recommended that the server application be installed on a server with a JSDK/JRE version greater than 1.4.2_07.
This SAP xMII installation is optimized to support Microsoft® Internet Information Services (IIS) on Microsoft Windows® 2003; however, Microsoft Windows® 2000 Server may also be used. Support for any non-Windows platforms and/or support for any servlet engine other than that supplied with the product requires special licensing arrangements. There is no end user support for these other platforms.
SPC data analysis requires a database to be installed and configured. The recommended configuration is to install Microsoft SQL Server directly on the Web server.
Note: You do not need a database if you are not using SPC data analysis. The core SAP xMII functionality stores its configuration data in operating system files.
The SPC data analysis option benefits from a high performance CPU.
SAP xMII includes an add-in for Microsoft FrontPage® and one for Macromedia® Dreamweaver® that enables the use of these tools as a unified development environment for your SAP xMII application. Refer to the Installing the FrontPage Add-In section of this topic for more information. If you are using Macromedia® Dreamweaver®, refer to the Installing the Dreamweaver Add-In section of this topic for more information.
Prior to installing SAP xMII, you must ensure that your server meets the following minimum requirements:
|
|
For 1-10 Concurrent Users |
For 11-100 Concurrent Users |
For 101-500 Concurrent Users |
For 501+ Concurrent Users |
|
Processor |
1.8 GHz or faster |
dual processor recommended; 1.8 GHz or faster |
dual processor, 1.8 GHz or faster
|
dual processor, 1.8 GHz or faster
|
|
RAM |
See Web Server Documentation (512 MB minimum recommended) |
See Web Server Documentation (1024 MB minimum recommended) |
See Web Server Documentation (4096 MBytes minimum recommended) |
See Web Server Documentation (8192 MBytes minimum recommended) |
|
Operating System |
Windows 2003 Server -or- Windows 2000 Professional with Service Pack 4 or greater |
Windows 2003 Server -or- Windows 2000 Server with Service Pack 4 or greater |
Windows 2003 Server -or- Windows 2000 Server with Service Pack 4 or greater |
Windows 2003 Server -or- Windows 2000 Server with Service Pack 4 or greater |
|
Web Server Software |
IIS 6.x or 5.x |
IIS 6.x or 5.x |
IIS 6.x or 5.x |
IIS 6.x or 5.x |
|
Java Virtual Machine |
Sun JSDK 1.4.2_07 |
Sun JSDK 1.4.2_07 |
Sun JSDK 1.4.2_07 |
Sun JSDK 1.4.2_07 |
|
File System |
NTFS |
NTFS |
NTFS |
NTFS |
The required system resources vary based on your applications; however, for sizing purposes, an estimated 2-4 MB per simultaneously connected user can be used.
Virtually any Web browser, including Microsoft Internet Explorer, Netscape® Navigator, Netscape® Communicator, Opera®, and Mozilla® Firefox®, can be used with SAP xMII. We recommend that you use the most recent versions of these products. As stated above, the client should have the Sun JRE plug-in installed to the browser.
The Sun® Java Runtime Environment (JRE) must be installed on the server prior to the SAP xMII installation (It is recommended that you download and install the full JSDK, instructions can be found below).
Note: Turn off the Java automatic update mechanism via the Java Plug-in Control Panel.
It is strongly recommended, although not required by SAP xMII, that the local volume where you are installing SAP xMII be formatted with the NTFS file system. This will enable a high degree of security control over your Web page content via direct integration with the Windows NT or Windows 2000 and IIS security and authentication subsystems.
If you will be using the SAP xMII FrontPage add-in, you must be running Microsoft FrontPage 2000 and must have the FrontPage 2000 server extensions installed on your Web server. Refer to the FrontPage section for detailed instructions on how to install these products.
You will need to obtain a license file in order to run SAP xMII. You may request a license file at http://support.lighthammer.com, or through support@lighthammer.com. See the license manager section of the help for more information.
The Sun JSDK 1.4.2_07 must also be downloaded and installed on the server prior to installing SAP xMII. You can download the JSDK directly from http://java.sun.com/products/archive/j2se/1.4.2_07/index.html. Press on the "Download J2SDK" link on this page, save it to disk, and install the JSDK. A link to this site is also available on the xMIIInstall.htm on the root directory of the installation media (see below step by step instructions for more information).
In IIS, you will need a virtual scripts directory created. From within Internet Information Services (IIS) Manager under Administrative Tools, go to your web site where you wish to install SAP xMII (typically the Default Web Site). If the virtual directory does not exist, create it directly under the InetPub directory where IIS is installed (by default, this would be C:\Inetpub\Scripts). It should have Read permissions, and Execute Permissions of Scripts and Executables. To check this, right click on the directory, and select Properties.
You must install a Web server prior to installing SAP xMII. Microsoft Web Server 4.0 is available as a free add-on to Windows NT Server or Workstation as part of the Windows NT 4.0 Option Pack. You can download the option pack or get it on CD-ROM from your local Microsoft reseller. If you are installing SAP xMII on an Windows NT Server system, you will install IIS 4.0. If you are installing SAP xMII on a Windows NT Workstation machine, you will install Personal Web Server (PWS) 4.0.
Detailed information on installing IIS is provided with the Windows NT Option Pack. During the NT Option Pack installation it is important to select the Custom installation option and verify that the following components are selected for install:
Internet Information Server (IIS)
Internet Service Manager
If you will be using ODBC data sources, it is suggested that you obtain the latest Microsoft Data Access Components from the Microsoft Data Access Web site and install them on your Web server. Note that these are not required to access Microsoft SQL Server or Oracle, as SAP xMII will install direct, high-performance drivers for these databases.
If you are running Windows NT 4.0 and Internet Explorer 4.x on your Web server, it is recommended that you update certain system files before installing SAP xMII. It is advised that you run a Windows Update and install all recommended updates before proceeding.
Note: Installation of IIS may cause the removal or overwrite of some of the Windows NT Service Pack components. It is recommended that you reinstall Service Pack 6a or greater on NT systems, prior to proceeding to the installation of the SAP xMII application.
If you are installing SAP xMII on an MS Windows 2000 Server system, you will install IIS 5.0. If you are installing SAP xMII on an MS Windows 2000 Professional system, then you will install Personal Web Server (PWS) version 5.0. Microsoft Windows 2000 will typically install the IIS 5.0 components you will need to run SAP xMII.
The Microsoft Web servers for Windows 2000 systems are available as part of the installation process of the operating system. If you already have the operating system installed, without the Web server, you may run the additional setup required by choosing "Add/Remove Windows Components" after starting the Add/Remove Programs service available within Control Panel (Internet Information Services (IIS) is the required component).
If you will be using ODBC data sources, it is suggested that you obtain the latest Microsoft Data Access Components from the Microsoft Data Access Web site and install them on your Web server. Note that these are not required to access Microsoft SQL Server or Oracle, as SAP xMII will install direct, high-performance drivers for these databases.
Note: Installation of IIS may overwrite or cause the removal of some of the Windows 2000 service pack components. It is recommended that you reinstall Service Pack 4 or greater on Windows 2000 systems, prior to proceeding to the installation of the SAP xMII application.
By default, Windows 2003 Server has certain locked capabilities that must be changed after SAP xMII installation in order for SAP xMII to run. You must create a virtual directory in IIS with the proper privileges so that the servlet engine will run. Complete the Additional Steps for Windows 2003 section after the Step-by-step Installation.
Microsoft Windows XP Professional is not a supported server platform for production environments. It should be used for demonstrations and limited evaluations only.
If you are installing SAP xMII on a Microsoft Windows XP Professional system, you will install IIS 5.1. IIS is not installed by default with the operating system. You will have to go to the Add/Remove Windows Components section and choose to install it. Select the World Wide Web Service and press Details, then check the Scripts Virtual Directory.
When installing IIS, you MUST do a custom install and choose to install the Scripts Virtual Directory. Without this virtual directory SAP xMII WILL NOT run. Additionally, if you have installed any Windows XP Service Packs, it will be necessary to reinstall them after adding IIS.
If you are using SQL Server 2000, you should have Windows XP service pack 2 and SQL Server 2000 service pack 3 installed.
For a new installation, see Installing SAP xMII.
For an upgrade from an ISAPI version, see Installing SAP xMII: Upgrading from an ISAPI Version.
For an upgrade from an AS version, see Installing SAP xMII: Upgrading from an AS Version.
If you do not know if you have an ISAPI or AS version installed, complete the following steps:
Go to Control Panel -> Administrative Tools -> Services.
If the ServletExec service appears in the list, an AS version is installed. Otherwise, an ISAPI version is installed.
Complete the following steps to allow the servlet engine to run as a recognized Web service extension.
Choose the Web Service Extensions folder.
Click Add a new Web service extension.
The New Web Service Extension window appears.
Enter ServletExec as the extension name, and click
Add.
The Add file window appears.
Browse to the C:\Inetpub\Scripts location and select ServletExec_Adapter.dll as the required file.
Select the Set extension status to Allowed check box.
Click the OK button.
The SAP xMII add-in for Microsoft FrontPage 2000 and Microsoft FrontPage 2002 is installed in the \Lighthammer\Illuminator\Wizards directory on the drive on which you installed the SAP xMII application.
In order to use the add-in, it must be installed on each PC that will be running FrontPage. On computers other than the Web server, a Web package installation is available on the SAP xMII Web server: http://<servername>/Lighthammer/WizardInstall/IlluminatorWizard.exe. You can save the file locally and run it, or you can select Open and run it directly from the Web server.
Note: Windows 2003 Server requires the FrontPage 2002 Server extensions.
Once the file is installed (the default is <SysDrive>:\Lighthammer\Illuminator\Wizards), open FrontPage. Select the /Tools/Add-Ins menu option. If you already had a previous version of the Add-in installed (prior to Illuminator 9.5) highlight the SAP xMII Wizard selection and press the Remove button. If this is a new install, skip to the enable step below.
To enable the new add-in, click the Add button, and browse to the location where the Illum10FPWizard.dll file resides (the default location is <SysDrive>:\Lighthammer\Illuminator\Wizards).
The add-in is automatically loaded each time FrontPage is started. The add-in includes the SAP xMII Object, the Script Assistant, and links to the SAP xMII Template Editor and the System Administration Editor.
The SAP xMII add-in for Macromedia Dreamweaver is installed in the \Lighthammer\Illuminator\Wizards directory on the drive on which you installed the SAP xMII products.
NOTE: In order to use the add-in, this file must be installed on each PC that will be running Dreamweaver. On computers other than the Web server, a Web package installation is available from the SAP xMII Web server: http://<servername>/Lighthammer/WizardInstall/IlluminatorWizard.exe
Use the following steps to enable the Dreamweaver add-in:
Copy the C:\Lighthammer\Illuminator\Wizards\IllumDWWizard.dll file to your local installation of the Dreamweaver MX program, JSExtensions directory (the default is C:\Program Files\Macromedia\Dreamweaver MX\Configuration\JSExtensions).
Copy the C:\Lighthammer\Illuminator\Wizards\Illuminator Object.htm file to C:\Program Files\Macromedia\Dreamweaver MX\Configuration\Commands.
Copy the C:\Lighthammer\Illuminator\Wizards\Illuminator Script Assistant.htm file to C:\Program Files\Macromedia\Dreamweaver MX\Configuration\Commands.
You should then be able to go into Dreamweaver and find the links at the bottom of the Command menu. If selecting SAP xMII Object does not display the plug-in, open a command prompt and type "cd\Lighthammer\Illuminator\Wizards" to navigate to the folder where the DLLs are located. Then type "regsvr32 IllumDWWizardGUI.dll" which should register the dll. Dreamweaver should then prompt you for the SAP xMII server name or internet protocol (IP) address (it defaults to localhost) when calling up the plug-in; this is similar to the standalone version of the plug-in.
You can then configure Dreamweaver for editing SAP xMII Report pages (.irpt).
SAP xMII supports the generation of PDF documents for both the documentation of xMII Business Logic Services transactions and user-defined output reports. The third-party library used for PDF processing is named iText. Version 1.2.3 has been tested with the system; therefore, it is the recommended version. For more information on iText, see www.lowagie.com/iText. The PDFActions.jar and component XML file are included in the SAP xMII build. However, in order to use PDF processing, you must complete the following steps:
Download the iText library version 1.2.3 via http://prdownloads.sourceforge.net/itext/itext-1.2.3.jar?download.
The file must be placed in two locations. Rename the file as iText.jar and save it to ServletExec AS/se-xMII/webapps/default/Lighthammer/CMSLogicEditor and ServletExec AS/se-xMII/webapps/default/Lighthammer/WEB-INF/lib. The PDFActions.jar should already exist in both locations.
Note: The iText.jar file is case sensitive. It must match the entry in the XML file.
Move the PDFComponentCatalog.xml file from Lighthammer/Xacute/Components/optional to Lighthammer/Xacute/Components.
Restart the Servlet Exec AS service.
The PDF Actions option will then appears in the xMII Logic Editor navigation menu, and the File menu includes the Generate Documentation option for the transactions.
By default, SAP xMII starts up (initializes) when the NT Service starts up. There is a time delay for the initialization in order for various system services to start up as before SAP xMII initializes. It is important that the timing is correct. The default delay is 30 seconds. This can easily be changed if it is causing problems. A symptom of this problem is a class not found error in the Servlet Exec logs, because not all systems were initialized before SAP xMII was started, causing some paths to be incorrect.
Until the delay time is complete, it is recommended that you do not attempt to query SAP xMII. This includes accessing the SAP xMII main menu. Keep in mind that the delay is in addition to the delay caused by the NT Service start up time. See the Server Logging section to see how to access the Servlet Exec Logs. See the section on SAP xMII Initialization in the system configuration guide for more information on this topic.
In order for SAP xMII to operate correctly, the system clocks on the Web server, data servers, and client browsers should be maintained in reasonably close synchronization.
In the case where other applications on the Web server prevent the enabling of automatic daylight savings time adjustment, you must configure the time zone to use the option that does not include the auto adjust checkbox [e.g., use the (GMT-05:00) Bogota, Lima, Quito time zone instead of the (GMT-05:00) Eastern Time (US & Canada) time zone].
If SAP xMII is run on a port other than port 80, add the port number to the server Start menu shortcuts located in the Webapps\Default\Lighthammer and Webapps\Default\LHSecurity directories.
There are three installation logs created when installing SAP xMII. If you experience problems during your installation or have questions about installation locations, you can review these log files.
SAP_xMII_Install_date_time.log is an overall general log file for the installation located in the Lighthammer\Logs directory.
CMSServicesInstall_date_time.log contains details relating to the installation of your SAP xMII services and is located in the Lighthammer\Logs directory.
xMIISecurityInstall_date_time.log contains details relating to the installation of Security Manager and is located in the Lighthammer\Logs directory.