Smalltalk по-русски
Регистрация
Advertisement

Introduction[]

This release of Cincom Smalltalk™ contains complete versions of VisualWorks® 7.4 and ObjectStudio® 7.1, including object engines, virtual image, and add-on products. The release contains new features, as well as many fixes.

This guide provides instructions for installing from either the downloadable Cincom Smalltalk Installer, a CD, or individual files downloaded from Cincom’s FTP site. The installation of both commercial and non-commercial releases of VisualWorks 7.4 are discussed.


Installing Cincom Smalltalk[]

The Cincom Smalltalk installer is a VisualWorks application that installs VisualWorks and/or launches InstallShield to install ObjectStudio. Instructions for each process are given separately; first for VisualWorks, then for ObjectStudio.

When installing from a CD on MS-Windows, the second step in the installer presents the option of installing ObjectStudio in addition to VisualWorks. You may select either or both.

For both products the installation process consists of following the prompts offered by the installation program. The instructions given in this guide provide additional information that you might need to respond to some of the prompts.

The Installer application is developed in VisualWorks, and is available as a framework that you can use for your own application distributions. To explore the framework, load the VWInstaller parcels in the packaging/installer/ subdirectory of the base installation.

System Requirements[]

VisualWorks[]

VisualWorks 7.4 runs on workstations with the following minimum system configurations.

Disk and Memory Requirements[]

  • 32 MB of memory minimum (development environment)
  • Apx. 285 MB disk space for default installation
  • Apx. 556 MB disk space for full, single platform installation
  • Apx. 765 MB disk space for full installation with all platforms
  • CD-ROM drive (for installation)

Microsoft Windows[]

  • A PC or compatible with an Intel 386 compatible or higher processor (Pentium or higher recommended)
  • Windows 98/ME/2000/XP

Microsoft Windows CE[]

Virutal machines for Microsoft Windows CE are intended for use on CE devices as an application deployment environment. Minimum requirements are:

  • CE devices running a x86-compatible or an ARM processor.
  • Windows Pocket PC 2003 (Windows Mobile 2003)

Due to high variability in OS implementations on these devices, these requirements are necessary, but may not be sufficient. Refer to the Release Notes for additional information.

Installation is generally done by uploading software to these devices, so the CD-ROM general requirement does not apply.

HP-UX[]

  • HP 9000 Series 700 workstation
  • HP-UX Release 11.x

SUN Solaris[]

  • Sun SPARC system
  • Solaris 5.6 or better
  • For the 64-bit version of VisualWorks, a SPARC64 system with 256MB of physical memory is required, running Solaris 5.8 or greater.

SGI IRIX[]

  • An SGI IRIX 6.x machine with a MIPS processor

This VM has been tested on an entry-level SGI Indy under IRIX 6.2. Note that the threaded API for external interfaces is not supported yet, so VisualWorks effectively uses only one processor at a time.

Due to a problem in the processor hardware, VisualWorks 7.4 will crash on systems with an R4000 processor of revision 2.2 or older.

IBM AIX[]

  • AIX workstation with PowerPC processor
  • AIX release 5.x and up

Apple MacOS 9[]

  • Apple MacOS computer
  • MacOS 9.x

MacOS 8.6 works with some caveats, and is a supported platform.

Apple MacOS X[]

  • Apple MacOS computer
  • MacOS 10.x

Apple MacOS X - X11[]

  • Apple MacOS computer
  • MacOS 10.2 or higher
  • X11 libraries for MacOS X

Linux i386[]

  • A PC or compatible with an Intel 386 compatible or higher processor (Pentium or higher recommended)
  • We have tested on Linux distributions supporting:
    • glibc 2.1.3 or newer
    • XWindows (X11R6)

A kernel of level 2.2 or newer should meet these requirements.

  • For the 64-bit version of VisualWorks, an x86-64/EMT64 system (i.e., AMD x86-64 and compatibles such as Intel EMT64) with 256MB of physical memory is required, the Linux 86_64 kernel 2.4 or greater, and glibc version 2.3.2 or greater.

Some distributions (e.g., RedHat) include multiple compiles of the glibc libraries, provided in /lib, /lib/tls, and /lib/i686 or similar directories which contain libraries for different OS ABI versions. For more information, see: http://people.redhat.com/drepper/assumekernel.html. If you use such a system and experience seemingly random crashes, refer to this web page. If the command:

#> ldd /path/to/vwlinux86

indicates that libc.so.6 is found in either /lib/tls or /lib/i686, you need to define LD_ASSUME_KERNEL=2.2.5 in your environment prior to running VisualWorks. For example,

#> env LD_ASSUME_KERNEL=2.2.5 /path/to/vwlinux86 image.im

Or, set it for the shell. For C-shell:

#> setenv LD_ASSUME_KERNEL=2.2.5

and for Bourne/Korn shell:

#> LD_ASSUME_KERNEL=2.2.5; export LD_ASSUME_KERNEL

