Visimage3Install

From Vital Soft Wiki
Revision as of 22:27, 9 November 2014 by >Johno (Update Macro Definition File)
Jump to: navigation, search

Visimage3 Installation Summary

To prepare to install Visimage3 you must first prepare for the installation by installing a new version of VsrvTcp and updating the macro definition file on the host. Also, any Visimage users that have not already installed version 2.6 should do so as Visimage3 will only open existing CTW files that have been saved in version 2.6.

Install VsrvTcp Version 4.9.1.4

VsrvTcp version 4.9.1.4 supports encrypted passwords and is required for Visimage3. This version is not compatible with Visimage 2.6 (unless the Visimage 2.6 update which includes encrypted password support, and VisiPass, has been installed). If this encrypted password update has not been installed, we strongly recommend that VsrvTcp be installed on a separate port initially. Utilizing a second port will allow clients to run both Visimage 2.6 and Visimage3 concurrently.

Update Macro Definition File

Visimage3 includes new macro functionality that requires a new macro definition file. The new file format allows for additional macro attributes to be specified in the comment area. After the last character of the comment, there are two dash marks followed by the group name of the macro and the length needed for the data displayed by the macro. This is followed by two more dash marks.

{{{

   macro name = definition << Description -- GroupName Len=30-- >>

}}}

Attached is a new macrodef file that contains the syntax for grouping macro's. This will not impact current Visimage 2.6 users. The macros will still appear in the Tools -> Macros window.

Rename the current /ASKPLUS/visimage/macrodef to /ASKPLUS/visimage/macrov26. Transfer the macrodef file to the Unix box, using an ASCII transfer. Issue a chmod 644 on the macrodef file so that it is readable by everyone.

If you have custom macro's defined in the /ASKPLUS/visimage/usermdef, we suggest adding them to a Custom grouping. The groups are defined in the comment area’s of the macrodef file. The comment lines begin with << and end with >>:

macro CVT-FIRST+INIT(insert-name) = !splitname(insert-name,"FM")& <<print first name and middle initial--Name Len=30-->>

 For your custom macro, it should look like this: 

macro CU-NAME = "Vital Soft Employee's Credit Union" << The name of the CU to print on reports.--Custom Len=34-->>

You will then need to rebuild the /ASKPLUS/visimage/macro file. This is the binary file Visimage and Askplus use. To rebuild the /ASKPLUS/visimage/macro file you will need to have all Visimage users exit server.

1. Login as the askplus user. 2. cd visimage 3. Compile the macro source file by running the following script: load_macros

It might be necessary to bring the listener down to ensure that the file is not being accessed.

To kill the listener:

1. Login as root 2. Issue this command to stop the listener: /ASKPLUS/kill_vsrvtcp -stop_all

  • Note, the above command will kill both the regular listener as well as the beta listener.

Run the load_macros script again, remember to login as the askplus user and cd visimage.

To restart the listener:

1. Login as root 2. Issue this command to start the non beta listener: /ASKPLUS/vsrvtcp –n30501 -a >/dev/null 3. Issue this command to start the beta listener: /ASKPLUS/vsrvtcp_4913 -a -t –n30503 –a >/dev/null