This document explains the steps to install product It is divided into the following each parts.

INDEX

Installing UNIX Versions

Notice of UNIX version	:	Explains the notice to install UNIX host products.
Steps to installing UNIX version	:	Explains the steps to install UNIX host products.
How to be licensed on UNIX version	:	Explains how to be licensed before using GHS tools (UNIX).

Installing Win32 version

Notice of Win32 version	:	Explains the notice to install Windows host products.
Steps to installing Win32 version	:	Explains the steps to install Windows host products.
How to be licensed on Win32 version	:	Explains how to be licensed before using GHS tools (Win32).
How to be checked the dongle problem	:	Explains how to be checked when you cannnot recognize the dongle.

Release information on this product is stored in HTML format under info/ in the directory where the package is installed. Be sure to read it carefully with your web browser.

A special file is also stored into info/ so that you can refer the product name and product version. This file consists of the output from gversion for each file prepared in the package. (gversion outputs the last modified date even for such a non-executable file as library or source code, as well as the output from "ls -l".) The last six-digit number in the file name indicates the release number of the product.

(Example) mlt-us-040000.lst ; MULTI Release 4.0.0

Moreover, a template file used for technical support by e-mail can be found under info/. You can use it to contact us for a technical communication.

Please re-invoke a License Manager after installing the license when you add or modify a newly floating license.

Back to Index

Note that the installation steps may vary depending on the product media.
The super user privilege is necessary for the execution of the installation. And device name specified here may vary depending on the system. Contact your system administrator, if you are not sure of the device name.

- When "CD_install.sh" exists in a top directory of the CD-R:

1. Please invoke the CD_install.sh in the CD-R. And, please enter some information according to the message.

   (Ex.) % /cdrom/CD_install.sh

- When "CD_install.sh" does not exists in a top directory of the CD-R:

1. Create a directory to copy the package. This directory can be used not only as a temporary use but as a target directory for the installation.

   (Ex.) % mkdir /usr/green/XXX.V505

2. Change the current directory to that directory.

   (Ex.) % cd /usr/green/XXX.V505

3. Install a package (product.tgz) by using the "gtar" command.
   (You can find out "gtar" command in CD-R:/utilities/)

   (Ex.) % /cdrom/utilities/gtar -zxvf /cdrom/product.tgz

After completing the installation, please read the "How to be licensed on UNIX version" section.

Back to Index

1. Invoke the elan_install_e.sh (English version) or the elan_istall_j.sh (Japanese version) in the directory which installed the product then enter some informations according to the message.

2. We need some informations such as the your server code. Elan_install_j(e).sh generate the template file to request license key. Please fill each item such as a Name, Division, Company, Product Serial #(enter all the serial numbers for applicable products), etc. into this template file, and then send it to the following mail-address via e-mail.

   Purchased at Asian area: license@adac.co.jp

   Purchased at US, EU area: license@ghs.com

3. Our company replies mailing the license key generation script (key_install.sh) within 2 business days after receiving your mail. If you get this script then put into the directory which installed product then invoke this script (key_install.sh).

4. Next, you should be invoke the license manager. The License Manager script (Sghs_elmd) is generated with elan_install_e(j).sh.

   
       % Sghs_elmd start   ; Invoke the License Manager
       % Sghs_elmd stop    ; Stop the License Manager
     

5. Run the shell script (install.sh) to install the package properly on your system.

   
       % ./install.sh
     

   Then some brief checks are performed with the installed compiler.

   The installation is completed if a message "Test passed" is output for each check.

6. It is the above-mentioned operation and setting the license of the tool is finished.

   (Notice)

   • About license manager's detailed use, refer "Green Hills License Manager System Administrator's Guide" to know details about the license manager.

   • On your client HOSTs, with environment variable, you will have to select the server host on which the license manager is working.

           Variable Name:  GHS_LMHOST
           Variable Value: @{Server_Name or IP_address} 
     
           (Ex.) setenv GHS_LMHOST @master1
                   or
                 setenv GHS_LMHOST @192.0.9.145
         

Back to Index

[ Common items ]

• You must be a user with an administrator's privilege to install, uninstall, or reinstall on Windows 2000/XP/Vista.

• Setup the environment variable on your client PCs:
  • Please set the "GHS_LMWHICH" to "elan" value.

  • When you purchased a floating license:

    On your client PCs, with environment variable, you will have to select the server host on which the license manager is working.

        Variable Name:  GHS_LMHOST
        Variable Value: @{Server_Name or IP_address} 
          

  • How to setup the environment valiable:

        Windows 98/Me:
    
            Please add the command below in autoexec.bat.
    
                 set GHS_LMWHICH=elan
                 set GHS_LMHOST=@{Server_Name or IP_address} 
                      (Ex.) set GHS_LMHOST=@myserver
    
            And then please reboot PC. 
    
        Other Windows (2000/XP/Vista...):
    
            Please set environment variable below with menu item.
    
              "Control Panel" -> "System" -> "Environment Vriables"
    
                 Variable Name:  GHS_LMWHICH
                 Variable Value: elan
    
                 Variable Name:  GHS_LMHOST
                 Variable Value: @{Server_Name or IP_address} 
                                 (Ex.) @myserver or @192.1.2.3
          

