uCosminexus Application Server

System Setup and Operation Guide

3020-3-Y02-10(E)


Contents

Notices
Summary of amendments
Preface

1. Overview of System Setup and Operations
1.1 Operation management tool
1.1.1 Setup Wizard
1.1.2 Management portal
1.1.3 Smart Composer functionality
1.2 Overview of system setup
1.2.1 Setting up a single Web front system
1.2.2 Ensuring availability by allocating multiple hosts with same configuration
1.2.3 Supporting multi-tenancy by allocating multiple J2EE servers
1.2.4 Supporting multi-tenancy by allocating multiple resource adapters
1.3 Overview of system operations
1.4 Overview of operation format to be executed by the management portal or the Smart Composer functionality
1.5 Symbols used in examples and dialog box operations described in this manual
1.6 Notes on using Windows Server 2012, Windows Server 2008, Windows 8, Windows 7, or Windows Vista

2. Setting up the System
2.1 Setting up the database server
2.1.1 Preparing the database
2.2 Setting up Application Server
2.2.1 Installing Application Server
2.2.2 Installing new Application Server (In Windows)
2.2.3 Installing new Application Server (In AIX, HP-UX)
2.2.4 Installing new Application Server (In Linux)
2.2.5 Installing the products for connecting to the database
2.2.6 Setting up the system environment (Setting up a single Web front system)
2.2.7 Notes on setting up the system environment
2.2.8 System environment definition
2.2.9 Setting the timeout
2.2.10 Setting and starting the business application (when using GUI)
2.3 Changing to the system with assured availability
2.3.1 Allocating multiple hosts of same configuration to ensure availability
2.3.2 Notes on allocating multiple hosts of same configuration
2.4 Changing to the system that supports multi-tenant
2.4.1 Allocating multiple J2EE servers for supporting multi-tenants
2.4.2 Allocating multiple resource adapters for supporting multi-tenants

3. Operating the System
3.1 Regular operations of Application Server
3.1.1 Starting the system to start the business (when using GUI)
3.1.2 Checking the operational status of system (when using GUI)
3.1.3 Stopping the system (when using GUI)
3.2 Maintenance operations of Application Server
3.2.1 Replacing the business application
3.2.2 Performance tuning
3.2.3 Applying the memory tuning of Java VM
3.2.4 Applying tuning for optimizing the number of concurrent executions
3.2.5 Changing the IP address
3.2.6 Changing the database connection environment
3.2.7 System setup and definition information
3.2.8 Acquiring the system setup and the definition information
3.2.9 Deleting unwanted J2EE servers
3.2.10 Changing the management user account settings of management functionality
3.3 Unsetup of the system environment and uninstalling Application Server
3.3.1 Unsetup of the system environment
3.3.2 Uninstalling Application Server (In Windows)
3.3.3 Un-installing Application Server (in AIX, HP-UX)
3.3.4 Un-installing Application Server (in Linux)
3.4 Notes on operating the system
3.4.1 Notes on J2EE Server management
3.4.2 Notes on names to be specified in commands
3.4.3 Constraints on accessing the network drives (in Windows)
3.4.4 Notes on temporary files
3.4.5 Notes on correcting the system time

