Oracle RepositoryDesigner Installation Guide  
Contents icon
Contents

PrevNext

1
Client-side installation

This chapter provides instructions for installing the Oracle RepositoryDesigner tools software at a client workstation. The following topics are covered:

Preliminary information

With this release of Oracle RepositoryDesigner, you can: The way you use this guide depends on which of these tasks you want to perform:
To...
Follow these instructions
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"
* pre-6i data must be migrated to a new 6i repository; you cannot use the 6i release with a pre-6i repository
** the upgrade procedure in Chapter 2 includes the client-side installation procedure from Chapter 1

This release supports the following client/server configurations:
Client operating system
Repository platform
Server operating system
Windows XP, 2000, NT
or 98 
Oracle9i Enterprise Edition, 
Release 9.0.1.4 (32-bit only) or 
Release 9.2.0.4 (32-bit only)
Any version of Sun Solaris or Windows NT
certified for use with 
Oracle9i
Oracle9i Standard Edition*
Release 9.0.1.4 (32-bit only) or 
Release 9.2.0.4 (32-bit only)
Oracle8i Server, Release 8.1.7.4 
Enterprise Edition 
Any operating system 
certified for use with 
Oracle8i Server, Release 8.1.7.4 
Oracle8i Server, Release 8.1.7.4 
Standard Edition*
* under Standard Edition, Server Generator will not be able to generate bitmap indexes, function-based indexes or materialized views

Multiple Oracle Homes

Oracle RepositoryDesigner 6i release 2 onwards can recognize and work with multiple Oracle home directories. Thus it is possible to install Oracle RepositoryDesigner 6i into any Oracle home directory on a client workstation. However, if the Oracle database server is already installed on the same machine (see the next section), ensure that you install Oracle RepositoryDesigner 6i into a different Oracle home.

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.

Using Oracle RepositoryDesigner 6i and Oracle8i or Oracle9i on the same machine

Oracle RepositoryDesigner 6i is built against Oracle8 (not 8i) libraries and will install the necessary Oracle8 client files if these are not already installed. It neither requires nor precludes Oracle8i or Oracle9i (server or client) being installed on the same machine. However, if you do want to use both products on the same machine, you must install Oracle RepositoryDesigner 6i into a different Oracle home directory from that used for Oracle8i or Oracle9i, to ensure that both products perform correctly.

Using Oracle RepositoryDesigner and Developer products together

If you intend to use Developer 6i products (Forms or Reports) together with this release, you should use Oracle Forms Developer or Reports Developer 6i patch set 15. All of these products must be installed into the same Oracle home directory.

The latest versions of the Developer products are available on the Internet Developer Suite CD pack.

Order of installation of Oracle RepositoryDesigner, Developer and patch set

One of the following installation orders should be used:
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

Product dependencies

The suite of products that make up Oracle RepositoryDesigner is dependent on some of the products from Oracle Developer (Forms, Reports, etc.), the Oracle Server (Oracle8i utilities), and Net8 (Net8 Client and various Oracle protocol adapters). Apart from the Developer products (see below), all of the products that you need are included on the Oracle RepositoryDesigner CD and are installed where required as dependent products when you install Oracle RepositoryDesigner.

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).

System requirements

At each client workstation:

Under Windows, you will need an Administrator account.

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.

Pre-installation information

Before you install

Before you try to install Oracle RepositoryDesigner, make sure that:

Use separate Oracle home directories for different operating systems

It is important not to install Oracle products intended for one operating system into the Oracle home where products intended for another operating system have been installed. Failure to observe this will result in your installed products being unusable. Keep separate Oracle home directories for different versions of Windows if you use these on the same machine.

Close Oracle products before running Oracle Installer

Make sure that no Oracle products are running while you are using Oracle Installer. You may find that these products have locked certain files that Oracle Installer is trying to upgrade. In particular make sure that no other copy of Oracle Installer is running and that you have closed the Oracle Administrator Toolbar, and shut down any local Oracle services.

Log in as the local workstation administrator

Under Windows, be sure to log in as the administrator for the local workstation and not as the network administrator or any other user.

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.

Installing products in non-English environments

