Installation Guide for SAP Business One on MetaFrame Presentation Server 3.0 SAP Business One requires five logical components (Figure 1). This document will focus on installing SAP Business One Client on the MetaFrame Presentation Server 3.0 running on Windows 2000/2003 with Terminal Services Enabled. The Installation of SAP Business One, SAP Business One License Server, and database components can be found in the SAP Business One administration guide. This documentation will focus on the installation of the SAP Business One client running on Citrix MetaFrame Presentation Server 3.0. Order of Installation

1. SAP Business One License Server 2. SQL/DB2/SYBASE Database Server 3. SAP Business One 4. Citrix MetaFrame Presentation Server running SAP Business One client 5. ICA Client running on the workstation

CitrixPresentation Server 3.0Running

SAP Business One Client

SAP Business One

Server

DatabaseWorkstationsRunning

ICA Client

SAPBusiness One License Server

Figure 1: SAP Business One/Citrix Architecture In this configuration, the SAP Business One server and the Citrix Presentation Server are installed on different machines. The SAP Business One client is installed on the Citrix Presentation Server and sessions to the SAP Business One application are opened from any machine installed with a Citrix client. The ICA clients can be downloaded from Citrix support page http://www.citrix.com/site/SS/downloads/downloads.asp?dID=2755. Note: The proper installation order must be followed for successful installation of SAP Business One. Refer to the Business One systems setup guide, Business One license model, and Business One solutions guide for additional information.

Installing SAP Business One Client Administrators can install SAP Business One Client after installing SAP Business One Server and SAP Business One License Server. For additional information, please refer to the Business One Administration Guide. Application installation and configuration: When installing an application manually on the terminal server, change the mode of the installation. Change the mode on the server by using Add/Remove Programs or changing the mode at the command prompt after installing the application. Installing using Add/Remove Program When installing an application manually on a Citrix server, you need to change the mode of the installation. This is accomplished with the following steps:

1. Click Start Control Panel Add Remove programs. 2. Click Add New Programs. 3. Click the CD or Floppy button, click Next, navigate to the location of the

application and install the Business One client. 4. Execute the Business One client installation steps. 5. Do not reboot the server! Click Next at the After Installation Window. 6. Click Finish at the Finish Admin Installation Window. 7. Reboot the server if required.

Installing using the Command Prompt When installing an application manually on a Citrix server, change the mode of the installation. This can be accomplished with the following steps.

1. Open a command prompt. 2. Map a network drive (if it’s a network share) for the installation to avoid

complications later on; otherwise, utilize the CD-ROM for installation. 3. Type change user /install at the command prompt. 4. Execute the Business One client installation steps. 5. At the completion of the installation, execute the command Change user/execute.

Business One Client Installation Steps:

1. Run the Client Setup from the SBO_SHR folder on the SAP Business One Server (\\SAP Business One\SBO_SHR\Clients\Client_Setup\Setup.exe).

2. On the Welcome window, choose Next Figure 2

Figure 2: Welcome Screen

3. In the Customer Information window, enter User and Company names and then choose Next. Figure 3

Figure 3: Customer Information

The Existing Database Server Login dialog box appears only if an SA account exists. Enter the SA password, and then choose Next.

MS SQL Server – to avoid security issues, change the default blank password for the SA user.

4. In the Choose Destination Location window, select a destination folder and then choose Next. Figure 4

Figure 4: Destination Location

5. In the Select Program Folder window, select a program folder and then choose Next Figure 5.

6. The Setup wizard starts copying files.

Figure 5: Select Program Folder

7. When the setup process is complete, choose Finish. Figure 6

Figure 6: Finish

To start the application, from Windows Start menu, select Programs SAP Business One SAP Business One. Administrators may have to restart the computer, after the installation is finished.

SAP Front End Patch Installation to Existing GUI

Current Patch Level

Locate the SAP Business One.exe file in the drive letter:\install path \SAP Business One.exe. Right-click the executable and select Properties. From the Version tab, view the file version (for example, 6.70.182.0).

How to Apply the Patch to an Existing GUI

1. Open Internet Explorer. 2. Go to http://service.sap.com/smb/support. 3. Click YES at the prompt. 4. Click OK at the prompt. 5. Type the user name and password to logon to the SAP Software Market Place. 6. Select SAP Business One. 7. Select Upgrades & Patches 8. Select Support Packages & Patches 9. Select your product version. 10. Select Binary Patches. 11. Select your product version. 12. Select Win32. 13. The Main menu lists patch downloads along with the patch level. 14. Select the preferred patch by clicking on the file. 15. Choose to Save the file to start download. 16. Unzip the download file to a temporary directory. 17. Go to Start > Run and type cmd. 18. Type change user /install. 19. Follow the patch instructions located in the ..\Documentation\Setup Guide\. 20. Click Finish when installation is complete. 21. Type change user /execute. 22. Reboot if necessary.

