This file provides the following information for ObjectStore Inspector Release 7.2:
If necessary, download the ObjectStore Inspector software and license file from the Progress Download Center site. You need an ESD account to access the Download Center. For more information on downloading the Inspector software, see the "Download and Unpacking Instructions" for Inspector at the Progress Download Center.
Install the software as follows:
ObjectStore Inspector must be able to communicate with an ObjectStore Server during installation and during operation. You can determine if an ObjectStore Server is running on the installation computer with the ObjectStore commands oshostof and ossvrping:
> oshostof <Inspector-install-directory>\lib\vomsch70.adb coax > ossvrping coax The ObjectStore Server on host coax is alive
By default, ObjectStore Inspector is configured to use an ObjectStore Server running on the installation computer. You can configure ObjectStore Inspector differently if an ObjectStore Server is not running on the installation computer, or if you want to use one running on a different computer. If you want to do this, you must specify where on the network ObjectStore Inspector should be configured to access its application schema database, and copy it there.
You can specify where to locate the ObjectStore Inspector application schema database after you install ObjectStore Inspector.
By default, ObjectStore Inspector is configured to use a local ObjectStore Server for its application schema database. If an ObjectStore Server is not running locally, the application schema database must be copied to a location on the network where it can be accessed by an ObjectStore Server, and ObjectStore Inspector must be configured to find it there.
You can use the ObjectStore Inspector Configuration Utility to configure Inspector if a local ObjectStore Server is not running on your computer.
The Configuration Utility lets you configure ObjectStore Inspector to use an ObjectStore Server located on your network. To start the Configuration Utility, click Programs | ObjectStore Inspector 7.2.0 | Application Schema Configuration on the Start menu.
The main window displays the status of the ObjectStore Inspector installation, including:
The color of the traffic signal tells you the following about the installation:
The Configuration Utility also provides information about whether an ObjectStore Server is running on the computer where the application schema database is expected to reside. The Configuration Utility displays a specific message under the following conditions:
To change ObjectStore Inspector's application schema database configuration, click the Change button in the Application Schema Configuration Utility main window. The Choose an ObjectStore Server dialog box appears. It contains a list of all the computers on the network (including the UNIX computers if a PC-NFS client is running on the local workstation).
An ObjectStore icon is displayed next to the computer's name if an ObjectStore Server is running on it. (A question mark appears on those computers while the program checks for the presence of a running ObjectStore Server.) Click on a computer's name to see a list of logical units connected to that computer and any ObjectStore Server rawfs partitions.
You can use the Choose an ObjectStore Server dialog box to help find a specific location on the network where you would like ObjectStore Inspector's application schema database to be located. You can choose to locate it in a networked computer's file system, in a rawfs partition, or on a computer on an NFS network.
To locate the application schema database in a file system on the network, double-click on a logical unit listed under one of the workstations displayed. If you select a remote workstation which has no logical units connected to its file system, the program allows you to build a new connection. Select the directory where you want the application schema database to be located and click the Choose button.
Note that an ObjectStore Server must be running on both the local computer and on the computer on which the selected RAWFS is physically located.
To locate the application schema database in an ObjectStore rawfs partition, double-click on a rawfs icon, select the directory where you want the application schema database to be located, and click the Choose button. The Configuration Utility attempts to copy the application schema database into the specified rawfs directory and configure ObjectStore Inspector to access it there.
Note that an ObjectStore Server must be running on both the local computer and on the computer on which the selected directory is physically located.
To locate the application schema database in an NFS directory, choose the NFS Path button, and specify any valid path using NFS format:
<host-name-or-address>:<path>
For example, the following are valid NFS paths:
ciro:/usr/local
150.145.2.2:/opt
When you click on the OK button, the Configuration Utility attempts to copy the application schema database into the specified directory and configure ObjectStore Inspector to access it there.
If the copy operation does not succeed, the system displays a warning message indicating that you should perform the copy manually.
When you finish specifying a location for the application schema database, return to the Application Schema Configuration Utility main window and check the status of the installation to make sure that ObjectStore Inspector is ready to be used.
To uninstall ObjectStore Inspector:
If you plan to deploy user defined methods, such as that included in the methods example packaged with Inspector, you should perform the following steps:
osiconfig utility, set the application schema
directory for Inspector to a directory on your machine. ObjectStore recommends
the %OS_ROOTDIR%\bin directory because that is where other
schema libraries are located.
ossetasp utility, verify that the
.DLL library points to the correct application
schema that was generated when the methods example was built. For example,
the people.dll methods example should point to the
people.adb application schema.
.DLL file to the application schema
directory for ObjectStore Inspector that is specified in step 1.
For example, in the methods example is is the file people.dll.
readme in the method example says to
copy the .DLL to the system path, but you should copy it
to the application schema directory instead.
(Copying the .DLL to the system path which is not the application
schema directory will result in the application schema not being loaded from
the .DLL and thus trying to register or use user defined
methods results in an error stating that the class is not registered in
any DLL schema associated with the database.)In order to build and run the Methods example, do the following:
people.dll and people.adb.
readme.txt file.
With Visual Studio .NET 2005, before building the methods example, you should
modify the ossg command line to include the following macros:
/D_OS_MSC_VC8 /D_CRT_SECURE_NO_DEPRECATE /D_SCL_SECURE_NO_DEPRECATE
/D_CRT_NONSTDC_NO_DEPRECATE /D_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES=1
/D_USE_32BIT_TIME_T
Without fixing the ossg build rule the example will fail to build.
The ossg command lines for the other Inspector examples have
already been modified with the above macros.
With Visual Studio .NET 2008, before you build the methods example,
modify the ossg command line to include the following macros:
/D_OS_MSC_VC8 /D_CRT_SECURE_NO_DEPRECATE /D_SCL_SECURE_NO_DEPRECATE
/D_CRT_NONSTDC_NO_DEPRECATE /D_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES=1
/D_USE_32BIT_TIME_T /D_USE_DECLSPECS_FOR_SAL
The ossg command lines for the other Inspector examples have
already been modified with the above macros.
The Configuration Utility incorrectly shows a green traffic signal if the network directory selected for the application schema database is a UNIX (NFS) directory that is not physically mounted on the computer associated with it by the Configuration Utility. In this case, make sure that an ObjectStore Server is running on the computer on which the partition is physically mounted.
Thank you for your interest in ObjectStore Inspector.
You can contact the Progress Technical Support organization in the following ways:
Electronic Mail:: ostore-support@progress.comCopyright © 2010 Progress Software Corporation. All rights reserved.
All use, reproduction, transfer, publication or disclosure is prohibited except as expressly permitted in the applicable license agreement.
All Progress Software Corporation brands and product names are trademarks or registered trademarks of Progress Software Corporation or one of its affiliates or subsidiaries. Other brands and product names may be trademarks or registered trademarks of their respective owners. No license is granted to reproduce or use any such brand, product name or trademark, except as expressly provided for in the applicable license agreement.
Progress Software Corporation considers information included in this software to be Confidential Information. Your access and use of this Confidential Information is subject to the terms and conditions of the software license agreement, which has been executed and with which you agree to comply. Accordingly, you may not disclose or disseminate any such Confidential Information except as expressly permitted under such license agreement.