VisualAgeRepositoryFileSystemInstallHowTo

VisualAgeRepositoryFileSystem

Contents 1. Download the StarlaSoft? Pure Java SMB server 1. Install the SMB server into VisualAge 1. Test you can share and connect to a normal directory 1. Download the solution 1. Install all the projects from the solution. 1. Run all the RepositoryTree? unit tests. 1. Run all the RepositoryTree? functional tests. 1. Configure the SMB server with the RepositoryTree? Driver 1. Trouble shooting

Make sure you have access to two separate windows machines on the same IP subnet. This is a limitation of windows. The NetBIOS? client and server seem to be the same service. Since you have to turn off the file sharing over TCP/IP to run the Java SMB server, this also stops you from browsing SMB servers (and therefore browsing the VisualAgeRepositoryFileSystem on your machine.)

1. Server:-

• • This machine will be serving the files from inside VisualAge
• 1. It needs VisualAge installed (only tested with 3.5)
• 1. It needs NetBIOS? over TCP/IP turned off as per the instructions in the SMB server distribution.

1. Client

Both machines should be in the same WORGROUP, I've had problems running this across NT domains.

It won't be included in the solution as it would not be legal to do so.

1. Import all the classes into a new project in VisualAge. 1. Read the readme file that comes with the Starlasoft distribution. I can't stress this too much. If you don't follow what it says at the bottom of the readme you won't get this working. 1. Make a test share by editing the server.cfg file in the JLan Server project_resources.

Server Machine 1. Run the com.starla.app.JLANServer from within VisualAge. Pass it the name of the config file as a parameter.

Client Machine 1. Right click the network places icon on your desk top. 1. Select the map network drive option 1. Enter the share name
<server>\<share>

Go no further until you can get this working.

Once this is working you should remove it, as it provides unauthenticated read/write access to the directory that has been shared

Get the https://xpdeveloper.com/~byeo/downloads/filesystem.dat.zip

The solution is a configuration map holding the right editions of the projects need to run VisualAgeRepositoryFileSystem.

• VAJCVS project
• • Will have errors, but the only Class we need is the SourceExporter?
  • see VajCvs

• JLan Drivers project
• • Contains the driver that exposes the VisualAgeRepository? as a SMB Share. This driver is loaded by name. The name is set in the server.cfg file of this project.
  • Contains a patched version of the com.starla.app.JLANServer class that doesn't try to grab the keyboard for input (thereby raising the focus of the console window).

• RepositoryTree? project
• • Contains the guts of this middleware.

• XPDdeveloper Mock VAJ
• • Note that this has yet to be merged with the MockVAJ? on the www.mockobjects.com site.

Once the solution as been imported, you'll have to add the released editions to the workspace.

Don't worry about the com.starla.app.JLANServer replacing a class, as this is the new patched version.

Run com.xpdeveloper.visualage.tree.tests.unit.AllTests

You'll need https://xpdeveloper.com/cgi-bin/wiki.cgi?BigBenTools if you want to run the tests.

Note.

• You'll have to bring in the IBM IDE Utility Class libraries project from the repository.
• You'll have to add the \project_resources\IBM IDE Utility local implementation directory to the external classpaths of Classes you want to run.

Run com.xpdeveloper.visualage.tree.tests.functional.AllTests

Edit your working server.cfg file to include something like:-

DISKSHARE=VAJ,com.xpdeveloper.visualage.tree.server.RepositoryDiskInterfaceImpl?,C:
temp
repository

This will share the repository with the name VAJ, and a cascade directory set to C:
temp
repository

The cascade is where the driver puts files it doesn't understand, and look for files it can't find in the repository.

• The console keeps trying to grab the focus.
• • This problem is fixed in a patch included in the VisualAgeRepositoryFileSystem solution.
  • Have you got that version of the com.starla.app.JLANServer in the workspace.

• I get "Could not connect to workspace" IvjExceptions?
• • Bring in the IBM IDE Utility Class libraries project from the repository.
  • Add the \project_resources\IBM IDE Utility local implementation directory to the external classpaths of Classes you want to run.

• I can see the share names but can't connect to them
• • Are you using single character share names?
  • There seems to be a problem accessing shares with names of more than one letter.

• The starla server doesn't work at all
• • OliBye downloaded a new version on 17 June 2001 which fixed his version not working.