After You Install

Registering Khoros

In order to receive information on updates of the software and the Khoros Knews newsletter, you must register.

If you have an e-mail account, run the Khoros program, xvregister. Otherwise, fill in the enclosed Khoros registration form and mail or FAX it to:

Attn: Products Group
Khoral Research, Inc.
6001 Indian School Rd. N.E.
Suite 200
Albuquerque, NM 87110-4139, USA

FAX: (505)881-3842

Verifying Installation

Spot-Checking the Applications

Try executing a few applications:


> kman kman
> cantata &
> craftsman &

In Cantata, try running through the sample workspaces files in the Sampledata toolbox. In Craftsman, try creating a new toolbox and creating a new software object in that toolbox.


Note: This process can be more fun and instructive if you install the Sampledata toolbox first.

Test Suites and Sample Data


Important: You must have installed the Khoros development environment and the Sampledata toolbox before you can run the test suites.

Running all the test suites can take several hours. You may wish to run only the test suites for the Bootstrap toolbox.

If there are any testsuites in <$TOOLBOX>/testsuite, run them:


> cd <Khoros Installation Directory>/<$TOOLBOX>/testsuite
> kgenmake; make Makefiles; make test

For example:


> cd /usr/local/khoros220/bootstrap/testsuite
> kgenmake; make Makefiles; make test

Reclaiming Disk Space by Removing Unneeded Files

Removing Test Suites

Once you're satisfied with the test suite results, you can delete the testsuite directory structure from the toolbox. Deleting the testsuite directory will save (approximately) the following amounts of space for the toolboxes indicated:

BOOTSTRAP 1766K
DATAMANIP 2196K
DATASERV 1346K
DESIGN 87K
RETRO 5673K
IMAGE 291K
MATRIX 119K

Total space saved is about 11.5 MB.

Removing Intermediate Build Files

After you have run kbuild, then you can do a "make clean" for all objects in the toolbox:


> cd <install dir.>/<$TOOLBOX>/objects
> make clean

Removing Example Programs

If there are any example programs included with the toolbox, they'll be in $TOOLBOX/examples/. You can delete this directory structure if you are not doing software development and/or will not need programming examples. Deleting the examples directories will save (approximately) the following amounts of space for the toolboxes indicated:

BOOTSTRAP 28K
DESIGN 486K
ENVISION 2844K

Total space saved is about 3.4MB.


Important: Do not delete the <$SAMPLEDATA>/examples directory, as it contains sample workspaces for Cantata.

Removing 'Info Files'

Most objects in the toolbox will have 'info files', located in the info directory of software objects. For example, for a software object called foobar, you might find:

foobar.todo list of things to do
foobar.done high level list of things done
foobar.changelog changelog for object

If you're not concerned with the contents of these files, you can delete all info files in a toolbox with the following shell script:


> sh
$ for object in `kecho -tb <$TOOLBOX> -echo objects`; do
? opath=`kecho -tb <$TOOLBOX> -oname $object -echo path`
? cd $opath
? /bin/rm -rf info
? done
$ exit

Deleting the info directories of all software objects in a toolbox will save (approximately) the following amounts of space for the toolboxes indicated:

BOOTSTRAP 329K
DATAMANIP 644K
DATASERV 149K
DESIGN 523K
ENVISION 134K
GEOMETRY 84K
IMAGE 82K
MIGRATION 61K
MATRIX 91K
RETRO 232K
SUPPORT 102K

Notice that this will only save about 2.4 MB across the system.

Compressing Source Files

If you are tight on space, you can gzip all source files once you've compiled the toolbox. Do not gzip anything that's in a directory other than:

<$TOOLBOX>/objects/<object type>/<object name>/src

for each of the software objects!

Resulting savings are left as an exercise for the reader.

Khoros Support Services

Professional Services

KRI provides extended professional services available on an hourly or long-term basis.

Engineering Consulting Services

Engineering Consulting Services offer assistance with custom programming, toolbox creation, porting to unsupported platforms, and other specialized application needs. Engineering Consulting Services may be purchased at an hourly rate or as a long-term contract.

Technical Support

Thirty days free installation support is available only to registered owners of Khoros Pro.

If you would like to purchase technical support (information on installation, compilation, and running of Khoros) or engineering consulting services (information on customizing Khoros software), please contact support@khoral.com, by phone at (505) 837-6500 or by FAX at (505) 881-3842.

Technical information is also available from the FAQs at the KRI WWW site (www.khoral.com) and the FTP site (ftp.khoral.com), or via the USENET group or the Khoros mailing list.

For further information, please consult KRI's web site at http://www.khoral.com/, or contact us via e-mail at info@khoral.com, by phone at (505) 837-6500 or by FAX at (505) 881-3842.

Additional Support Resources

News Group and Email Lists

KRI also sponsors and manages the interactive newsgroups for the collaboration of Advanced Khoros users. There are two ways to connect with other Khoros users: the Khoros mailing list and the Khoros USENET group. All messages to the Khoros mailing list are cross posted to the Khoros USENET group and viceversa. That way you only need to participate on either the mailing list or the USENET group.

There are 2 versions of the Khoros mailing list that you can subscribe to. They both contain the same postings. The regular list will mail you each time a message is posted. The Digestified list will mail you a single email message once a day with a digest of messages received over the previous 24 hours. To be added to either list, email info-request@khoral.com with the body of the letter containing only the word help. A set of instructions will be emailed to you on how to use the Majordomo commands at our site. To participate on the Khoros USENET group, subscribe to comp.soft-sys.khoros.

Reporting Bugs

Use the kbugreport program, or send email to khoros-bugs@khoral.com. Please provide as many details as possible, especially which computer, operating system, window system , window manger, and compilers you are using, as well as their versions. Additionally, you must send the precise sequence of steps that will reproduce the bug, in order for KRI to be able to evaluate and resolve the bug.

Khoral Research, Inc. Educational Services

Training in Digital Image Processing or Software Development using Advanced Khoros, and other classes on domain-specific areas and general programming are available at our Albuquerque training facility or off-site at your location.

Training Course Information

Information concerning training which includes course descriptions, course dates, registration forms, pricing information, and hotel and travel information can be obtained from several sources:

  1. A plain-text training brochure is available via email by mailing:
    ktraining@khoral.com
  2. Training information is available via the World Wide Web (WWW), from URL:
    http://www.khoral.com/
  3. Training information is available via fax from
    (505)881-3842.
  4. A fold out brochure can be obtained via mail or phone by contacting
    KRI and providing your postal mailing address.

    Khoral Research, Inc.
    6001 Indian School Rd. N.E.
    Suite 200
    Albuquerque, NM 87110-4139, USA

    EMAIL: ktraining@khoral.com
    URL: http://www.khoral.com/
    FTP: ftp.khoral.com

    PHONE: (505)837-6500
    FAX: (505)881-3842

Contacting KRI

Contact Data

Khoral Research, Inc.
6001 Indian School Rd. N.E.
Suite 200
Albuquerque, NM 87110-4139, USA

EMAIL: info@khoral.com
URL: http://www.khoral.com/
FTP: ftp.khoral.com

PHONE: (505)837-6500
FAX: (505)881-3842

Special-Purpose Email Addresses

To get automated general information: info-request@khoral.com
To retrieve information about training: ktraining@khoral.com
To contact us for specific information: info@khoral.com
To communicate with technical support: support@khoral.com
To post a question to our newsgroup: khoros@khoral.com
To report bugs in Khoros software: khoros-bugs@khoral.com


Copyright Khoral Research, Inc. 1997; All Rights Reserved