Unix Reconfiguration and Startup
Before you can start VAST Platform you may need to configure your installation.
Each user must specify a working directory to hold their working images when configuring their installation. The tool used is vasetup_1002x86 (vasetup_1002x64 for 64-bit).Running the tool from the command line launches Environments. See VAST developer environment for more information.
The default configuration is for standalone with File I/O (you are NOT prompted to choose a different option during the installation).
VAST Client
The client is always installed as a standalone installation.
Team Installation
By default, the ServerAddress is the empty – indicating File I/O. This will only work if you are using a Client that is installed on the same computer as the Manager.
If you want to change your network configuration, the Smalltalk image start-up configuration file abt.ini will need to be modified. Specifically, you will need to verify that the [EmLibraryInterface] parameters, ServerAddress and DefaultName match your network configuration.
The system administrator of the server where the Manager was installed should provide you with these EmLibraryInterface parameters
The file abt.ini is located in the <varoot>/newimage. directory.
Standalone Installation
If you are working independently from other Smalltalk developers, you may want to configure your installation for standalone use. Under this configuration, both Client and Manager must be on the same machine, and only one development image can be connected to the library at any time.
VAST Manager
The VAST Manager component uses a daemon to manage concurrent access to the library and import files. This program is named EMSRV.
To start the EMSRV process, do the following:
You do not have to be root to run emsrv. You do, however, need to have permission to create and update files in the emsrv logging directory as well as permission to modify the mgr1002.dat file itself. One approach to doing this is to explicitly specify a logging directory in which your user id is allowed to create and modify files.
Here is an example of starting emsrv such that client requests are logged in /var/emsrv-log. Also notice that we have directed stdout to /tmp/emsrv-log/emsrv.out (please note that /tmp/emsrv-log MUST exist before you start emsrv).
<varoot>/bin/emsrv -lf/tmp/emsrv-log>/tmp/emsrv-log/emsrv.out
For more options on starting EMSRV, type emsrv -h at a command prompt. You can find complete instructions for configuring and using EMSRV at "EMSRV for Windows".
Before you shut down your system or uninstall VAST Platform, you should stop the EMSRV process by issuing the command:
/usr/local/VASTPlatform/10.0.2x86/bin/emadmin stop.
/usr/local/VASTPlatform/10.0.2x64/bin/emadmin stop.
VAST developer environment
Each VAST developer requires certain files in their own working directory. The Environments tool provides a GUI for creating and managing your development environment.
VAST Platform installs a setup script in the <varoot>/bin directory. The setup script is named vasetup_100x86 (vasetup_100x64 for 64-bit). A symbolic link is created in /usr/bin so you can simply execute vasetup_1002x86 (vasetup_1002x64 for 64-bit) to launch Environments.
To launch Environments, open a terminal, then type
Environments copies the master abt.ini file to the working directory you specify. If the system administrator makes any additional changes to the master abt.ini file, the copy of abt.ini that is in your working directory will not match the master abt.ini in <varoot>/newimage. If you have not made any changes to your personal copy of abt.ini, then you can just copy the new master version from <varoot>/newimage into your image directory. Otherwise you will need to manually edit your personal copy of abt.ini to pick up any important new information from the master version of abt.ini.
More information on how to use Environments can be found at “Launching VAST with Environments”.
Settings for developer's .Xdefaults configuration file
You can customize some of the default look and feel of your VAST development environment. This can be accomplished by placing an ENVY application defaults file into your home directory. A sample ENVY application defaults file can be found in the directory <varoot>/app-defaults. Copy this file to your home directory and then make changes to suit your tastes.
For example, changing the line:
*XmList*Background: BlanchedAlmond
*XmList*Background: Sky Blue
will cause lists to have a "Sky Blue" background the next time you start a development image.
Additional kinds of customization are possible, including the cutting and pasting of the ENVY file contents into your .Xdefaults file. You should consult your X documentation for details.
X-Windows directory structure
On Linux, the X-Windows directory structure may be extended during the product install process. The VAST X-lib support expects to find its files in the /usr/X11R6/lib/X11 directory structure. However, most newer Linux distributions place their X-lib files under /usr/share/X11. The installer will create the needed directories and make the appropriate symbolic links between the 2 directory trees.
Linux - UTF-8 default locale
This section applies only to some Linux systems.
On Linux, the default locale may be UTF-8 which is not currently supported by VAST Platform. If this is the default locale, you will experience problems displaying and entering some characters specific to some (European) languages. The particular characters you will have problems with are characters with keysym (ASCII) values over 127, such as the umlauted vowels in German and the copyright (©) character.
When VAST Platform detects that the locale is an unsupported one, it will log the situation to the console. VAST Platform will use the C locale in this case.
On some versions of Linux we have found that, while the default locale may not be supported by VAST Platform, several supported locales are shipped with the operating system. On other versions, no suitable locale exists. Both situations are covered below.
In order to get characters in the upper range of the ASCII character set to display correctly, you must change the locale as outlined below.
1. Determine whether or not a suitable iso8859-1 or iso8859-15 locale exists (e.g. en_US.iso88591 or de_DE.iso885915). The command 'locale -a' will list available locales. Locales may also be in a compressed-format file named locale-archive. The command 'localedef --list-archive' will list locales in the archive file. If a suitable locale exists, skip to step 3.
2. If a suitable locale does not exist, one must be generated. There are two commands to generate a locale: locale-gen and localedef. Locale-gen is not available on all platforms; it is available on Ubuntu. Refer to the man pages for information on using the locale-gen and localedef commands. Follow the instructions to generate your locale.
It might be as simple as uncommenting a line, but refer to the documentation for your Linux distribution for details.
3. Finally, the environment for the terminal in which you launch VAST Platform needs to be updated. Specifically, LANG environment variable must be set to the locale you chose or created (e.g., export LANG=en_US.iso885915).
As an alternative to always having to manually export in every terminal, you can either modify abt.sh directly to add the export or use UNIX aliases in the rc file for the terminal’s shell.
e.g. alias vasetup_91x64='export LANG=.... ; vasetup_91x64'
At this point your system should be properly configured to run VAST Platform and have characters with keysym values over 127 such as umlauts and the copyright symbol display properly when typing in text widgets. The console log should no longer contain warnings about the locale.
Last modified date: 02/19/2021