BES Installation Guide. Enterprise Server 6.5

Transcription

1 BES Installation Guide Enterprise Server 6.5

2 Borland Software Corporation 100 Enterprise Way Scotts Valley, California Borland Software Corporation may have patents and/or pending patent applications covering subject matter in this document. Please refer to the product CD or the About dialog box for the list of applicable patents. The furnishing of this document does not give you any license to these patents. COPYRIGHT Borland Software Corporation. All rights reserved. All Borland brand and product names are trademarks or registered trademarks of Borland Software Corporation in the United States and other countries. All other marks are the property of their respective owners. This product includes software developed by the Apache Software Foundation ( This product includes software developed by Steve Viens and contributors. All rights reserved ( This product includes software developed by the MX4J project. All rights reserved ( BES0065WW PDF

3 Contents Chapter 1 Introduction to Borland Enterprise Server (BES) 1 BES Products and Editions overview AppServer Edition AppServer Edition features VisiBroker Edition VisiBroker Edition features Borland Enterprise Server Documentation Accessing BES online help topics in the standalone Help Viewer Accessing BES online help topics from within a BES GUI tool Documentation conventions Platform conventions Contacting Borland support Online resources World Wide Web Borland newsgroups Chapter 2 Planning your installation 7 Package contents System requirements JDK Web Disk space requirements Licensing What's next? Chapter 3 Installing BES on Windows 11 Preparing for installation JDK Installing Borland Enterprise Server Install log Product documentation Installing a standalone Borland Management Console Installing more than one BES instance Configuring VisiBroker C++ server, VisiTransact, or VisiNotify license variables Borland product registration wizard Migrating an existing 6.0 license Direct registration registration Web page registration Telephone registration Uninstalling Borland Enterprise Server Chapter 4 Installing BES on Solaris and Linux 21 Installing on other platforms Preparing for installation JDK JRE requirements for Linux download installation Mounting the BES CD on Solaris Preparing to install BES on Linux Installing Borland Enterprise Server Install log Product documentation Installing a standalone Management Console Installing more than one BES instance Running the installer without a GUI Configuring VisiBroker for C++ server, VisiTransact, or VisiNotify license variables Using the setuser tool to manage ownership Usage Examples: Changing the ownership of an installation and supporting files Enabling multi-user mode (MUM) Enabling Managed Objects to start as root while running in MUM Enabling JavaScript support when starting Managed Objects while in MUM Disabling multi-user mode Borland product registration wizard Migrating an existing 6.0 license Direct registration registration Web page registration Telephone registration Uninstalling Borland Enterprise Server Chapter 5 Installing BES Using Silent Installation (Windows, Solaris, Linux) 37 What is silent installation? Preparing for installation Disk space requirements JDK Using silent installation Invoking silent installation on Windows Invoking silent installation on Solaris Invoking silent installation on Linux Properties file for silent installation Sample silent installation properties for Windows Sample silent installation properties for Solaris or Linux Index 43 iii

4 Tables 5.1 Properties File Contents for Silent Installation 40 iv

5 v

6 Chapter 1 1Introduction to Borland Enterprise Chapter Server (BES) Borland Enterprise Server is a set of services and tools that enable you to build, deploy, and manage distributed enterprise applications in your corporate environment. BES Products and Editions overview Borland provides the following Editions of its Enterprise Server in order to better meet your specific deployment requirements: AppServer Edition A leading, certified implementation of the J2EE 1.3 standard, Borland Enterprise Server AppServer Edition supports the latest industry standards such as EJB 2.1, JMS 1.02, Servlet 2.3, JSP 1.2, CORBA 2.6, XML, and SOAP. Borland provides three versions of AppServer Edition, which include leading enterprise messaging solutions for Java Messaging Service (JMS) management (Tibco, SonicMQ, and OpenJMS). VisiBroker Edition For the CORBA developer, Borland provides Borland Enterprise Server VisiBroker Edition, which includes both VisiBroker for Java and VisiBroker for C++ to leverage the industry-leading VisiBroker Object Request Broker (ORB). Both are complete implementations of the CORBA 2.6 specification. Each BES Edition and product is built upon the same server core, and they seamlessly interact with each other. You can choose the degree of functionality and services you need, and if your needs change, it is simple to upgrade your license. See Chapter 3, Installing BES on Windows or Chapter 4, Installing BES on Solaris and Linux for details. AppServer Edition Borland Enterprise Server AppServer Edition allows you to securely deploy and manage all aspects of your distributed Java and CORBA applications that implement the J2EE 1.3 platform standard. With AppServer Edition, the number of server instances per installation is unlimited, so the maximum of concurrent users is unlimited. Chapter 1: Introduction to Borland Enterprise Server (BES) 1

7 BES Products and Editions overview AppServer Edition includes: A complete, certified implementation of J2EE 1.3. Apache Web Server version 2.0 Borland Security, which provides a framework for securing BES. Single-point management of leading JMS management solutions included with BES (Tibco, SonicMQ, and OpenJMS). Strong management tools for distributed components, including applications developed outside of BES. AppServer Edition features AppServer Edition offers the following features: Support for a broad spectrum of enterprise server platforms (please refer to for a list of the platforms supported for BES). Full support for clustered topologies. Seamless integration with the VisiBroker ORB infrastructure. Integration with the Borland JBuilder integrated development environment. Enhanced integration with other Borland products including Borland Together ControlCenter, Borland OptimizeIT ServerTrace, Borland Janeva, and Borland Deployment Op-Center. BES allows existing applications to be exposed as Web Services and integrated with new applications or additional Web Services. Borland Web Services support is based on Apache Axis 1.2 technology, the next-generation Apache SOAP server that supports SOAP 1.2. VisiBroker Edition VisiBroker is for distributed deployments that require CORBA to communicate between both Java and non-java objects. It is available on a wide range of platforms (hardware, operating systems, compilers and JDKs). VisiBroker Edition solves all the problems normally associated with distributed systems in a heterogeneous environment. VisiBroker Edition includes: VisiBroker for Java and VisiBroker for C++, two implementations of the industryleading Object Request Broker. VisiNaming Service, a complete implementation of the Interoperable Naming Specification in CORBA 2.6. GateKeeper, a proxy server for managing connections to CORBA Servers behind firewalls. VisiBroker Console, a GUI tool for easily managing a CORBA environment. VisiBroker Edition features VisiBroker Edition offers the following features: Out-of-the-box security and web connectivity. Seamless integration to the J2EE Platform, allowing CORBA clients direct access to EJBs. A robust Naming Service (VisiNaming), with caching, persistent storage, and replication for high availability. Automatic client failover to backup servers if primary server is unreachable. 2 BES Installation Guide

8 Borland Enterprise Server Documentation Load distribution across a cluster of CORBA servers. Full compliance with the OMG's CORBA 2.6 Specification. Integration with the Borland JBuilder integrated development environment. Enhanced integration with other Borland products including Borland Janeva and Borland Deployment Op-Center. Borland Enterprise Server Documentation The BES documentation set includes the following: BES Installation Guide describes how to install BES on your network. It is written for system administrators who are familiar with Windows or UNIX operating systems. BES Developer's Guide provides detailed information about packaging, deployment, and management of distributed object-based applications in their operational environment. Borland Management Console User's Guide provides information about using the Borland Management Console GUI. Borland Security Guide describes Borland's framework for securing BES, including VisiSecure for VisiBroker for Java and VisiBroker for C++. BES VisiBroker for Java Developer's Guide describes how to develop VisiBroker applications in Java. It familiarizes you with configuration and management of the Visibroker ORB and how to use the programming tools. Also described is the IDL compiler, the Smart Agent, the Location, Naming and Event Services, the Object Activation Daemon (OAD), the Quality of Service (QoS), and the Interface Repository. BES VisiBroker for C++ Developer's Guide describes how to develop VisiBroker applications in C++. It familiarizes you with configuration and management of the Visibroker ORB and how to use the programming tools. Also described is the IDL compiler, the Smart Agent, the Location, Naming and Event Services, the OAD, the QoS, and the Interface Repository. BES VisiBroker for C++ API Reference provides a description of the classes and interfaces supplied with VisiBroker for C++. BES VisiBroker VisiTime Guide describes Borland's implementation of the OMG Time Service specification. BES VisiBroker VisiNotify Guide describes Borland's implementation of the OMG Notification Service specification and how to use the major features of the notification messaging framework, in particular, the Quality of Service (QoS) properties, Filtering, and Publish/Subscribe Adapter (PSA). BES VisiBroker VisiTransact Guide describes Borland's implementation of the OMG Object Transaction Service specification and the Borland Integrated Transaction Service components. BES VisiBroker VisiTelcoLog Guide describes Borland's implementation of the OMG Telecom Log Service specification. BES VisiBroker GateKeeper Guide describes how to use the VisiBroker GateKeeper to enable VisiBroker clients to communicate with servers across networks, while still conforming to the security restrictions imposed by web browsers and firewalls. The documentation is typically accessed through the Help Viewer installed with your BES product. You can choose to view help from the standalone Help Viewer or from within a BES GUI tool. Both methods launch the Help Viewer in a separate window and Chapter 1: Introduction to Borland Enterprise Server (BES) 3

9 Documentation conventions Important give you access to the main Help Viewer toolbar for navigation and printing, as well as access to a navigation pane. The Help Viewer navigation pane includes a table of contents for all BES books and reference documentation, a thorough index, and a comprehensive search page. Updates to the product documentation, as well as PDF versions, are available on the web at Accessing BES online help topics in the standalone Help Viewer To access the online help through the standalone Help Viewer on a machine where the product is installed, use one of the following methods: Windows Choose Start Programs Borland Deployment Platform Help Topics UNIX Tip or, open the Command Prompt and go to the product installation \bin directory, then type the following command: help Open a command shell and go to the product installation /bin directory, then enter the command: help During installation on UNIX systems, the default is to not include an entry for bin in your PATH. If you did not choose the custom install option and modify the default for PATH entry, and you do not have an entry for current directory in your PATH, use./ help to start the help viewer. Accessing BES online help topics from within a BES GUI tool To access the online help from within a BES GUI tool, use one of the following methods: From within the Borland Management Console, choose Help Help Topics From within the Borland Deployment Descriptor Editor (DDEditor), choose Help Help Topics From within the VisiBroker Console, choose Help Help Topics The Help menu also contains shortcuts to specific documents within the online help. When you select one of these shortcuts, the Help Topics viewer is launched and the item selected from the Help menu is displayed. Documentation conventions The documentation for BES uses the typefaces and symbols described below to indicate special text: Convention italics computer Used for Used for new terms and book titles. Information that the user or application provides, sample command lines and code. bold computer In text, bold indicates information the user types in. In code samples, bold highlights important statements. [ ] Optional items.... Previous argument that can be repeated. Two mutually exclusive choices. 4 BES Installation Guide

10 Contacting Borland support Platform conventions Contacting Borland support The BES documentation uses the following symbols to indicate platform-specific information: Windows: All supported Windows platforms. Win2003: Windows 2003 only WinXP: Windows XP only Win2000: Windows 2000 only UNIX: UNIX platforms Solaris: Solaris only Linux: Linux only Borland offers a variety of support options. These include free services on the Internet where you can search our extensive information base and connect with other users of Borland products. In addition, you can choose from several categories of telephone support, ranging from support on installation of Borland products to fee-based, consultant-level support and detailed assistance. For more information about Borland's support services or contacting Borland Technical Support, please see our web site at: and select your geographic region. When contacting Borland's support, be prepared to provide the following information: Name Company and site ID Telephone number Your Access ID number (U.S.A. only) Operating system and version Borland product name and version Any patches or service packs applied Client language and version (if applicable) Database and version (if applicable) Detailed description and history of the problem Any log files which indicate the problem Details of any error messages or exceptions raised Online resources You can get information from any of these online sources: World Wide Web Online Support Listserv (access ID required) To subscribe to electronic newsletters, use the online form at: Chapter 1: Introduction to Borland Enterprise Server (BES) 5

11 Contacting Borland support World Wide Web Check regularly. The BES Product Team posts white papers, competitive analyses, answers to FAQs, sample applications, updated software, updated documentation, and information about new and existing products. You may want to check these URLs in particular: (updated BES AppServer Edition software and other files) (updated BES VisiBroker Edition software and other files) (documentation updates and PDFs) (Borland Enterprise Server and Borland Deployment Op-Center FAQs) (contains our web-based news magazine for developers) Borland newsgroups You can participate in many threaded discussion groups devoted to the Borland Enterprise Server products. Visit for information about joining user-supported newsgroups for Enterprise Server and other Borland products. These newsgroups are maintained by users and are not official Borland sites. 6 BES Installation Guide

12 Chapter 2 2Planning your installation Chapter Important This guide describes installation and installation-related tasks for installing Borland Enterprise Server (BES) on Windows, UNIX, and Linux. Go to for documentation updates and more information. Some recommendations: You can install the Borland Management Console separately. Typically, you install BES on a large shared UNIX or Windows machine. We recommend you install the Management Console on any machine you use to view, modify or manage your distributed applications. Installing the product documentation (online Help Topics) and/or the examples is optional, however, Borland recommends you install both. Package contents The package contains the Borland Deployment Platform CD and product documentation. Your package may include additional product CDs that ship with Borland Enterprise Server. You can also download the Borland Software from the Borland web site: System requirements For the latest information on platforms supported by Borland Enterprise Server and for JDK requirements, please refer to the Borland web site: techpubs/bes/platforms In addition to platform-specific requirements, the Borland Enterprise Server components use TCP and UDP Broadcast services to communicate. Even if you are running the components on a single machine you must have TCP and UDP services available. Chapter 2: Planning your installation 7

13 Disk space requirements JDK The installer installs JDK versions and on Windows, and JDK on UNIX platforms. The Borland Enterprise Server infrastructure and tools use JDK Web Disk space requirements To use the Web engine and Web Administration Tool included with BES, you need one of the following web browsers: Netscape Navigator, version 4.6 or later Microsoft Internet Explorer, version 5.0 or later Important For disk space requirements, refer to The disk space requirements can be affected by: operating system JDK Licensing There are two types of BES licenses: Node-locked licenses. These licenses are locked to the system on which they are applied and activated. You cannot copy these licenses to another system, and they cannot be accessed from a BES product running on another system. If you reinstall the software on the same system, you will need to reactivate the license. Network licenses. These licenses require the use of a license server. BES supports the use of either Belise (Borland's license server), or FlexLM, a popular third-party license server found in many IT environments. Refer to the instructions in the you receive from Borland for activating and using your network licenses. BES node-locked licenses must be registered and activated before using the product. To apply node-locked licenses you will need the following: The Serial Number and Key, or the activation file for each license. These will arrive in an from Borland. A Borland Developer Network (BDN) account. If you don't have an account, you will be able to create it during the registration/activation process described in Installing BES on Windows on page 11 and Installing BES on Solaris and Linux on page 21. Internet access. This is required if you want to use the Direct or Web page methods for activating your license. This can be from any system - not necessarily the system on which your product is installed. If you are applying a license to a remote system, you must have Telnet access to that system and some way to copy (that is, FTP) the activation file to that system. 8 BES Installation Guide

14 What's next? What's next? Once you've planned your network installations, you are ready to install BES. If you are installing on Windows, see Chapter 3, Installing BES on Windows. If you are installing on UNIX, see Chapter 4, Installing BES on Solaris and Linux. Chapter 2: Planning your installation 9

15 10 BES Installation Guide

16 Chapter 3 3Installing BES on Windows Chapter Important This section describes how to install Borland Enterprise Server (BES) and related components on Windows. If you are installing on Solaris or Linux, see Chapter 4, Installing BES on Solaris and Linux. For documentation updates, go to We recommend uninstalling any previous versions of BES, or installing the new version to a different location; on a different install path. For more information on installing multiple servers, see Installing more than one BES instance on page 16. If you have already installed an evaluation version and have since purchased a license to use BES on a permanent basis, you do not need to reinstall the version of the software you evaluated. You can use the License Manager (launched from the Tools menu in the Management Console) to remove your evaluation license, then add and activate your new, permanent license. For information on activating your new license, see Borland product registration wizard on page 16. Preparing for installation You can install BES from the CD or download the software from the Borland web site Before you install BES: 1 Exit all applications. 2 Select an installation method: If you want to download a version of the product from the Borland web site go to If you are installing from CD, place the CD into your CD-ROM drive. If you want to perform a silent installation using definitions from a properties file, see Chapter 5, Installing BES Using Silent Installation (Windows, Solaris, Linux). Chapter 3: Installing BES on Windows 11

17 Installing Borland Enterprise Server JDK The installer installs JDK versions and on Windows. The BES infrastructure and tools use JDK For information about changing a Partition's JDK after you have completed the product installation, go to Changing the JDK in the Using Partitions section of the BES User's Guide. For updates on JDK requirements for Windows and for VisiBroker, please refer to the Borland web site, Installing Borland Enterprise Server Important Important To install BES and related components: 1 You can download the BES installer from the web or install from CD. If you are installing from CD and autorun is enabled on your system, the installer automatically starts when you insert the CD into your CD-ROM drive. If you are installing a BES installer downloaded from the web, double-click the downloaded executable to start the installation. Follow the onscreen instructions. For most options, defaults offered by the installation wizard are acceptable. You can use the Previous button to return to earlier screens and change any information that is incorrect. 2 Select the Borland Deployment Platform product you want to install: Once you select which product you are installing and click Next, to select a different product, you must cancel the current installation and restart the installation process. BES AppServer Edition with Tibco. Installs the entire Borland Enterprise Server, which includes VisiBroker core functionality, plus support for integrated management of Java Messaging Services (JMS) through Tibco. BES AppServer Edition with SonicMQ. Installs the entire Borland Enterprise Server, which includes VisiBroker core functionality, plus support for integrated management of JMS through SonicMQ. BES AppServer Edition with OpenJMS. Installs the entire Borland Enterprise Server, which includes VisiBroker core functionality, plus support for integrated management of JMS through OpenJMS. BES VisiBroker Edition. Installs the VisiBroker Java and C++ Core, development and management tools, and optional VisiBroker Extended Services. 3 License agreement. Installation and use of BES requires acceptance of the license agreement. 4 Choose Install Folder. This creates a new installation of BES, or adds components to an existing 6.5 installation. Either accept the default (C:\Borland\BDP) or choose another location. You cannot install this version of BES on top of previous releases. 5 Choose Product Components. Depending on the Borland Deployment Platform product you are installing, select from the following product components for each feature set: a Borland Enterprise Server AppServer Edition Management Console. GUI and tools for managing services and Partitions. For information about installing only the Management Console, go to Installing a standalone Borland Management Console on page 15. Server. All server components, such as the Partition, Apache Web server, JDataStore, and VisiBroker. 12 BES Installation Guide

18 Installing Borland Enterprise Server b Client. Components for client applications (EJB client and CORBA client). Documentation. Suite of online documentation. Examples. Example applications for Borland Enterprise Server. Borland Enterprise Server VisiBroker Edition VisiBroker Console. GUI and tools for managing VisiBroker ORB and services. VisiBroker Core. VisiBroker for Java and C++ development tools and server components. Documentation. Suite of online documentation. Examples. Example applications for Borland Enterprise Server. VisiBroker Extended Services. Optional components you purchase for extended VisiBroker functionality. VisiBroker Op-Center Management Pack. Adds features for managing VisiBroker through Borland Deployment Op-Center. VisiBroker Web Services Pack (VisiExchange). Web services support, Apache web server, Borland web container, IIOP connector, redirector, JDataStore, and support for JDBC datasources. 6 Choose VisiBroker Extended Services. If you chose the option to install the VisiBroker Extended Services you purchased, select from the following extended services: VisiNotify. An industrial strength, ORB-level implementation of the OMG Event/ Notification Service. VisiSecure. A framework for establishing secure connections between clients and servers. VisiTime. A complete implementation of the OMG Time Service Specification, Version 1.1. VisiTransact. A complete implementation of the OMG transaction management solution for transactions with CORBA applications over the Internet or intranets. VisiTelcoLog. An OMG compliant implementation of the OMG Telecom Log Service specification version Choose Install Type. Typical/Custom panel: a Typical. Express install - uses default settings. The installer generates the BES example configuration, which is comprised of different example Partitions, and their supporting services. In addition, the typical installation includes the following defaults: Smart Agent port. Also known as the osagent. This port is used by the ORB to communicate with the server. You can use the Management Console to change the Smart Agent port after installation is completed. The default is Management port. The port BES listens to for management functionality in the Management Console. You can use the Management Console to change the Smart Agent port (sometimes referred to as the user port ) after installation is completed. The default is Agent name. Every agent using the same Smart Agent (osagent) port should have a unique name. The default is the host name. The value(s) you enter for the port(s) must be valid for the installation to proceed. Product icons. The typical installation does not install product icons. To install product icons, choose the Custom install type. Chapter 3: Installing BES on Windows 13

19 Installing Borland Enterprise Server Important b Adding the BES bin directory to your PATH variable. The typical installation does not add the BES bin folder to your PATH. To add it, choose the Custom install type. If you select the default, you may have to manually add certain components to your environment path. Adding the VisiBroker environment variables. The typical installation does not add the VisiBroker environment variables to your system environment. If you choose the Custom install type to add the VisiBroker environment variables, the installation sets the BES_LIC_DIR to <install_dir>\var and BES_LIC_DEFAULT_DIR to <install_dir>\license. Custom. This option allows you to set various installation options, such as: Specifying Smart Agent port/ Management port/ Agent name to other than default values (see Choose Install Type. Typical/Custom panel: on page 13 for the default values). Product icons. This allows you to choose a shortcut folder in a new program group, an existing program group, in the Start menu, on the desktop, or in another location. Example management configuration setup. To install BES/BDOC sample management configurations, choose Yes (default). Include bin directory in PATH. The default is No. To add the directory to your PATH, choose Yes. Include VisiBroker environment variables. The default is No. To add the VisiBroker environment variables to your system environment, choose Yes. The installation sets the BES_LIC_DIR to <install_dir>\var and BES_LIC_DEFAULT_DIR to <install_dir>\license. 8 Pre-Installation Summary. Review the displayed information before proceeding with the installation. You can click the Previous button to revisit and change any selections you made except your choice for which product to install. 9 To approve your choices and start installing, click the Install button. 10 Registration. To launch the Borland Product Registration Wizard before exiting the installer, choose Yes (default) and click Next. The Registration Wizard launches in a separate window (see Borland product registration wizard on page 16). After you dismiss the Registration Wizard, the installer completion panel displays. If you are installing an evaluation or free version of BES, you are not prompted to launch the Registration Wizard. Before using BES, copy the license activation key file you receive by from Borland to the <install_dir>\license directory. If you did not receive a license activation key file, or if you are reinstalling the software, go to and download a new license key. You must register and activate your license in order to use the product. If you have a valid, node-locked license for BES 6.0 on the same machine where you installed BES 6.5, use the lmadm command-line tool to migrate your 6.0 license for use with the newly-installed BES 6.5 software (see Migrating an existing 6.0 license on page 17). For information about BES license types, see Chapter 2, Planning your installation. If you want to register and activate your license later, either by running the lmadmw executable found in the <install_dir>\bin directory or by launching the wizard from the Tools menu in the Management Console (see Using the License Manager in Management Console User's Guide). 11 When the installation completes, to dismiss the installer, click Done. 14 BES Installation Guide

20 Install log Install log Product documentation The installer generates an install log that is written to the root of the installation directory if you installed BES from CD, or to the folder where the installer file resides if you used a downloaded file to install BES. The BES AppServer install log file is: <install_dir>\bes_appserver_edition_installlog.xml The BES VisiBroker install log file is: <install_dir>\bes_visibroker_edition_installlog.xml The file is an XML formatted log with installation-specific information, such as errors. The Borland Enterprise Server CD contains a complete library of online documentation. To access the documentation on a machine where the product is installed, use one of the following methods: At the command prompt, use the following command: help To recognize the help command, your path system variable must include the <install_dir>\bin directory, or you can enter the path explicitly. Choose Start Programs Borland Deployment Platform Help Topics From within the Borland Management Console, go to the Help menu From within the DDEditor, go to the Help menu From within VisiBroker Console, go to the Help menu Product documentation updates, HTML and PDF versions are available on the Web: Installing a standalone Borland Management Console Borland Enterprise Server includes a graphical user interface, called the Management Console, which acts as the focal point for managing servers and applications on your network. The server typically runs on a large shared UNIX or Windows machine, while the Management Console runs on any machine from which users want to view or modify the distributed system. Once the Management Console is installed, you can deploy to any server on your network. To install a standalone Management Console: 1 On the Choose Product Components panel, select only the Management Console. 2 On the Choose Install Type panel, choose Custom. 3 When the Configuration Settings screen appears, specify the same Management port as those specified for the server(s) you want the Management Console to support. 4 Complete the installation as described in Borland Enterprise Server AppServer Edition on page 12. Chapter 3: Installing BES on Windows 15

21 Installing more than one BES instance Installing more than one BES instance If you install more than one instance of BES on the same machine: Each server must have completely different install paths; the install directories at the top level must be different. You must modify Management ports with unique port ID numbers to make sure container services are included with each server. Keep the defaults on one server, but change the defaults for all other servers so that they have unique port ID numbers. We recommend you use the Management Console to change port ID numbers. To change Management port numbers: 1 Open the Borland Management Console. 2 Right-click on the Agent whose ports you want to change and select Properties. 3 Enter port numbers as needed. To change Web container port IDs: 1 Open the Borland Management Console. 2 In the navigation tree, expand the Partition whose web container you want to change. 3 Right-click the web container node and select Properties. The Properties tab Service: HTTP/ node displays the connector attributes. 4 To edit port ID properties, enter the values into the table. For information about updating the Borland web container server.xml, go to the BES Developer's Guide Web components section. Configuring VisiBroker C++ server, VisiTransact, or VisiNotify license variables Before running a VisiBroker for C++ server, VisiTransact, or VisiNotify, you need to set two license environment variables (BES_LIC_DIR and BES_LIC_DEFAULT_DIR). During installation, a batch script is created for you to use for setting these environment variables. To set the variables: 1 Open a command window. 2 Change directories to <install dir>\bin. 3 Execute vbroker.bat. Borland product registration wizard Before using BES, you need to register and activate the license you received for your product. The license may be in the form of an from Borland listing one or more serial numbers and license keys, or it may be a license key file sent to you in an from Borland. 16 BES Installation Guide

22 Borland product registration wizard If you have a valid, node-locked license for BES 6.0 installed on the same machine as the newly-installed BES 6.5, use the lmadm command-line tool to migrate your 6.0 license for use with the newly-installed BES 6.5 software (see Migrating an existing 6.0 license on page 17). (For information about BES license types, see Chapter 2, Planning your installation.) If you have already received a key file in an from Borland for a product you purchased online or downloaded for evaluation, or if you downloaded a free version of the product, you can use the registration wizard to apply the key file, or you can copy it to the <install_dir>\license directory and it will be applied automatically when you restart your product. If you have a serial number and key, you can register and activate your BES product using one of the following registration methods: Direct. If your system is connected to the Internet, this is the simplest method. The product registration wizard guides you through all required steps and automatically activates your license for you. For more information, see Direct registration on page You send your registration request via your own account (from any system), and will receive an activation file via that you can apply to your installation. For more information, see registration on page 18. Web page. Similar to , except you register by visiting the Borland web site. For more information, see Web page registration on page 18. Telephone. You provide information to a Borland representative, who will send you an activation file by or mail. For more information, see Telephone registration on page 19. Depending on which method you choose, you may be asked to indicate whether you have a Borland Developer Network (BDN) account. If you do not have an account, you will be prompted to create one in the product registration wizard. If you do not choose the Direct registration method, you will receive an activation file. Simply copy this file into the <install_dir>\license directory and it will be applied automatically when you start your product. Migrating an existing 6.0 license To migrate an existing 6.0 node-locked license after installing 6.5: 1 Open a command shell and invoke the lmadm command-line license tool with the -i console option. Make sure to include the full path to your installation's bin directory. For example: C:/BDP/bin/lmadm -i console 2 Enter the option to Migrate a node locked license. 3 When prompted, enter the full path to your BES 6.0 installation. 4 When prompted, enter the full path to your BES 6.5 installation. 5 When prompted, choose the option to proceed with the migration and overwrite the existing license. This option overwrites any existing licenses found in the BES 6.5 installation path you provided. If you have already applied licenses to your 6.5 installation, migrating a 6.0 license from the same machine will overwrite the licenses you applied. (When BES 6.5 is installed, a placeholder, empty license is also installed. You can safely overwrite this license when migrating a 6.0 node-locked license.) 6 After the completion message is displayed, press Enter to continue. 7 To exit the lmadm command-line tool, enter the Quit option. Chapter 3: Installing BES on Windows 17

23 Borland product registration wizard Direct registration To use the Borland product registration wizard for Direct registration: 1 Select the Direct registration method in the first wizard screen, and click Next. 2 Indicate whether you have a BDN account, and click Next. If you do not have an account you are prompted to create one in this wizard. 3 If applicable, enter proxy settings for you internet connection. 4 Review the summarized information before clicking Next. The wizard monitors and displays the progress of your registration. 5 When registration is successfully completed, click Next. Then click Finish to close the Wizard. registration To use the Borland product registration wizard for registration: 1 In the first wizard screen, select the registration method and click Next. 2 Indicate whether you have a BDN account, and click Next. If you do not have an account you are prompted to create one in this wizard. 3 Review the summarized information before clicking Next. 4 Copy the content of the Registration content pane into an message addressed to reg@borland.com, and click Next. 5 To close the Wizard, click Finish. You will receive a product activation file by . 6 Copy the activation file into the <install_dir>\license directory, and it will be applied automatically when you start your product. Web page registration To use the Borland product registration wizard for Web page registration: 1 In the first wizard screen, select the Web page registration method and click Next. 2 Copy the registration key from the Web Registration step of the wizard, then click Finish to close the Wizard. 3 Start a web browser and open the URL. 4 In the registration web page, enter your BDN account information and click Login. If you do not have an account, click the Create account link ( srs5/new_user.jsp). 5 In the Product Registration web page, enter the Serial Number and the Registration Key (from the registration wizard) and click Continue. 6 Verify the address to which the activation file will be sent, and click Register. You will receive a product activation file by . 7 Copy the activation file into the <install_dir>\license directory, and it will be applied automatically when you start your product. 18 BES Installation Guide

24 Uninstalling Borland Enterprise Server Telephone registration To use the Borland product registration wizard for Telephone registration: 1 In the first wizard screen, select the Telephone registration method and click Next. 2 From the drop-down list, select the location that is nearest you. 3 Click Next, then click Finish to close the Wizard. 4 Dial the number for assistance by telephone and keep the information in the Phone Registration wizard screen on hand. 5 When you receive your activation file, copy it into the <install_dir>\license directory, and it will be applied automatically when you start your product. Uninstalling Borland Enterprise Server To uninstall Borland Enterprise Server: 1 Make sure there are no background processes (such as osagent) running during the uninstall. 2 Open the installation directory. 3 Double-click the Uninstall icon. 4 Click Uninstall to completely remove all components that were installed. This does not remove files and folders that were created after the installation. 5 After you run the uninstall program, check the installation directory and remove any unnecessary files and subdirectories. After uninstalling, there may still be files and folders stored in the user's Documents and Settings (for example,.bdp65) folder. You should delete these as well. Chapter 3: Installing BES on Windows 19

25 20 BES Installation Guide

26 Chapter 4 4Installing BES on Solaris and Linux Chapter Important This section describes how to install Borland Enterprise Server and related components on the Solaris and Linux operating systems. If you are installing on Windows, see Chapter 3, Installing BES on Windows. For documentation updates, go to We recommend uninstalling any previous versions of BES, or installing the new version to a different location; on a different install path. For more information on installing multiple servers, see Installing more than one BES instance on page 27. If you have already installed an evaluation version and have since purchased a license to use BES on a permanent basis, you do not need to reinstall the version of the software you evaluated. You can use the License Manager (launched from the Tools menu in the Management Console) to remove your evaluation license, then add and activate your new, permanent license. For information on activating your new license, see Borland product registration wizard on page 33. Installing on other platforms Preparing for installation For documentation updates and specific instructions on installing BES on platforms other than Windows (32-bit versions), Solaris, or Red Hat Linux (X86), go to You can install BES from the CD or download the software from the Borland web site Before you install BES, select the installation method: If you want to download a version of the product from the Borland web site, go to If you are installing BES on Linux from a downloaded file, see Preparing to install BES on Linux on page 23. Chapter 4: Installing BES on Solaris and Linux 21

27 Mounting the BES CD on Solaris If you are installing from CD, mount the Borland Enterprise Server CD before starting the installation. (For Solaris see Mounting the BES CD on Solaris on page 22. For Linux, see Preparing to install BES on Linux on page 23.) If you want to install from the command line without invoking the installer's GUI, see Running the installer without a GUI on page 28. If you want to perform a silent installation using definitions from a properties file, see Chapter 5, Installing BES Using Silent Installation (Windows, Solaris, Linux). JDK The JDK, version 1.4.2, is installed during installation on Solaris and Linux. For information about changing a Partition's JDK after you have completed the product installation, go to Changing the JDK in the Using Partitions section of the Management Console User's Guide. For updates on JDK requirements for Solaris, Linux, and for VisiBroker Edition, please refer to the Borland web site, JRE requirements for Linux download installation Important If you are installing BES on Linux using a file downloaded from the Borland download site you need an existing JRE, or above, in your environment in order to run the extracted installer jar file. When running the extracted installer for Linux, include the full path to your installed JRE. To check the location and version of your JRE, use the following syntax: $which java /opt/local/bin/java $java -version java version "1.4.2" Mounting the BES CD on Solaris The Borland Enterprise Server CD includes installation software for the Solaris and Linux operating systems. This section describes how to prepare to install BES on Solaris from CD. (To prepare to install BES on Linux, see the Preparing to install BES on Linux on page 23 section.) To mount a CD on your local workstation: 1 Log into your workstation. If the Volume Manager is not running, you need superuser privileges to mount the CD in step 5. 2 Insert the CD into the drive. 3 Open a command shell. 4 To determine if the Volume Manager is running, enter the following command: /usr/bin/ps -ef grep mountd To see a list of all running processes, look for a response similar to the following: root Oct 30? 0:00 /usr/lib/autofs/automountd 5 If the Volume Manager is running, proceed to Installing Borland Enterprise Server on page BES Installation Guide

28 Preparing to install BES on Linux 6 If the Volume Manager is not running, become root, then enter the following commands to mount the CD before proceeding to Installing Borland Enterprise Server on page 23: /usr/sbin/mount -F hsfs -r /dev/dsk/device /cdrom where device is the device name of the CD. 7 Enter the following command to change to the CD directory: cd /cdrom 8 To unmount the CD after installing BES, become root and enter the following command: umount /cdrom Preparing to install BES on Linux To prepare to install BES on Linux: 1 If you're installing from a tar file downloaded from the Borland Web site: a b Extract the installation executable from the tar file you downloaded. Obtain all permissions, or chmod all, where 777 indicates all, to run the installer. 2 If you're installing BES on Linux from CD: a b Become root and enter the following commands to mount the CD before proceeding to Installing Borland Enterprise Server on page 23: mount /dev/cdrom exit Change to the CD directory. cd /mnt/cdrom Installing Borland Enterprise Server Solaris: Linux: To install Borland Enterprise Server and related components: 1 You can download the BES installer from the web or install from CD. a b If installing BES from CD: 1 Type the appropriate command: install_solaris install_linux The CD splash screen appears after a few moments. 2 Click the highlighted product. The installation wizard launches in a separate window. To view Readme and installation documentation on the CD, or to browse the contents of the CD, click the appropriate entries on the splash screen. If installing BES on Solaris from a downloaded file: 1 Go to the directory where you extracted the installer. 2 To launch the installation wizard, invoke the extracted.bin file. Chapter 4: Installing BES on Solaris and Linux 23