----------------------------------------------------------------------------

Mamoe V3.0 Installation Guide for Irix

----------------------------------------------------------------------------

  1. Installation of the Software

     1.1 Installation from CDROM

        o Insert Mamoe CD-ROM in the CD-ROM drive.
        o Select System->Software Manager in the Toolchest. Enter the
          super-us erpassword in the password dialog. (If you logged in as
          the super-user, you do not need to enter the password.)
        o The window of software Manger comes up. Enter the CD-ROM drive
          path in the upper input field. The path of the local drive is
          /CDROM/dist. (If you would not know the drive name, please consult
          the system administrator of your site.) Click Lookup button after
          entering the path.
        o If you install under the default configuration, just click Start.
          The subsystem with [d] in the list below will be installed. If you
          would prefer the custom configuration, click Customize
          Installation... button and put checks on the subsystem you need
          and click Start.

          The default installation configuration

          + IMAGICA Mamoe V3.0                           [d]   Mamoe
            - CAL file converter for 3D Studio MAX       [d]   Mamoe.tools.cal2ms
            - CAL file converter for Inferno             [d]   Mamoe.tools.cal2infe
            - Mamoe Demos                                [d]   Mamoe.demos.sample
            - Mamoe Executable Environment               [d]   Mamoe.sw.base
            - Mamoe Online Manual (html)                 [d]   Mamoe.doc.www
            - Mamoe Plug-in for Maya                     [d]   Mamoe.plugin.maya
            - Mamoe Plug-in for SOFTIMAGE|3D             [d]   Mamoe.plugin.si

          + Fast Light Tool Kit, 1.0.1                   [d]   fltk
            - FLTK - Development Environment, 1.0.1      [d]   fltk.sw.dev
            - FLTK - Development Manuals, 1.0.1          [d]   fltk.man.eoe
            - FLTK - Execution-Only Environment, 1.0.1   [d]   fltk.sw.eoe

          + IMAGICA FLEXlm license                             imagica_flexlm
            - Base Software                                    imagica_flexlm.sw.base

        o After finishing the installation, quit the SoftwareMananger and
          eject the CD-ROM.

     1.2 Installation from the downloaded file

     The Mamoe program can be downloaded at

     http://www.ise.imagica.co.jp/mamoe/english/download.html

        o Put the downloaded file in a temporary directory. We will use
          /usr/tmp as the temporary directory here after in this manual. The
          default file name has .tar.gz as the file name extension. Here is
          the installation procedure for mamoe_eoe_onlyexe3.0.tar.gz. Log-in
          as the super user and open a Unix Shell Window. Type as follows.
          >> # cd /usr/tmp
          >> # gzip -d mamoe_eoe_onlyexe3.0.tar.gz
          >> # tar xvf mamoe_eoe_onlyexe3.0.tar

          You will get 3 files extracted.

          Mamoe, Mamoe.idb, Mamoe.sw

        o Select System->Software Manager in the Toolchest. Enter the
          super-us er password in the password dialog. (If you logged in as
          the super-user, you do not need to enter the password.)
        o The window of software Manger comes up. Enter the directory path
          of the downloaded file '/usr/tmp' and click Lookup button.
        o If you install under the default configuration, just click Start.
          The contents of the default configuration varies according to the
          version of the downloaded file. If you would prefer the custom
          configuration, click Customize Installation... button and put
          checks on the subsystem you need and click Start. After finishing
          the installation, quit the SoftwareMananger and remove the
          temporary files.
          >> # cd /usr/tmp
          >> # rm Mamoe* mamoe*

  2. Installation of the license files.

     imagica_flexlm Package is a license management system (based on FLEXlm)
     that allows you to execute Imagica software.

     A super user privilege is necessary to execute 2.1,2,2 and 2,3.

     2.1 Installation

     Install "imagica_flexlm" package with the Software Manager (swmgr). Use
     'Cu stomize Installation...' to make sure if FlexLM product is checked.

     2.2 Setting up the license

     Your license file is distributed by e-mail. Save the license text in
     'licens e.dat' under /var/flexlm/imagica/. If you have already had a
     license file in the directory, append the text string to the existing
     file. If the existing license file includes same SERVER line and same
     VENDOR line, you can omit the lines. When you want to add a new
     'FEATURE' line, replace the product name of older version to the latest
     version. Do not append the product name of new version to the product
     name of older version. In the license file, the line start with '#' is
     a comment.

     2.3 Start up the license daemon

     The license daemon retains in main memory to manage the licensing
     mechanism. After creating/appending the license file, restart the
     license daemon as follows:
     # /usr/imagica/bin/imagica-daemon stop
     # /usr/imagica/bin/imagica-daemon start

     If you 'stop' daemon when it is not running, this command just display
     "Shutdown failed". There is no side effects.

     2.4 User settings

     The application users should set an environment variable.
     LM_LICENSE_FILE defines the license file. If you have the license file
     in your local host, run the following command:

     % setenv LM_LICENSE_FILE /var/flexlm/imagica/license.dat

     If you have the license file in your remote server:

     % setenv LM_LICENSE_FILE @server_name

     You can include the command lines in your .login to set the variable
     automatically every time when you log in.
     (Note: some applications set the variable by themselves.)

     If you use some other FLEXlm based applications and do not want to
     change the variable "LM_LICENSE_FILE", you can use IMAGICA_LICENSE_FILE
     instead. Set the execution path. The application programs are located
     in /usr/imagica/bin/. It is recommended to include the following line
     in your .login :

     % set path = (/usr/imagica/bin $path)

  3. Installation of CG plug-ins

     Below are the procedures to install the camera import plug-ins for two
     popular 3D software applications...

     3.1 SOFTIMAGE|3D ( Supported versions : 3.8,3.8sp1 and 3.8sp2)

       1. Copy mamoe2soft.cus in

          /usr/imagica/lib/Mamoe/plugins/si/motion/

          to the directory that is indicated in the Softimage environment
          variable SI_CUSTOM_MOTION.

          # cd /usr/imagica/lib/Mamoe/plugins/si/motion/
          # cp mamoe2soft.cus $SI_CUSTOM_MOTION

          Note: SI_CUSTOM_MOTION may be defined on the fly while the
          Softimage|3D application is running (The error 'undefined
          variable' will appear after executing the above command). In this
          case, copy the file directly to the directory. Please consult the
          system administrator of your site for more information about doing
          this.

       2. Copy calExchange.so in

          /usr/imagica/lib/Mamoe/plugins/si/dso_38
          to a directory that is set as 'PATH'.
          If /usr/softimage38/custom/bin is used, type:

          # cd /usr/imagica/lib/Mamoe/plugins/si/dso_38/
          # cp calExchange.so /usr/softimage38/custom/bin

          Note: If you have difficulty setting the environment variables,
          please consult the system administrator of your site.

     3.2 Alias|Wavefront Maya ( Supported version : 1.0,1.5,2.0,2.5,3.0)

       1. Copy mamoe2maya.mel in

          /usr/imagica/lib/Mamoe/plugins/maya/scripts/

          to the directory that is indicated in the Maya environment
          variable MAYA_SCRIPT_PATH.

          # cd /usr/imagica/lib/Mamoe/plugins/maya/scripts/
          # cp mamoe2maya.mel /usr/maya/scripts

          Note: MAYA_SCRIPT_PATH may be defined on the fly while the Maya
          application is running (The error 'undefined variable' will appear
          after executing the above command). In this case, copy the file
          directly to the directory. Please consult the system administrator
          of your site for more information about doing this.

       2. Copy maRead_calFile.so in

          /usr/imagica/lib/Mamoe/plugins/maya/dso_XXX/ (XXX is version
          number)

          to a directory that is set as MAYA_PLUG_IN_PATH.
          If /usr/maya/bin/plug-ins is used, type:

          # cd /usr/imagica/lib/Mamoe/plugins/maya/dso_XXX/ (XXX is version
          number)
          # cp maRead_calFile.so /usr/maya/bin/plug-ins

          Note: If you have difficulty setting the environment variables,
          please consult the system administrator of your site.

Copyright IMAGICA Corp. 1999-2001 All Right Reserved.

  ------------------------------------------------------------------------


