Introduction

Vitalware is designed to allow multiple installations to coexist. Each installation is placed in a directory within the user vw's home directory. The name of this directory typically reflects the client system being installed. The client name may be any name, thus allowing test and production environments to be set up for the same system. In the notes below client refers to the name of the client directory for the current installation.

The term ~vw is used to refer to the user vw's home directory. This is typically /home/vw.

Requirements

• Vitalware Server version 1.4.01 or greater

Installation Notes (Vitalware Server - vw)

1. Log in as vw.
2. Enter mkdir  -p  client/install
3. Enter cd  client/install
4. Obtain the appropriate Vitalware version via the KE Vitalware Server hyperlink above. Save the release in ~vw/client/install calling it vw.sh.
5. Enter sh  vw.sh. The Vitalware release will be extracted.
6. Enter unset VWGROUP
7. Enter .  ./.profile
8. Enter bin/vwinstall  client. The Vitalware installation script will commence.
9. Enter cd  ~vw/client
10. Enter cp  .profile.parent  ../.profile
11. Enter cd  ..
12. Enter vi  .profile-local
13. Add a single line client client to the file and save it. If a default client is already registered then you may leave the existing value.
14. Enter .  ./.profile
15. Enter client  client
16. Enter cd  etc
17. View the config.sample file.
    If  you wish to alter some of these settings to suit the client then:
    Enter cp  config.sample  config
    Enter vi  config
    edit as appropriate, then save the file.
18. Enter vi  config
19. Enter cd  ~vw/client
20. Enter texforms  eregistry
21. Find the registry entry for ServerPath (in Summary Data) and modify the value to be ~vw/client.
    Save the entry and exit.
22. Enter vwbldlinks
23. Enter vwlutsrebuild  -m.
24. Enter \rm  -fr  install
25. Enter exit to close the command shell.
26. Log out.

Installation Notes (Vitalware Server - root)

1. Log in as root. Note in all examples below ~vw must be expanded to vw's home directory.
2. Enter vi  /etc/services
3. Add six new services to the bottom of the file.

   vw	20000/tcp
   vwtrain	20001/tcp
   vwtest	20002/tcp
   vwweb	30000/tcp
   vwwebtrain	30001/tcp
   vwwebtest	30002/tcp

4. You should also add client specific services.
   To determine the port and webport required please view the Vitalware Ports document.
   
   

   vwclient	port/tcp	(replace port with port number)
   vwwebclient	webport/tcp	(replace webport with port number)

 



5. Save the file.
6. Enter vi  /etc/inetd.conf
7. Add the following line to the end of the file:
   
   vwclient stream tcp nowait root ~vw/client/bin/vwrun vwrun texserver -avw -i -L
   
   If you also want the vw service to connect to your vwclient then add also add the line:
   
   vw stream tcp nowait root ~vw/client/bin/vwrun vwrun texserver -avw -i -L
   
   
8. Save the file.
9. Enter vi  /etc/rc
10. Add the following lines to the end of the file:
    
    #
    # KE Vitalware startup
    #
    ~vw/client/bin/vwboot
    
11. Save the file.
12. You will need to restart inetd for the changes to take effect.
    Locate the process id number pid for the inetd process and then
    Enter kill -HUP pid.
13. Enter ~vw/client/bin/vwboot