| Oracle RepositoryDesigner Installation Guide |
|
|
|
|---|---|
| Install a new 6i repository on an existing Oracle database | Chapter 1
Chapter 2, "Installing a new repository" |
| Migrate an existing pre-6i repository to a new 6i repository* | Chapter 1
Chapter 2, "Installing a new repository" Chapter 2, "Migrating data from an existing pre-6i repository to a new one" |
| Upgrade an existing 6i repository** | Chapter 2, "Upgrading a release 6i repository" |
This release supports the following client/server configurations:
|
|
|
|
|---|---|---|
|
or 98 |
Release 9.0.1.4 (32-bit only) or Release 9.2.0.4 (32-bit only) |
certified for use with Oracle9i |
|
Release 9.0.1.4 (32-bit only) or Release 9.2.0.4 (32-bit only) |
||
|
Enterprise Edition |
certified for use with Oracle8i Server, Release 8.1.7.4 |
|
|
Standard Edition* |
Note that different releases of Oracle RepositoryDesigner 6i cannot coexist on the same workstation. If Oracle RepositoryDesigner 6i is already installed on the client, you must install this latest release into that Oracle home directory, thus upgrading the client software to this release.
The latest versions of the Developer products are available on the Internet Developer Suite CD pack.
| Installation order 1
(recommended) |
Installation order 2 |
|---|---|
| 1. Install Oracle RepositoryDesigner 6i | 1. Install Oracle Developer 6i |
| 2. Install Oracle Developer 6i | 2. Install Oracle RepositoryDesigner 6i |
| 3. Install Oracle Developer 6i patch set | 3. Install Oracle Developer 6i patch set |
The Oracle Developer product dependencies are as follows. Reports Runtime and its dependent products are required to run reports against the Oracle Repository. To use all the features of Oracle Designer Form Generator or Library Generator, you will need Oracle Forms Developer - Form Builder. For Oracle Designer Report Generator, you will need Oracle Forms Developer - Report Builder.
Any Developer products that you need must be installed from your Developer release 6i CD (and patch set CD, as appropriate).
You can use the default Windows paging file size (sometimes known as swap space) for installation, though you may need to increase the size when running the products.
Logging in as the network administrator and installing Oracle RepositoryDesigner will add the Oracle RepositoryDesigner folders to the network administrator's profile. If the network administrator then logs in at other workstations on the network, the Oracle RepositoryDesigner folders will appear even though Oracle RepositoryDesigner may not be available on those workstations.
Installation when logged in as a normal user will fail because special privileges are required to install some components.
For silent installation, you execute a series of predefined responses from a text file. This procedure can be useful, for example, if a DBA wishes to install the product in exactly the same way on a number of client workstations, or run an unattended installation.
When you run Oracle Installer, you will be presented with two ways to install the product:
If you opt for a custom installation, you will need to follow the instructions given in "Custom installation". The Software Asset Manager used during custom installation can be used to see a list of Oracle products already installed on a local workstation.
If a local database is active, shut it down.
Make sure that no other Windows applications are running. In particular, close any other Oracle applications, especially other copies of Oracle Installer.
Insert the Oracle RepositoryDesigner CD into the CD-ROM drive. On some machines, the CD will start up immediately; if it does not, click Start > Run. Enter d:\SETUP.EXE, where d identifies the CD-ROM drive, and click OK.
In the Oracle Installation Settings dialog box:
The Installation Wizard starts. Make your choices as each option is presented.
At the Oracle Repository and/or Designer Installation Type page of the wizard, choose one of the following:
| Option | Effect at client |
|---|---|
| Oracle Repository and Designer Install Wizard | Packaged installation: installs a package of Oracle RepositoryDesigner client software; for use when no previous release of this software is installed at this client |
| Update Installed Repository and Designer Products Wizard | Packaged installation: updates existing Oracle RepositoryDesigner software at this client |
| Custom Installation/De-installation | Custom installation: enables you to select individual Oracle RepositoryDesigner client software products to install, upgrade or deinstall |
If you chose "Update Installed Repository and Designer Products Wizard", the Package Installation Settings screens shows the products that will be updated. If these are correct, click OK and continue from the Oracle Installation Advanced Options - Install screen, otherwise click Back and choose a different type of installation.
If you chose "Oracle Repository and Designer Install Wizard", make the following selections (for more information, click Help on the screen):
| Option | Recommended choice | Effect at client |
|---|---|---|
| Oracle Repository | Select | Enables installation of repository tools |
| Oracle Repository | Do not select | (used for Oracle Repository) |
| Oracle Designer and Oracle Repository | Do not select | (used for Oracle Designer) |
| Oracle Designer and Oracle Repository | Select | Installs repository tools and tools for Oracle Designer |
| Client Tools | ||
| Repository Command Line Tool | Select | Installs Command Line Tool |
| Repository GUI Tools | Select | Installs Repository Administration Utility, Repository Object Navigator and Dependency Manager |
| Analysis, Design and Generation | Select | Installs systems modeling and design tools, transformers, Server Generator, WebServer Generator and generators for Visual Basic and MS Help |
| Generators for Oracle Developer | Select | Installs Form Generator, Report Generator and the Report Design Capture Tool |
| Administrator Tools | ||
| Broadcast Server (NT only) | Select only if server runs under Windows NT | Installs tool that notifies other clients of repository changes made at this client |
| Repository Installation Scripts | Essential to select this if subsequently performing server-side installation, migration or upgrade of the repository from this client (see Chapter 2); otherwise deselect | Enables installation of server-side repository from this client |
At the Oracle Installation Advanced Options - Install screen, choose one of the following (for more information, click Help on the screen):
| Option | Effect at client |
|---|---|
| Only Install New or Updated Products | Installs only those products that are either new or require upgrading in this release |
| Notification for Each Selected Product | Enables you to be notified when a product is about to be installed, reinstalled, upgraded or downgraded |
| Force Install of All Selected Products | Installs the products in this release, regardless of any versions that currently exist on this client |
At the Oracle Installation Advanced Options - Messages screen, choose as many of the following as required:
| Option | Effect at client |
|---|---|
| Display Additional Messages | Displays additional status messages during installation |
| Prompt for Install Directories | For each product, prompts you to confirm or select the directory to which the product is to be installed |
| Show List of Products to be Installed | Just before installation begins, displays a list of all the products that will be installed |
On the Oracle Repository 6i Import and Export Tools screen, select "Install Repository 6i Import and Export Tools" if the Oracle Import and Export utilities are not installed on this machine, otherwise deselect this option. If you select the option, choose a directory to which these tools are to be installed; this must be a different directory from the one to which you are installing the Oracle RepositoryDesigner software.
Further message screens are displayed at this point (click OK to acknowledge each one), after which installation begins. More message screens are displayed subsequently, followed by the message "Installation Completed".
On the Connection Information screen, in the TNS_ADMIN field, enter the path and directory where your TNSNAMES.ORA file is stored. By default this is Oracle_home\NET80\ADMIN. If you are installing a local repository (client and server on the same machine), optionally enter the database alias in the LOCAL field. Doing so avoids the need to enter a database alias in the Connect String field of the Connect dialog box whenever you start a repository toolOracle Designer.
If you chose the "Install Repository 6i Import and Export Tools" option, the Oracle Universal Installer starts when Oracle Installer has finished. Follow the on-screen prompts to complete installation. If you see an error message about the 8.0 LOCAL registry variable, ignore this as it is not an error.
Continue from "During installation".
In the Options dialog box, select or clear the check boxes for installation options as desired.
Click OK to continue.
To select adjacent products on the list, hold down the SHIFT key while you select.
To select non-adjacent products, hold down the CTRL key while you select.
To expand a product that displays a "+" sign next to it, double-click the product name. You can then select one or more individual components of that product. (If other products are already selected, hold down the CTRL key while double-clicking, to preserve the selection.)
In the "Space Requirements" area below the "Available Products" window, check that the total disk space required for your selected products is less than the amount shown under "Available Space". Deselect one or more product names if necessary, or use Windows Explorer to delete any unwanted files from your hard disk.
The buttons on the Software Asset Manager are:
| Button | Function |
|---|---|
| From | Allows you to choose a product file from which to install. |
| Install | Installs the products highlighted in the Available Products list. |
| Remove | Deinstalls the products highlighted in the Products Installed list. |
| Help | Accesses the online help system for Oracle Installer. |
| Options . . . | Allows you to do the following:
|
| View Log . . . | Allows you to view the Event
Log. The Event Log displays installation and configuration events in the
Description Level you choose: Summary, Brief, and Detail. You can store
and retrieve logs, and save them to files.
By default, log files are stored in oracle_home\ORAINST\ORAINST.LOG. If a log file from a previous installation event exists, it is renamed to ORAINST.OLG. If you want to keep more than two log files (.LOG and .OLG), you must rename the .OLG file so that it is not overwritten. |
| Restore Icons | Allows you to restore (to your desktop) Oracle product icons that have been accidentally deleted. |
| Exit | Closes the Software Asset Manager and exits from Oracle Installer. |
When you are ready to proceed, click the Install button.
A further screen may be displayed, enabling you to choose or deselect individual products for installation. When you are ready to proceed, click OK.
Under the following circumstances, Oracle Installer can incorrectly process information about the amount of disk space required:
If the installation hangs or fails completely whilst looking in the Registry for the file association for .TXT or .HTM files (the progress text displays a message to this effect whilst it is happening), you will need to edit your Registry by hand. Look in HKEY_CLASSES_ROOT for .txt (or .htm) and look at the file type - probably txtfile (or NetscapeMarkup). Still under HKEY_CLASSES_ROOT, find the entry for txtfile (or NetscapeMarkup) and expand the tree to display "txtfile > shell > open > command" (or "NetscapeMarkup > shell > edit > command"). Select the "command" node to display the value. Rationalize this entry by removing embedded quote characters, e.g. "notepad %1" and not "notepad" %1. Also make sure that if the value contains C-style escape strings that the whole value is enclosed in quotes (edit the value to check this), e.g. "write /n %1" and not write /n %1. If the installation fails because of this error, upon restarting the installation this section will be skipped and a default value of "notepad %" used to read and edit .TXT and .HTM files from within Oracle RepositoryDesigner.
Oracle Installer will try to upgrade the file CTL3D32.DLL in your Windows system directory if the version of the file on the Oracle RepositoryDesigner CD is newer. If you are running any applications that have this file locked, you will see an error message stating that Oracle Installer cannot copy the file to your disk. Click the Ignore button to proceed. Oracle RepositoryDesigner will not encounter problems with your older version of this file.
At clients where a previous version of Oracle RepositoryDesigner was installed, or where you are re-installing a component, you may see a Windows error message as Oracle Installer tries to remove icons from a desktop folder that was created as part of the previous version but which no longer exists. The message is in the form:
C:\WINNT\Profiles\All Users\Start Menu\Programs\folder is not accessible. The folder was moved or removed.Click OK to acknowledge this message.
After the import and export tools have been installed, the Oracle Universal Installer is redisplayed.
After a custom installation, the Software Asset Manager window is redisplayed.
If you receive the "Update products" message and want to update any of the products it lists, restart Oracle Installer and continue from "Custom installation".
If you receive the message that additional products need to be installed before the full functionality of certain Oracle Designer tools can be used, and you have a license for them, you should install those additional products now. These products must be installed into the same Oracle home as Oracle Designer.
When you have finished, click Exit to leave Oracle Installer.
If you have installed earlier releases of Oracle RepositoryDesigner, you may have obsolete products and Start menu entries that you can now remove.
The Oracle RepositoryDesigner 6i product CD contains a set of template response files which you can customize for your site requirements:
| Response file | Directory on product CD | Description |
|---|---|---|
| IMPEXP.RSP | \INSTALLR\INSTALL | Oracle Universal Installer response file for installing Import/Export tools required by Oracle RepositoryDesigner |
| RESPONSE.RSP | \INSTALLR\INSTALL | Oracle Installer response file for installing Oracle RepositoryDesigner (also runs Oracle Universal Installer to install the required Import/Export tools) |
| TOOLSPK.RSP | \INSTALLR\INSTALL | Oracle Installer response file for installing Oracle RepositoryDesigner (does not install the Import/Export tools) |
Thus, for example, if you want to use this method to install Oracle RepositoryDesigner and the Import/Export tools, you need only customize and use the RESPONSE.RSP file. If you want to install Oracle RepositoryDesigner without the Import/Export tools, customize and use the TOOLSPK.RSP file. If you subsequently want to install the Import/Export tools, customize and use the IMPEXP.RSP file.
To perform a silent installation you:
If you run the Oracle Installer and exit after selecting the Oracle home directory, a set of response files customized with the selected Oracle home is copied to that Oracle home directory. To achieve this, run the installer in the normal way from the product CD (e.g. by running SETUP.EXE from the root directory on the CD), choose the Oracle home directory on the first dialog box and click OK, then click Cancel at the next dialog box.
To create a customized response file by running the Oracle Installer and recording the results, change the current directory to \INSTALLR\INSTALL on the drive containing the product CD and enter the following command from the Windows command line:
where d is the drive where the \TMP directory resides and response_file is the name of the customized response file you are creating. You can then call this file when you run the installer, as described in the next section.orainst /rspdest d:\tmp\response_file.rsp
where d is the full pathname, and response_file is the name, of the customized response file you are using.orainst /silent /rspsrc d:response_file.rsp
To use Oracle Universal Installer with a customized response file (IMPEXP.RSP), change the current directory to \INSTALLR\WIN32 on the drive containing the product CD and enter the following at the Windows command line:
where d is the full pathname, and response_file is the name, of the customized response file you are using. The -silent switch performs the installation with no visual feedback, whereas omitting the switch causes the Universal Installer to display as it executes automatically.setup setup.exe [-silent] -responsefile d:response_file.rsp
A common cause of connection problems is that the listener process is either not started (indicated by the message "ORA-nnnnn: TNS: no listener") or is not correctly configured. Refer to the Net Services Administrator's Guide or the Net8 Administrator's Guide for information on starting and configuring a listener process.
When you can connect to the database, close the SQL*Plus window.
Note that the net service name in the first Oracle home must be identical to that in the Oracle home for the database server.
To set up the TNSNAMES.ORA file in the first Oracle home (the one used for Oracle RepositoryDesigner and elsewhere referred to as DEFAULT_HOME), start the Net8 Easy Configuration utility at the client:
Click Start > Programs > Oracle for Windows NT - home > Oracle Net8 Easy Config.
If you see a message about comment information in the network configuration file, reply Yes.
Add a new service with the same name as the database alias. Choose "Add New Service" and follow the on-screen instructions to create the new service. Use the following values:
| For | Enter |
|---|---|
| New Service Name | The database alias |
| Host Name | The name of the database server machine |
| Port Number | 1521 |
| Database SID | The name of the database, also known as the Oracle System Identifier (SID) |
After you enter a value, click the Next button to go on to the next parameter.
At the end, test the new service. For the username and password, use SYSTEM or SYS and its password.
Click the Test button to test the connection.
Click Done, then Next, then Finish to exit.
To set up the TNSNAMES.ORA file in the database Oracle home, start the Net (or Net8) Configuration Assistant as follows:
(Oracle9i database) Click Start > Programs > Oracle - database_Oracle_home > Configuration and Migration Tools > Net Configuration Assistant
(Oracle8i database) Click Start > Programs > Oracle - database_Oracle_home > Network Administration > Net8 Configuration Assistant
The following table shows what to enter on each screen.
| Screen | Choose or Enter |
|---|---|
| Welcome | Local Net Service Name configuration |
| Net Service Name Configuration | Add |
| Database Version | Oraclenn database or service |
| Service Name | The global database name of the database |
| Select Protocols | TCP |
| TCP/IP Protocol | Host Name - The host name of the database server
Port Number - 1521 |
| Test | No, do not test (at this stage) |
| Net Service Name | Use the default value supplied |
| Another Net Service Name? | No |
Click Next, then Finish to save the configuration details.
Restart the Net (or Net8) Configuration Assistant and at the Net Service Name Configuration screen, choose Test.
Click Cancel or Finish to exit.
Continue from "Install/migrate/upgrade the repository".
If you chose not to do this during client-side installation but now wish to do so, you can achieve this as follows.
Click Start > Run, enter regedit and click OK.
To use the TNS_ADMIN variable, set both the following registry entries to d:\default_home\NET80\ADMIN, where d is the drive, and default_home the directory, to which the Oracle RepositoryDesigner client software is installed:
\HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\TNS_ADMIN
\HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\HOMEn\TNS_ADMIN
where n identifies the database Oracle home.
To use the LOCAL registry variable to avoid the need for users to enter a connection string every time they connect to the database, set the following registry entries to the value of the database alias that you will use when you set up the TNSNAMES.ORA file later in this step:
\HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\LOCAL
\HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\HOMEn\LOCAL
where n identifies the database Oracle home.
To set up the TNSNAMES.ORA file:
Click Start > Programs > Oracle for Windows NT > Oracle Net8 Easy Config.
If you see a message about comment information in the network configuration file, reply Yes.
Add a new service with the same name as the database alias. Choose "Add New Service" and follow the on-screen instructions to create the new service. Use the following values:
| For | Enter |
|---|---|
| New Service Name | The database alias |
| Host Name | The name of the database server machine |
| Port Number | 1521 |
| Database SID | The name of the database, also
known as the
Oracle System Identifier (SID) |
After you enter a value, click the Next button to go on to the next parameter.
At the end, test the new service. For the username and password, use SYSTEM or SYS and its password.
Click the Test button to test the connection.
Click Done, then Next, then Finish to exit.
Oracle Installer creates an entry on the Start menu that leads to the main Oracle Designer window, and a separate entry for Oracle Repository that leads to the Repository Administration Utility. You can create individual icons for Oracle Designer and some of its tools in order to access them directly from the desktop.
On the desktop, click the right mouse button and choose New > Shortcut. Type the location for the tool, then click Next. Type the tool name, then click Finish.
The following table contains the command line information required for each tool.
Tool Location Oracle Designer Oracle_home\BIN\DES2K61.EXE Command Line Tool Oracle_home\BIN\CKTL61.EXE Dataflow Diagrammer Oracle_home\BIN\AWD61.EXE Dependency Manager Oracle_home\BIN\CKDM61.EXE Design Editor Oracle_home\BIN\DWFDE61.EXE Entity Relationship Diagrammer Oracle_home\BIN\AWE61.EXE Function Hierarchy Diagrammer Oracle_home\BIN\AWF61.EXE Matrix Diagrammer Oracle_home\BIN\AWM61.EXE Object Status Utility Oracle_home\BIN\CKOS61.EXE Process Modeler Oracle_home\BIN\BPMOD61.EXE Repository Administration Utility Oracle_home\BIN\CKRAU61.EXE Repository Object Navigator Oracle_home\BIN\CKRON61.EXE Repository Reports Oracle_home\BIN\CKRPT61.EXE
To set up non-English character input:
Select Start > Settings > Control Panel > Regional Settings or
Regional Options. Click the Input Locales tab.
Either set a new default language, or set up the workstation to switch languages by means of a key combination.
When you click Start > Programs, you see the following menu choices (home is the Oracle home directory for the client tools):
Menu Menu Item Notes Oracle Designer 6i - home Install Form Generator HTML Help Package See separate supporting documentation before implementing. This is covered in the Form Generator help topic 'Displaying help text as HTML-based help in a web browser'. Set Up Form Generator Automation See separate supporting documentation before implementing. Install Web PL-SQL Generator See separate supporting documentation before implementing. Oracle Designer Starts Oracle Designer. Oracle Designer 6i Doc - home Error Messages Details of Oracle Designer error messages (prefixes CDA, CDD, CDG, CDR, CDS, CDY and RME) and ORA messages. Installation Guide Accesses the Oracle Designer 6i installation guide. List of Fixed Bugs Opens a list of bugs that have been fixed in Oracle Designer for this release. Online Help Accesses the online help for Oracle Designer and Oracle Repository (other than the API). Release Notes Opens the release notes for Oracle Designer. Oracle Designer 6i Tutorial - home About the Oracle Designer Tutorial Opens a text file. Drop Tutorial Tables Runs a SQL script that deletes database tables. Use this ONLY when instructed as part of the tutorial. Oracle Designer for Tutorial User Starts Oracle Designer for use with the tutorial only. Oracle Designer Tutorial Opens the tutorial documentation. This is essential for following the tutorial. Populate Tutorial Runs a SQL script that populates a database table named PRODUCTS. Use this ONLY when asked to do so in the tutorial document, which will be after you have created tables.
Oracle Repository 6i - home Repository Administration Utility Starts the tool; useRepository Administration Utility without activating other Oracle Designer tools. Use this option when installing or upgrading a repository. Repository Command Line Tool Starts the tool Repository Object Navigator Starts the tool Use as Source Control for Developer See separate supporting documentation before implementing Oracle Repository 6i Doc - home API and Model Reference Guide Accesses the guide Command Line Tool Reference Guide Accesses the guide Configuration Management Overview Opens an overview document Error Messages Details of Oracle Repository error messages (prefixes CDA, CDR and RME) and ORA messages Installation Guide Accesses the Oracle Repository 6i installation guide List of Fixed Bugs Opens a list of bugs that have been fixed in Oracle Repository for this release Release Notes Opens the release notes for Oracle Repository Online Help Accesses the online help for Oracle Repository
|
Caution: You cannot undo a removal operation. |
When removing Oracle products, we recommend that you remove any Oracle Designer products before removing any Oracle Developer products.
If you see the message:
Reply No to defer the deinstallation. This is because deinstalling the product at this time will cause other products to fail to run, and possibly fail to deinstall, correctly.Other products are dependent on productname (or one of its components). Removing it may cause other products to work improperly. Are you sure you want to deinstall it?
To remove Oracle products:
Oracle Installer removes all product files and subdirectories associated
with the product(s) that you selected. Note that you cannot remove Oracle
Installer itself.
If you try to remove a product that is required by another installed product, Oracle Installer displays a message prompting you to confirm your decision.
If you reply Yes to the message, the selected product is removed immediately. The products that depended on the removed product may now fail to run properly, and may even fail to be removed properly by Oracle Installer should you attempt to do so.
If you reply No to the message, the selected product is marked for removal, but is not actually removed until the last product that requires it is deleted.
Since you cannot remove Oracle Installer itself, selecting it here
will simply display a message to that effect later in the process.
Reply Yes to the confirmation message.
Reply No to any messages about the removal of dependent products.
Reply Yes if you see a message about deinstalling configuration files.
If products persist in the Products Installed list, repeat the process
from Step 2, replying Yes to any messages
about removal of dependent products.
|
Copyright © 2000, 2004, Oracle Corporation. All Rights Reserved. |