Web Enable the Business One Client

The final process is to publish SAP Business One so the application is made available to users. Application publishing allows an administrator to:

• Increase application deployment controls. • Improve the user experience by eliminating the mechanics of navigating the

users desktop. • Provide shortcuts and icons for application to users.

1. From the Citrix Presentation Server select Start Program Citrix

Management Consoles Presentation Server Console. Figure 7

Figure 7: Accessing Presentation Server Console 2. Right-click Published Application. 3. Enter application name to be published and the description, click Next. Figure 8

Figure 8: Welcome to the Application Publishing Wizard 4. Under Application Type, ensure Application has been selected and the Command

Line and Working Directory are correctly associated with the application. Click Browse and select the executable file that launches SAP business One “C:\Program Files\SAP Manage\SAP Business One\SAP Business One.exe”. Accept the default to Allow this published resource to be accessed externally though MetaFrame Secure Access Manager. Click Next. Figure 9

Figure 9: Specify What to Publish

5. Click Next to accept the default settings. The section allows administrators to add

shortcut icons to the clients start menu or to the client’s desktops. Figure 10

Figure 10: Program Neighborhood Settings 6. Complete the Session Windows Size and the Color fields and click Next. Figure 11

Figure 11: Specify Application Appearance. 7. Specify the ICA Client requirements and click Next. Figure 12

Figure 12: Specify Client Requirements 8. Specify the Concurrent Instances and the CPU level priority and click Next.

Figure 13

Figure 13: Specify Application Limits 9. Specify the Citrix server (s) that hosts the SAP Business One Client. In this

example, select CITRIX-POC2 and click Add. Once the server is moved from available servers to configured servers click NEXT. Figure 14

Figure 14: Specify Servers 10. Specify the users and/or groups which have access to the published applications.

Figure 15

Figure 15: Specify users 11. Click Finish since there are not file type association for SAP Business One.

Figure 16

Figure 16: Specify File Type Associations 12. After the application is published, SAP Business One appears under the published

application folder. Figure 17

Figure 17: Published Applications

Access Published Applications over the Internet 1. Open the browser and type in the FQDN of Citrix MetaFrame Presentation Server

running Web Interface. Login with the username, password and domain credentials and click Log In. Figure 18

Figure 18: Login Screen for Web Interface 2. Click on SAP Business One Icon to access the application over the internet/intranet.

Figure 19

Figure 19: Accessing Published Applications via Web Interface

Web Interface is installed by default during the installation of MetaFrame Presentation Server 3.0. Please refer to the MetaFrame Presentation Server 3.0, Web Interface Server, or Secure Gateway Server installation Guide for more information.

Recommendations: • To get full functionality of the SAP Business One application; copy the entire

SAP Manage folder from the SAP Business One server machine into the My Documents folder on the Citrix client.

• To run add-ons via the Citrix server, register, install or remove add-ons on the

Citrix server only. Once an add-on is installed and registered on the Citrix server, administrators can run it from a Citrix client. The Citrix client is not authorized to install or register add-ons.

• Microsoft Office must be installed on the Citrix server for proper export

functionality with Excel and Word.

• Rename SAPSS.AVI that is located in the \Programs\SAP Manage\SAP Business One folder to remove the Business One animated splash screen during login. Figure 20

Figure 20: Removing the Water-Gif

Additional Information: Citrix Documentation CTX103723: MetaFrame Presentation Server 3.0 for Windows Administrator's Guide CTX102298: Customizing the Web Interface for MetaFrame XP CTX103759: Secure Gateway for Windows Administrator's Guide CTX101892: Application Troubleshooting in a MetaFrame Environment CTX075552: Troubleshooting ICA 32-bit and Web Client Connectivity Issues CTX103701: Network Troubleshooting CTX104144: Advanced Concepts Guide MetaFrame Presentation Server for Windows

Version 3.0 SAP Business One Documentation 622998: Frequently asked questions about SAP Business One 561588: The License Process in SAP Business One 574385: SAP Business One: Installation check 578256: Online request for license keys for SAP Business One 596562: Returning SAP Business One user licenses 614911: Deleting SAP Business One systems