Oracle® Database Lite Getting Started Guide
10g (10.0.0) Part No. B14138-01 |
|
![]() Previous |
![]() Next |
This chapter describes all of the details for you to install Oracle Database Lite, including the following:
Oracle Database Lite uses Oracle Universal Installer to guide you through each step of the installation process. The Oracle Universal Installer provides the following features:
Describes installation options for Oracle Database Lite
Detects pre-set environment variables and configuration settings
Sets environment variables and configuration during installation
Offers configuration options for a customized installation of Oracle Database Lite
Deinstalls products
The Oracle Universal Installer automatically checks your computer prior to installation to verify that your system meets operational requirements. Table 2-1 lists the prerequisite checks that are performed.
Table 2-1 Oracle Universal Installer Automatic Prerequisite Checks
Prerequisite Checks | See Also |
---|---|
Check for enough disk space for Oracle home installation | Table 1-5, "Minimum Hardware Requirements for UNIX Systems"
|
On UNIX systems, checks for TMP and TMPDIR variable and sufficient swap space | Table 1-5, "Minimum Hardware Requirements for UNIX Systems"
|
You start the Oracle Universal Installer using different methods for each type of operating system, as detailed in the following steps:
Section 2.1.1, "Starting the Oracle Universal Installer on Windows"
Section 2.1.2, "Starting Oracle Universal Installer on UNIX"
Insert the CD-ROM labeled Oracle Database Lite and double-click setup.exe
. The Welcome screen appears.
Follow these steps to start Oracle Universal Installer and install Oracle Database Lite:
Insert the CD into the CD-ROM drive.
Mount the installation CD-ROM. For information on mounting the installation CD-ROM for your platform, see Section 1.8, "Mounting the Installation CD-ROM For UNIX Systems".
Run Oracle Universal Installer from the CD-ROM:
Note: Ensure you are not logged in as theroot user when you start the Oracle Universal Installer.
|
Log in as the oracle
user.
Start the installer by entering the following command:
prompt> mount_point/disk1/runInstaller
This launches Oracle Universal Installer, which installs Database Lite.
The Oracle Universal Installer creates the oraInventory
directory the first time it is run on a computer. The oraInventory
directory keeps an inventory of products that the Oracle Universal Installer installs on your computer, as well as other installation information. If you have previously installed Oracle products, then you may already have an oraInventory
directory.
When a UNIX group name is created and specified, the Oracle Universal Installer grants the specified group the permission to write to the oraInventory
directory. If another group attempts to run the installer, then they must have permission to write to the oraInventory
directory. If they do not have permission, then the installation will fail.
The location of oraInventory
is defined in the oraInst.loc
file. See Table 2-1 for the location of the orainst.loc
file for your system.
The latest installation log file is stored in:
/your_base_directory/oraInventory/logs/installActiontodays_date_time.log
The your_base_directory identifier is the location for your installation files and todays_date_time is the date and time of installation. Log file names of previous installation sessions take the form installActions
todays_date_time
.log
.
Do not delete or manually alter the oraInventory
directory or its contents. Doing so can prevent the installer from locating products that you have installed on your system.
Oracle Database Lite consists of two main components: Mobile Server and Mobile Development Kit. Each is installed separately from the Oracle Database Lite CD-ROM.
Note: For instructions on how to install Branch Office, see the Oracle Database Lite User's Guide for Branch Office. For instructions on how to create a Mobile Client and download an application, see Chapter 4, "Quick Start for Oracle Database Lite". |
Once the Oracle Universal Installer is initiated, perform the following steps to install Oracle Database Lite:
On the Welcome screen, click Next.
On the File Locations screen, enter the following:
In the Source field, either accept or enter a new location and name of the Oracle Database Lite products.jar
file.
In the Destination field, enter the name and path of Oracle home. This is the Oracle home where you want to install Oracle Database Lite. You may choose to install Oracle Database Lite into a new or existing Oracle home. Take the following into consideration:
If you use Mobile Server in standalone mode for your middle-tier, do not use an Oracle home that has any version of Oracle9iAS or OracleAS installed.
If you use Oracle9iAS or OracleAS as your middle-tier, then you must install Oracle Database Lite into the same Oracle home where the application server is installed.
Click Next .
On the Installation Types screen, choose the components and the type of installation to execute. Your options are as follows:
Mobile Server
Mobile Development Kit
Custom
The first two are the main components of Oracle Database Lite. The custom option is for advanced users only. Each of these Install options are discussed in the following sections:
Install Mobile Development Kit from the Installation Types screen by choosing the Mobile Development Kit and clicking Next. On the Summary screen, click Install. Click Exit to return to the installation screen.
You have now installed the Mobile Development Kit.
Install the Mobile Server from the Installation Types screen, as follows:
Choose Mobile Server and click Next.
Provide the hostname, port, and SID for the back-end database for the Mobile Server Repository. Mobile Server installs its meta-data in the back-end database. If you are not sure, you can query the data dictionary to obtain these values. Connect as SYSTEM
and run the following queries.
select instance_name from v$instance;
If you need to retrieve the port number, check the listener.ora
file on the back-end database.
Click Next.
Click Yes to install the Mobile Server Repository. For this option, always click Yes to install the repository—even if one has already been created. If you are installing a Mobile Server on another host that shares an existing repository, selecting yes updates the repository with the shared Mobile Server information. You only select No if instructed to for a certain environment. Click Next.
On the Mobile Server Configuration Options screen, enter the HTTP listener port for OC4J. Provide a port number for the OC4J HTTP listener if you are executing in standalone mode. The default value is 80. This screen only appears if you are using standalone. If you are using Oracle9iAS or OracleAS, the default ports are used. Click Next.
Note: If, after installation, you have port conflicts and need to change the port number for OC4J standalone, edit the fileORACLE_HOME \mobile_oc4j\j2ee\home\config\http-web-site.xml and modify the following with the alternate port number:
<web-site port="80" display-name="OracleAS Containers for J2EE HTTP Web Site"> |
On the Summary page, click Install to start the installation of Mobile Server, which is installed in your Oracle home.
If, previously, you clicked Yes to installing the Mobile Server Repository, then the Repository Wizard is now launched to create and populate the repository with the Mobile Server schema.
The Repository Wizard asks for the SYSTEM
password for the host where the back-end database resides. Enter the SYSTEM
password. Click Next.
If this is a new Repository, the following message is displayed:
No existing Repository found. A new Repository will be installed.
Click Next.
Enter the schema name and password for the Mobile Server Repository. The default name is MOBILEADMIN
. Also, check whether you want to install sample applications or not. Click Next.
A summary screen appears informing you if a repository is installed or not. Click Next.
The installation screen appears. Wait until the install is completed. Click Next.
Once the repository wizard is finished, click Finish to leave the wizard.
Click Exit to complete the installation.
Review the installation log files for any errors, which are located in ORACLE_HOME
\mobile\server
. The repository.log
file contains the log file of all general installation errors; the samples.log
file contains a log of the sample installation errors.
If you are installing on top of any version of the application server, then restart the application server.
In some cases, you may want to have multiple Mobile Servers using the same Mobile Server repository. For example, as Figure 2-1 shows, if you wanted to load balance your Mobile Clients across multiple Mobile Servers, you could add a load balancer, such as BIG-IP or Oracle WebCache, before the shared Mobile Servers, and then your clients would be balanced across these Mobiles Servers, of which each accesses the same data in the shared repository.
Figure 2-1 Multiple Mobile Servers Sharing a Repository
You can install multiple Mobile Servers, each on its own host, that use the same Mobile Server Repository, as follows:
Install the first Mobile Server and the Mobile Server Repository following the instructions in Section 2.2.2, "Installation of Mobile Server".
For each subsequent Mobile Server, follow the instructions in Section 2.2.2, "Installation of Mobile Server", supplying the same host name, port and SID where the Mobile Server Repository exists and select Yes for creating the repository, which registers the shared Mobile Server with the repository.
Mobile Server is automatically started when you start the middle-tier, as follows:
If you are using standalone Mobile Server, which uses OC4J standalone, start the standalone version by executing the following:
cd ORACLE_HOME\mobile_oc4j\j2ee\home
java -jar oc4j.jar
OR
Start Oracle9iAS or OracleAS through the Windows Services panel. Alternatively, you can start the application server from the Oracle9iAS or OracleAS GUI.
When you have Mobile Server installed on a Solaris machine, but you want to display the Mobile Manager screens on a Windows machine through Exceed or Tarantella, first set the DISPLAY
property on the Solaris machine, as follows:
setenv DISPLAY hostname:0.0
This enables the screens to display properly on the Windows machine, when originating from the Solaris machine.
To test whether your Mobile Server was installed correctly, test it in one of the following ways:
If you are using the standalone version, test your Mobile Server through a browser with the following URL:
http://<machine-name>[:port]/webtogo
Note: If, after installation, you have port conflicts and need to change the port number for OC4J standalone, edit the fileORACLE_HOME \mobile_oc4j\j2ee\home\config\http-web-site.xml and modify the following with the alternate port number:
<web-site port="80" display-name="OracleAS Containers for J2EE HTTP Web Site"> |
If you are using Oracle9iAS or OracleAS as your middle-tier, test Mobile Server through a browser with the following URL:
http://<machine-name>[:port]/webtogo
For more information on testing your installation using the samples, see Chapter 4, "Quick Start for Oracle Database Lite".