[ Configuration to use GHS tools on Windows XP SP2 or later. ]

• Client Machines

  When you invoking GHS tools on Windows XP SP2 or later, a Windows Firewall Security Alert dialog box will be appear. The window prompts you to choose an option. If it is shown, please select "Unblock this program".

• License Server Machines

  Please configure your license server machine to get the port license server uses to be available on Windows XP SP2 or later.

  1. Click Start, click Run, type wscui.cpl in the Open box, and then click OK.
  2. Click Windows Firewall.
  3. On the Exceptions tab, click Add Port.
  4. In the Add a Port dialog box, type the number of the port, 8171, and then click UDP.
  5. Type a name for the port, and then click OK. For example, type ElanLM.
  6. To view or set the scope for the port exception, click Change Scope, and then click OK.
  7. On the Exceptions tab, notice that the new service is listed. To enable the port, click to select the check box next to the service, and then click OK.

[ When a newly floating license is added or changed. ]

• Please re-invoke a License Manager after installing the license when you add or modify a newly floating license.

Back to Index

This section explains the steps to install this product.

1. Set CD-R onto the drive.

2. Select CD-R drive in Explorer and double-click setup.exe. Then follow the instructions to install.

(Notes)

• Please do not install the product in the folder whose name has the space between letters. (Ex. "C:\Program Files\green")

Back to Index

1. If a dongle is provided with the package, connect it to a parallel port (or connect it to a USB port) on your PC.

   Drivers Install wizard window is appearing when you insert the USB port. Please operate it according to the wizard window.

   If your OS is Windows 98/Me, you need to reboot Windows.

2. Please invoke the licinfoe.exe utility to obtain it and fill in a necessary matter about license key information.

3. Please get the license request information made by the licinfoe.exe utility, and then send it to the following mail-address via e-mail.

   Purchased at Asian area: license@adac.co.jp

   Purchased at US, EU area: license@ghs.com

   Notice:

   • Fill "Subject:" field at the mail header with the first line of this file.

   • Send the file as a message of the e-mail (not an attached file).

4. Our company replies mailing the license file (license.key) within 2 business days after receiving your e-mail. If you get this e-mail then please store it in the package installed directory.

5. Please invoke the instkey.exe utility, select license key file (license.key) on the file selection window, and push the installation button.

6. If you purchased a floating license, Please invoke the License Manager at the Control Panel Window.

   Please refer "Green Hills License Manager System Administrator's Guide" to know details about the license manager.

7. It is the above-mentioned operation and setting the license of the tool is finished.

   (Notes)

   • Please remove existing a Node-lock license folder (C:\green\nodes\ etc.) on your server host that is for GHS License Manager. Since, your client machines do not acquire a license under the condition.

Back to Index

Using "wlmadmin.exe" and item "Server Code" is not shown as "65536/...", please check below. (Start from 1 below, in order.)

• In case of using dongle for USB port
  1. Dongle is not connected or loose contact

     Please check whether it is connected properly.

  2. USB dongle driver (pandora.sys) is not installed correctly.

     After uninstalling the product, open Windows "Control Panel" -> ("System") -> "Device Manager", uninstall "Pandra key" in "USB Keys" and re-install the product.

• In case of USB dongle is not detected in Windows 7

  In Windows 7, sometimes message "Device driver software was not installed successfully." appears when USB dongle is inserted. In this case, please update the driver software as below.

  1. Open "Control Panel".
  2. Launch "Device Manager".
  3. Right-click "Other Devices" -> "Unknown Device", select "Update Driver Software...".
  4. Choose "Browse my computer for driver software".
  5. Click "Browse" button next to "Search for driver software in this location:" pull-down, specify "USBdrivers\Win32Bit\USBdongle" folder (or "USBdrivers\Win64Bit\USBdongle" for 64bit Windows) in Installer media (CD-ROM) or tool directory.
  6. Then driver install will be started.
  7. If "The best driver software for your device is already installed" windows appears, once remove current driver software (as below) and then update the driver.
     1. Launch "Device Manager", right-click "Pandora Key" and select "Uninstall".
     2. "Confirm Device Uninstall" window appears, select the "Delete the driver software for this device." checkbox, then click "OK".
     3. If driver uninstall is completed, open "Device Manager" window again, click "Scan for hardware changes." button, or remove the USB dongle and re-insert it to USB port.
     4. Repeat from item 2 above.

  8. In "Update Driver Software" window, if message "Windows has successfully updated your driver software." and "Pandora Key" are appeard, driver install is successful.

  9. Then open "Device Manager" again, confirm "USB Keys - Pandora Key" is successfully detected.

Back to Index

END