Doing this will cause the loader to use the correct libc files.

Linux PowerPC[]

  • A PowerPC-compatible processor
  • A linux distribution with a 2.4.x kernel or higher
  • XWindows (X11R6)

See the notes for Linux i386 above for additional information.

ObjectStudio[]

ObjectStudio runs on these Microsoft Windows platforms

  • Microsoft Windows 9x and higher
  • Microsoft Windows NT® 4.0 and higher

Getting Help[]

If, after reading this document, you find that you need additional help, commercial licensees can contact Cincom Technical Support. Cincom provides all customers with help on product installation. For other problems there are several service plans available. For more information, send email to [1].

VisualWorks Non-commercial licensees can get help on-line from the resources listed in the Application Developer's Guide (VisualWorks).

Before contacting Technical Support, please be prepared to provide the following information:

  • The release number, which is displayed when you start VisualWorks.
  • Any modifications (patch files, auxiliary code, or examples) distributed by Cincom that you have imported into the image.
  • The complete error message and stack trace, if an error notifier is the symptom of the problem. To do so, use Copy Stack, or select and copy the text in the error window, and paste the text into a file that you can send to Technical Support.
  • The hardware platform, operating system, and other system information you are using.

You can contact Technical Support using any of the following methods:

E-mail Send questions about VisualWorks to: [2].
Web Visit: http://supportweb.cincom.com and choose the link to Support.
Telephone Within North America, call Cincom Technical Support at (800) 727-3525.

Outside North America, contact the local authorized reseller of Cincom products to find out the telephone and fax numbers for technical support.

Installing VisualWorks[]

The procedures described in this section install VisualWorks 7.4.

The VisualWorks Installer application is the recommended option for most developers. This may be downloaded directly from Cincom’s web site or run from the Cincom Smalltalk CD-ROM (commercial or non-commercial edition).

To begin, see Running the VisualWorks Installer (below).

Experienced VisualWorks users may prefer simply to copy (drag-and-drop) the compressed components from the CD or Cincom’s web site to a target directory (this is for non-commercial installations only). Configuration details, such as setting paths and file associations, must be performed manually, but these steps are not described here.

For details, see Installing VisualWorks from Downloaded Files (below).

Running the VisualWorks Installer[]

The VisualWorks Installer sets up the required directory structure on a workstation disk drive and copies the selected components into that structure. The Installer can copy the VisualWorks components from CD or directly from Cincom’s web site. Instructions are displayed by the installer as responses are needed. On UNIX and Linux systems, the Installer explains how to set up your UNIX environment variables.

A non-commercial CD can be burned from a CD image file (ISO), which is also downloadable from the website.

Installing via the Internet[]

The VisualWorks Installer is available for free download from the Cincom Smalltalk web site:

http://smalltalk.cincom.com/downloads/

To install VisualWorks from the web site, register as a developer and download the executable file that is appropriate for your platform. Executables for most supported platforms are available (users wishing to install on other platforms must use the Cincom Smalltalk CD or download individual files as described in subsequent sections of this guide).

To continue installing via the Internet, run the Installer application and follow the steps described in Choosing a Typical Installation below.

Installing from the Cincom Smalltalk CD-ROM[]

On most platforms, the Installer starts automatically when you insert the Cincom Smalltalk CD. If it does not start automatically, start it using the method appropriate to your platform, located in the CD’s root directory:

Windows: Double-click on the installWin.bat command script file.

UNIX/Linux: Execute the installer shell script installUnix.

MacOS9.x: Launch the InstallMac AppleScript. Alternately, view the CD's contents as a list, expand the vw7.4:bin:powermac folder and the image folder. Drag install.im onto the visual object engine.

MacOS X: Double-click on the installMacOSX.command script file. Alternately, view the CD's contents as a list, expand the /vw7.4/bin/macx folder and the image folder. Drag install.im from the image folder onto the visual.app object engine.

Choosing a Typical Installation[]

Upon startup, the Installer provides the option to perform a typical or custom installation, or to uninstall a previous version of VisualWorks.

VWInstall-03


1. For new developers, a Typical Install is recommended. Select this option and proceed by clicking on Next.

If you wish to customize the installation (i.e., choose a different installation directory, include or omit specific VisualWorks components), follow the steps described in Choosing a Custom Installation below.

2. The Installer retrieves the most recent versions of VisualWorks that are available on the Cincom web site.

While contacting the web site for version information, this step also checks for an update to the Installer itself. If one is available, you may download and install it immediately by clicking on ApplyUpdates.

If the Installer finds a previous “typical” installation, it assumes you wish to make changes or add components, as in a “custom” install.

For details, see Choosing a Custom Installation below.

3. Review the summary of installation options:

VWInstall-04


4. If the default options (product version, installation directory, components) are all suitable, click on Next to proceed.