When you run Installer from the Oracle RepositoryDesigner CD you are given the choice of many different languages to choose from for your client-side installation. Not all products that form part of the installation have been translated to that language. The English (American) version of those products that have not been translated will be installed. Where translated products have been installed and are being run, the user interface and messages displayed to the user will be in the chosen language. Where English versions of the products have been installed, the user interface and messages will be in English. Note that the installation itself will be in English even if it is installing products translated into another language.

Installing Oracle RepositoryDesigner at the client

There are two ways of installing Oracle RepositoryDesigner at a client workstation: With interactive installation you can make various choices of installation options as the installation proceeds.

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.

Interactive installation

To begin interactive installation, you run Oracle Installer from the Oracle RepositoryDesigner CD-ROM (or from a network, if the latest release of Oracle RepositoryDesigner has been copied there).

When you run Oracle Installer, you will be presented with two ways to install the product:

If you opt for a packaged installation, instructions and help screens are presented as part of the wizard. See also "During installation".

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.

Running Oracle Installer

Log on to Windows at the client workstation. (Log on using an Administrator account for that client; do not log on as the network administrator or any other user.)

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:

If you see the Path Modifications dialog box, click Yes to acknowledge the update to the PATH variable.

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

Packaged installation: installing a package of Oracle RepositoryDesigner products

On the Package Installation Settings screen, proceed as follows.

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".

Custom installation: installing a custom selection of Oracle RepositoryDesigner products

On the "Oracle Repository and/or Designer Installation Type" page of the Installation Wizard, choose Custom Installation/De-Installation and click OK. This cancels the Installation Wizard and displays the Software Asset Manager instead.
Set the installation options
In the Software Asset Manager, click the Options button.

In the Options dialog box, select or clear the check boxes for installation options as desired.

Click OK to continue.

Choose products to install
In the Software Asset Manager, choose one or more of the items in the "Available Products" list.

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: 
  • Receive confirmations before removing or installing products 
  • Receive detailed messages and prompts during various phases of Oracle Installerís function 
  • Record the actions being performed by Oracle Installer in a log file 
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.

Dialogs and messages

If the Free Space dialog box is displayed, note the approximate additional free space needed and ensure that you have enough available disk space to install the products.

Under the following circumstances, Oracle Installer can incorrectly process information about the amount of disk space required:

If you believe either of these circumstances apply to your setup, you can ignore the warning about there not being enough disk space to proceed. Do not, however, ignore any such warnings that occur during the copy phase of installation. Click Yes to continue.

During installation of the Oracle RepositoryDesigner software

Oracle Installer begins copying the files to the local hard disk. A progress bar indicates the percentage of the installation completed.

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 installation of the Oracle RepositoryDesigner software

If you chose to install the 6i import and export tools, the Oracle Universal Installer will open.

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.

Silent installation

Silent installation (a form of batch installation) is achieved through the use of predefined responses from a text file known as a response file. You run the Oracle Installer from the Windows command line, calling the appropriate response file as described later in this section.

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:

  1. Customize the response file you want to use for your site.
  2. Use the response file by running the appropriate installer and calling the customized file.

Customizing the response file

The response file you use must be customized to refer to the Oracle home directory into which you want to install the product. You can customize a response file in one of the following ways: To edit a template response file, open the file you want to use from the product CD, edit it and save the customized file on your local hard drive. You can then call this file when you run the installer, as described in the next section.

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:

orainst /rspdest d:\tmp\response_file.rsp
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.

Using a response file

To use Oracle Installer with a customized response file (RESPONSE.RSP or TOOLSPK.RSP), change the current directory to \INSTALLR\INSTALL on the drive containing the product CD and enter the following at the Windows command line:
orainst /silent /rspsrc d:response_file.rsp
where d is the full pathname, and response_file is the name, of the customized response file you are using.

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:

setup setup.exe [-silent] -responsefile d:response_file.rsp
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.

Post-installation procedures

Start up the database

Ensure that the database that contains, or is due to contain, the repository is started up (using Server Manager, for example).

Set up the database connection

You must configure the Oracle Net or Net8 network software for the correct database connection. You need to:

Test the database connection

Open a SQL*Plus window and test the connection to the database.

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.

Configure the local naming method

