Windows Reconfiguration and Startup
Environments allows you to configure and start VAST development environments based on settings in the client installation.
However, if you have moved components out of the standard locations, changed an installation from standalone to team, or started or stopped EMSRV, you may need to manually configure your installation before you can start a VAST development environment.
The VAST Client can be installed for team development or for standalone use. If you have installed as team and wish to change to standalone or vice versa, instructions on how to do this follow. This section also covers how the Client specifies the location of the library in case the library (e.g. mgr1201.dat) has moved.
Reconfiguring an Environment
The key components in determining the configuration of a development environment are the ini file and the library (dat file). You can create and organize new development environments using the Environments tool.
The same steps are required whether you wish to change the configuration for a single image/environment or for the entire client installation. See
File Locations for information about where to find the ini file with the desired scope.
Standalone Configuration
For standalone installation, both Client and Manager must reside on the same machine. Under standalone, only one development image at a time can access the library. If you are working independently from other Smalltalk developers, this may be the right configuration for you to use.
To change from a team client to a standalone client, file abt.ini will need to be modified and the library must be accessible to the client. You need to change your network configuration in the VAST image start-up configuration file abt.ini.
1. Specifically, you will need to modify the [EmLibraryInterface] parameter ServerAddress, and you may need to modify DefaultName.
•The ServerAddress must be empty.
•The DefaultName must match the location of the library on the local machine.
For example:
DefaultName= C:\ProgramData\Instantiations\VASTPlatform\Managers\mgr1201.dat
ServerAddress=
2. You must locate the library so that your account has read/write privileges.
Team Configuration
If you want to allow more than one image to connect to the library, or switch to a team environment, you will need to use EMSRV.
You need to change your network configuration in the VAST image start-up configuration file abt.ini.
1. Specifically, you will need to modify the [EmLibraryInterface] parameters ServerAddress and DefaultName to match your network configuration.
•The ServerAddress must specify the machine running EMSRV, which provides access to the Smalltalk code library. If EMSRV is running on the same machine as the client, the ServerAddress can be localhost.
•The DefaultName must match the location of the library (.dat file) on the machine identified by ServerAddress.
The system administrator for the server where the Manager is installed should provide you with these [EmLibraryInterface] parameters for a team environment.
2. If you are your own system administrator for the server where the Manager is installed, you will need to ensure the library is available via EMSRV.
The following briefly describes how to configure EMSRV, the daemon which the VAST Platform Manager component uses to manage concurrent access to library and import files.
To start the EMSRV process, you do not have to be root but you do need to have permission to create and update files in EMSRV’s logging directory as well as permission to modify the mgr1201.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 C:\vast\emsrv-log (C:\vast MUST exist before you start EMSRV).
emsrv –u myAccount –p myPassword –W C:\vast -lfC:\vast\emsrv-log
For more options on starting EMSRV, type emsrv -h at a command prompt.
Note:
Before you shut down your system or uninstall VAST Platform, you should stop the EMSRV process by issuing the command:
emadmin stop
You can find complete instructions for configuring and using EMSRV
here:
Last modified date: 04/05/2023