Solaris UNIX Installation Instructions

This section explains how to install Meta Manager on a Solaris UNIX platform and how to begin configuring the application for your needs.

Before you install Meta Manager, you should be logged in as the root user, unless:

• you plan to install Meta Manager on a port greater than 1024; and,
   
• the location where you plan to install Meta Manager (the server root directory) is writable with your current login status.

The oracle account(s) used by Meta Manager must be pre-created, have connect and resource privileges, and enough tablespace quota to store the fgdc data.

Before You Begin Installing

Meta Manager needs specific software and hardware. Before you can run the installation, you must comply with the requirements in the following sub-sections.

Software Items

The following software items will be required:

1. Oracle Release 7.1.6 or later.
    
2. Meta Manager Installation Software (located in the /server_software/solaris_oracle directory of this CD-ROM).
    
3. A Z39.50 client such as Meta Miner Clearinghouse test server.
    
4. Netscape Navigator or Microsoft Internet Explorer.
    

Hardware and Operating System

The following hardware will be required:

1. Any CPU running a supported UNIX operating system:
• Sun (Solaris 2.3 or better)
   
2. Minimum 32 MB RAM. 64 MB or more is recommended for servers that will handle a high volume of traffic.
    
3. 5 MB of free hard disk space.
    

Procedure:

1. Unzip and extract the contents of the the downloaded tar file file into a temporary installation directory.
    
2. Verify that the installation directory contains three files and six subdirectories as follows:
• LICENCE - A file describing the restrictions on the use of the toolkit.
• README - A file describing the contents of the toolkit.
• admin/ - A subdirectory containing the administration interface.
• bin/ - A subdirectory containing the de-install script.
• database/ - A subdirectory containing the toolkit database components.
• doc/ - A subdirectory containing the toolkit documentation.
• install - A shell script that will install the toolkit.
• server/ - A subdirectory containing the Meta Manager Z39.50 server component
• tutorial/ - A subdirectory containing the tutorial database component.
   
3. Verify that the doc subdirectory contains the following document:
• users_manual.pdf - User's Manual (PDF format). The PDF file can be viewed using the freely downloadable Adobe Acrobat Reader program (Version 3.0 or later).
   
4. In the directory into which the toolkit was extracted (e.g., /tmp/mminst), execute the following command: ./install. The following message and prompt will be displayed:
   
   
   /****************************************************************** *******/
   /                              Meta Manager                              /
   /                          Installation Script                           /
   /                              Version 4.0.1                           /
   /                                                                        /
   /                  Copyright Compusult Limited - 1998 - 2001            /
   /                                                                        /
   /****************************************************************** *******/
   Enter license key?
    
5. Enter the Meta Manager licence key. This key is used by the server on start-up and can be obtained by contacting Compusult Limited at 1-888-388-8180 or licence@compusultl.nf.ca . The following prompt will be displayed:
   
   Enter Meta Manger destination directory?
    
6. Enter the pre-created location for the toolkit (e.g., /apps/metaman40). The following prompt will be displayed:
   
   Enter value for ORACLE_HOME?
    
7. Enter the location of the oracle installation (e.g., /u01/app/oracle/product/7.3.2). The following prompt will be displayed:
   
   Use SQL*Net to access database [yes]?.
    
8. To access a local database, answer no and go to Step 10. To access an external database using SQL*Net, answer yes and go to Step 12.
    
9. The following prompt will be displayed:
   
   Enter the value for ORACLE_SID?
    
10. Enter the SID of the Oracle database that you are using (e.g., ORCL). Go to Step 15.
     
11. The following prompt will be displayed:
    
    Enter value for TNS_ADMIN?
     
12. Enter the location of the TNS administration files (e.g., /u01/app/oracle/admin/network/admin). The following prompt will be displayed:
    
    SQL*Net TNS Name for database?
     
13. Enter the TNS name (e.g., mydb).
     
14. The following prompt will be displayed:
    
    Enter Username for DB account to house Toolkit database components?
     