4. Operational Format to be Implemented in the Management Portal or the Smart Composer functionality
4.1 System setup for improving machine performance by allocating Web Server to a different host
4.1.1 To allocate Web Server to different host
4.1.2 Setting the database environment (Setting Oracle)
4.1.3 Setting Component Container administrator (For UNIX)
4.1.4 Notes on setting Component Container administrator (For UNIX)
4.1.5 Symbolic links supported by Application Server (For UNIX)
4.1.6 Setting the database connection environment (setting HiRDB)
4.1.7 Setting the database connection environment (setting Oracle)
4.1.8 Setting the database connection environment (Setting SQL Server)
4.1.9 Notes on setting up a database
4.1.10 Environment variables
4.1.11 Setting environment variables of the system
4.1.12 Setting environment variables of the logical server
4.1.13 Check points on setting environment variables of the logical server
4.1.14 Setting the management functionality
4.1.15 Information to be set for using Management Server
4.1.16 Information to be set for using Administration Agent
4.1.17 Starting the Administration Agent
4.1.18 Starting the Management Server
4.1.19 Easy Setup definition file (when using J2EE applications)
4.1.20 Setting the Easy Setup definition file
4.1.21 Notes on setting the Easy Setup definition file (when using J2EE applications)
4.1.22 Example of creating an Easy Setup definition file
4.1.23 Setting the system environment
4.1.24 Starting the system (when using CUI)
4.1.25 Resource adapter settings
4.1.26 Setting DB Connector (when using CUI)
4.1.27 Setting resource adapters other than DB Connector (when using CUI)
4.1.28 Starting the resource adapter (when using CUI)
4.1.29 Setting and starting the business application (when using CUI)
4.1.30 Check points for operating the resource adapter or the business application (when using CUI)
4.1.31 Changing the system environment definition (parameters in the Easy Setup definition file) (when using CUI)
4.1.32 Change the business application settings (when using CUI)
4.1.33 Changing the resource adapter settings (database connection environment) (when using CUI)
4.1.34 Stopping system (when using CUI)
4.1.35 Stopping the Management Server
4.1.36 Stopping the Administration Agent
4.1.37 Removing system environment
4.2 System operations to expand the system scale by increasing the number of hosts (scale out)
4.2.1 Expanding the system scale by increasing hosts (scale out)
4.2.2 Scaling out the system environment (when using CUI)
4.3 System operations to reduce the system scale by decreasing number of hosts (scale in)
4.3.1 Reducing the system scale by decreasing number of hosts (scale in)
4.3.2 Scaling in the system environment (when using CUI)
4.4 System operations by which the configuration and definition information is output and the system environment is migrated to a different host
4.4.1 Migrating the system environment to a different host
4.4.2 Outputting the configuration and definition information and migrating the system environment
4.4.3 Configuration and definition information used during migration
4.4.4 Notes on outputting the configuration and definition information and the system migration
4.5 Setting up a system to allocate the logical user server
4.5.1 Allocating the logical user server
4.5.2 Setting the logical user server with Easy Setup definition file (When using CUI)
4.6 Setting up a system for executing batch applications
4.6.1 Executing batch applications
4.6.2 Notes on setting up Easy Setup definition file (when using batch applications)
4.6.3 Notes on operating the system that executes batch applications
4.7 Setting up the system for controlling load balancer from management functionality
4.7.1 Controlling the load balancer from management functionality
4.7.2 Load balancer
4.7.3 Preparing the load balancer
4.7.4 Notes on connecting using APIs
4.7.5 Setting up environment for connecting to the load balancer
4.7.6 Notes on controlling the load balancer
4.8 Setting up the system using the other functions
4.8.1 Using the other functions
4.8.2 Notes on setting Easy Setup definition file (when using other functionality)
4.9 Notes on operations

5. Windows, Commands, and Files used in the System Setup and Operations
5.1 Windows used for system setup and operations
5.2 Commands used for system setup and operations
5.3 Files used for system setup and operations

Appendixes
A. Parameters set up by using the Setup Wizard
A.1 Parameters for which values other than the default values are set using the Setup Wizard (logical Web server)
A.2 Parameters for which the values other than the default values are set by using the Setup Wizard (logical J2EE server)
A.3 Parameters for which values other than the default values are set by using the Setup Wizard (logical performance tracer)
B. Post-Installation Directory Configuration
C. Work Directory
C.1 Work directory of the J2EE server
C.2 Work directory of the batch server
C.3 Notes on the work directory
D. Troubleshooting in Management Portal Operations
E. Contents Set Automatically by Management Server
E.1 User definition files created automatically by Management Server
E.2 Contents set automatically by Management Server in the CTM domain manager
E.3 Contents set automatically by Management Server in CTM domain manager
E.4 Contents set automatically by Management Server to SFO server
E.5 Contents set automatically by Management Server to the J2EE server
E.6 Contents set automatically by Management Server to batch server
E.7 Contents set automatically by Management Server to Web server
F. Update installation of Application Server
F.1 Update installation of Application Server (In Windows)
F.2 Update installation of Application Server (In UNIX)
G. Installation by using JP1/SC/DPM to replicate the disk
G.1 Replicated disk installation of Application Server (In Windows)
G.2 Replicated disk installation of Application Server (In Linux)
H. Remote installation
H.1 Remote installation of Application Server (In Windows)
H.2 Remote installation of Application Server (In UNIX)
I. Installing the redirector functionality
I.1 Installing the redirector functionality (In Windows)
I.2 Installing the redirector functionality (In UNIX)
J. Notes on installation and un-installation
J.1 Notes on the installation and un-installation of Application Server
J.2 Notes on the installation and un-installation of component software
J.3 Notes on replicated disk installation (In Windows)
J.4 Notes on replicated disk installation (In Linux)
J.5 Notes on remote installation
J.6 List of error codes for Application Server installation and un-installation (In Windows)
J.7 Installation and un-installation log of Component Container and Redirector functionality (In UNIX)
K. CLI Commands or APIs of the Load Balancer Executed by the Smart Composer Functionality
K.1 APIs of the load balancer executed by the Smart Composer functionality
K.2 CLI commands of the load balancer executed by Smart Composer functionality
L. Setting up XDM/RD E2
M. Sample programs provided by Application Server
M.1 Configuration and operation procedure of the sample execution environment by server management commands
M.2 Enterprise Bean (EJB2.0) sample program
M.3 Sample programs of Enterprise Bean (Annotations)
M.4 Sample programs of Enterprise Bean (Timer Service)
M.5 JPA sample programs
M.6 JavaBeans resource sample program
M.7 User log functionality sample program
M.8 Sample program of Web application
M.9 Sample program of TP1 inbound linking functionality
M.10 Sample program of JSF
M.11 Sample of Bean Validation and CDI integration application
N. Glossary

Index