We recommend using the local naming method to manage the Oracle Net or Net8 network software at the client. The local naming method reads net service names from a TNSNAMES.ORA file at the client.
Preferred procedure
The preferred procedure for configuration is to use two separate TNSNAMES.ORA files in the two separate Oracle home directories required by the use of Oracle RepositoryDesigner 6i with the Oracle database server.

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".

Alternative procedure
Oracle RepositoryDesigner 6i uses the Oracle8i Import and Export utilities, which are installed into a separate Oracle home, not the default Oracle home into which Oracle RepositoryDesigner is installed. At the end of the client-side installation process, you are asked if you want to use the LOCAL and TNS_ADMIN registry variables to save having to maintain multiple copies of your TNSNAMES.ORA file.

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.

Install/migrate/upgrade the repository

See Chapter 2, "Server-side installation, migration and upgrade".

Create desktop icons (if required)

Oracle Installer creates an entry on the Start > Programs menu that leads to entries for the repository client-side tools. You can create individual icons for these tools in order to access them directly from the desktop.

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

 

Set up Oracle RepositoryDesigner to accept non-English character input (if required)

The characters from any 8-bit language can be entered into Oracle RepositoryDesigner as object names, properties, etc. The database server must use an 8-bit character set.

To set up non-English character input:

  1. Change the client keyboard language in Windows by changing the country or locale setting:

  2. 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.

  3. On the client machine, change the value of the registry entry \HKEY_LOCAL_MACHINE \ SOFTWARE \ ORACLE \ HOME0 \ NLS_LANG from AMERICAN_AMERICA.WE8ISO8859P1 to an 8-bit language, e.g. FRENCH_FRANCE.WE8ISO8859P1 or GERMAN_GERMANY.WE8ISO8859P1.

Start a repository toolOracle Designer

If you created a desktop icon for a repository toolOracle Designer as described in the previous paragraphs, you can start the toolOracle Designer from there. Otherwise, you can use the Start button on the Windows taskbar.

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

Troubleshooting a client-side installation

If a client-side installation does not complete satisfactorily, this may not be apparent until you or other users try to start Oracle RepositoryDesigner. Any problems will be indicated by error messages at the client. Error messages give possible actions for solving the problem, and additional help from within the error message system may also provide further explanation.

Removing Oracle products

On the Software Asset Manager window of the Oracle Installer, the Products Installed list shows the Oracle products, if any, that are currently installed on the workstation. You can use this list to select Oracle products for removal. 

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:

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?
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.

To remove Oracle products:

  1. Start Oracle Installer (see "Running Oracle Installer") and choose Custom Installation/De-Installation.

  2.  
  3. When the Software Asset Manager is displayed, select (from the Products Installed list) the names of the products you want to remove. Use the SHIFT key to select adjacent products, or the CTRL key to select non-adjacent products.

  4.  
  5. When you have selected all the products you want to remove, click the Remove button.

  6.  
  7. Reply Yes to the Confirmation message.

  8. 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.

  9. When you see the message "De-installation complete", click OK to return to the Software Asset Manager.

Removing all installed Oracle products

To remove all installed Oracle products:
  1. Start Oracle Installer (see "Running Oracle Installer") and choose Custom Installation/De-Installation.

  2.  
  3. When the Software Asset Manager is displayed, select all the product names in the Products Installed list. A quick way to do so is to select the first product in the list, scroll down to the bottom, hold down the SHIFT key and select the last product in the list.

  4. Since you cannot remove Oracle Installer itself, selecting it here will simply display a message to that effect later in the process.

  5. Click the Remove button.

  6. 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.

  7. If any products remain in the Products Installed list (apart from Oracle Installer itself), repeat the process from Step 2.

  8. If products persist in the Products Installed list, repeat the process from Step 2, replying Yes to any messages about removal of dependent products.

  9. When all products other than Oracle Installer are removed, click Exit to close Oracle Installer.

  10.  
  11. Use Windows Explorer to remove the Oracle home directory.

  12.  
  13. You can now remove the remaining Oracle folder and shortcuts. Consult the documentation for your version of Windows for instructions on how to do this.
On deinstalling Oracle RepositoryDesigner products, some Oracle RepositoryDesigner entries will remain in the Windows Registry. This will have no adverse effect on your system.
 


Previous
Prev
Next
Next
Oracle logo
Copyright © 2000, 2004, Oracle Corporation.
All Rights Reserved. 
 
Contents icon
Contents