15. Enter the name of the pre-created DB account (e.g., mmadmin). The following prompt will be displayed:
    
    Enter password for DB account mmadmin?
     
16. Enter the accounts password (e.g., mmadmin). The following message and prompt will be displayed:
    
    Verifying Oracle connectivity with information provided ... Success.
    Enter port number for the Z39.50 YAZ Server?
     
17. Enter the TCP/IP port number you wish to use for your Z39.50 server (e.g., 9999) The following messages and prompt will be displayed:
    
    You have provided all the information required for the initial installation of the Meta Manager. Please standby as the pieces are installed.
    Installing Meta Manager Oracle database components ... Success.
    Installing Meta Manager Z39.50 server components ... Success.
    Installing Meta Manager Administration Interface components ... Success.
    Installing Meta Manager Documentation Components ... Success.
    Would you like to install the Meta Manager tutorial? (Y/N) [N]
     
18. Enter Y if you wish to have the tutorial tables installed. The following messages and prompt will be displayed.
    
    Enter the Username for the tutorial account?
     
19. Enter the pre-created db account name for the tutorial (e.g., mmtut). The following messages and prompt will be displayed.
    
    Enter the Password for the tutorial account?
     
20. Enter the account's password (e.g., mmtut). The following messages and prompt will be displayed:
    
    Verifying Oracle connectivity for tutorial/tutorial ... Success.
    Import: Release 7.3.2.1.0 - Production on Mon Mar 30 10:29:26 1998
    
    Copyright (c) Oracle Corporation 1979, 1994. All rights reserved.
    
    Connected to: Oracle7 Server Release 7.3.2.1.0 - Production Release
    With the distributed and Spatial Data options
    PL/SQL Release 2.3.2.0.0 - Production
    
    Export file created by EXPORT:V07.01.06 via conventional path
    . . importing table                      "AGENCY"         7 rows imported
    . . importing table            "ELEMENT_MAPPINGS"       642 rows imported
    . . importing table              "KEYWORD_LOOKUPS"       1023 rows imported
    . . importing table              "KEYWORD_THEMES"         1 rows imported
    . . importing table        "METADATA_COLLECTIONS"         2 rows imported
    . . importing table            "METADATA_ELEMENTS"       642 rows imported
    . . importing table              "METADATA_GROUPS"       242 rows imported
    . . importing table          "METADATA_STANDARDS"         1 rows imported
    . . importing table                "METADATA_TEMP"       442 rows imported
    . . importing table                "PRESENT_SETS"         3 rows imported
    . . importing table        "PRESENT_SET_ELEMENTS"       692 rows imported
    . . importing table                      "S57DATA"         75 rows imported
    . . importing table                  "S57METADATA"         76 rows imported
    . . importing table    "SEARCH_OVERRIDE_ELEMENTS"         5 rows imported
    . . importing table          "SQL_SEARCH_RESULTS"         0 rows imported
    . . importing table                  "TABLE_LINKS"         2 rows imported
    . . importing table                  "TEMP_TABLE"       121 rows imported
    Import terminated successfully without warnings.
    
    You have successfully installed Meta Manager onto your system
    You now have to use the Meta Manager Administration interface to describe your
    Oracle-based datasets so that the Z39.50 server can make them available.
    
    Once you have described one or more datasets using the administrative
    interface, you can start the Z39.50 server with the command:
    /apps/metamanager/bin/rc.toolkit start
    
    Would you like to execute the Administration Interface now (Y/N) [N]?
    
     
21. Enter no if you do not want the interface executed. The following messages will be displayed.
    
    You can execute the administration interface at any time using the command:
    /apps/metamanager/bin/toolkit_admin
     
22. The Unix portion of the installation is now complete. If you are planning to use the Windows 95/98/NT® Administration module, click here for the Administration Module Installation Instructions or see Chapter 3 of the User's Manual.

The Unix portion of the installation is now complete. If you are planning to use the Windows 95/98/NT¨ Administration module, you may continue with the Windows 95/98/NT Admin Interface installation.