If you wish to change or customize any of these options, click on Back, return to the first page and choose Custom Install. Then, follow the steps described in Choosing a Custom Installation.

5. For non-commercial distributions, review the license agreement. Select I Accept, and click Install.

The Installer shows progress as each component is copied to the local disk of your workstation.

After all components have been installed, the Installer indicates successful completion:

VWInstall-05


6 Click Exit to finish.

At the end of the installation process:

Platform Actions
MS-Windows The system registry is updated automatically.
UNIX An informational screen is displayed with instructions for setting your UNIX system variables (this information is also saved in a text file called userActions.txt, located in the install directory).
MacOS 9.x A special environment variable file is created in the Preferences:VisualWorks Prefs folder of the current operating system installation.

This completes the “typical” installation.

Choosing a Custom Installation[]

A custom installation allows you to choose the version of VisualWorks to install (not merely the most recent), the target directory, and the specific components you wish to install.

Selecting this option enables you to choose among the most recent versions of VisualWorks that are available on the Cincom web site.

1. To begin, select CustomInstall, and proceed by clicking on Next.

2. On the following page, you may choose among the latest available versions on Cincom’s web site by clicking on CheckServer. If you are installing from a CD, you may skip this step by clicking on Next.

VWInstall-06


While contacting the web site for version information, this step also checks for an update to the Installer itself. If one is available, you may download and install it immediately by clicking on Apply Updates.

Once the Installer has finished scanning the web site, click on Next.

3. Select a product and version to install.

VWInstall-07


All available products and versions are shown in the drop-down list. Selecting one item causes the Installer to fetch additional details (these may take a few seconds to display).

When installing from a CD on MS-Windows, you may select either or both ObjectStudio or VisualWorks. Selecting ObjectStudio will launch its setup.exe install script once VisualWorks has been installed.

Optionally, you may specify the full path to an install.map file by clicking on the Other... button. Generally, the path should be to the root of the distribution CD (e.g., D:\install.map), but you may also specify an URI (e.g., ftp://...).

4. Choose the version you wish to install, and click Next.

5. Specify the installation directory.

VWInstall-08


The directory shown as a default by the Installer is typical for the platform you are installing.

If the default does not suit your needs, edit it to specify the new install directory (e.g., c:\Program Files\vw7.4 on MS-Windows systems, or /usr/local/vw7.4 on UNIX or Linux systems). Click on Browse... to examine the directory hierarchy.

Tip: If you have previous versions of VisualWorks installed, we recommend installing into a new directory rather than installing over a previous version. This prevents potential incompatibilities from mixed versions of component files, and allows you to run previous version(s) as well.

If the specified directory does not exist (typically the case for a new installation), it will be created for you.

6. Click Next.

7. Select the VisualWorks components you want to install.

VWInstall-09


By default, the components for a typical installation are pre-selected. To select or deselect a component, click on it in the list. Select at least the Base VisualWorks component and the VM (virtual machine) component for your platform, which are the minimum requirement for a working installation.

Brief descriptions for the components are shown in the lower half of the window when the cursor hovers over their names (refer to their documentation for fuller descriptions).

When you have made all your selections, click Next.

8. Review the summary of installation options:

VWInstall-04


If the default options (product version, installation directory, components) are all suitable, click on Next to proceed.

If you wish to change or customize any of these options, click on Back.

9. For non-commercial distributions, review the license agreement. Select I Accept, and click Install.

10. The Installer shows progress as each component is copied to the local disk of your workstation:

VWInstall-10


If you are installing over a previous installation (such as a pre-release), you will be prompted for the action to take if a file already exists. Selecting Overwrite replaces the currently installed file; Update replaces the currently installed file only if it is older than the new one; Skip keeps the original file. A checkbox allows you to specify use of the choice for all subsequent actions.

11. The Installer indicates successful completion:

VWInstall-05


12. Click Exit to finish.

At the end of the installation process:

Platform Actions
MS-Windows The system registry is updated automatically.
UNIX An informational screen is displayed with instructions for setting your UNIX system variables (this information is also saved in a text file called userActions.txt, located in the install directory).
MacOS 9.x A special environment variable file is created in the Preferences:VisualWorks Prefs folder of the current operating system installation.

This completes the installation.

Installing Additional VisualWorks Components[]

After the initial VisualWorks installation, you can use the Installer application again to install additional add-on components.

1. If you installed from the Cincom Smalltalk CD, load it in your computer’s CD-ROM drive.

2. Start the installer:

Windows: Go to Start -> Programs -> VisualWorks7.4 -> Install/Uninstall
UNIX: Execute the script vw7.4nc/Install_Uninstall
MacOS: Double-click on the installation image file vw7.4nc:image:install.im

3. Once the Welcome screen appears, select Custom Install, follow the initial steps as described in the previous section, clicking Next until you reach the Components to Install screen.

4. Select the components you wish to add, and click Next.

5. When the installation is complete, click Close to exit.

To be continued...
Advertisement