SourceJammer Client FAQ
[ FAQ Home] [ Doc Home ]
What are the requirements for running the SourceJammer client?
As of SourceJammer 2.1 . . .
- 128 MB ram (required by Java Swing for the GUI)
- Java Runtime Environment 1.4.1 or later. (http://java.sun.com)
[ Top ]
How do I connect the SourceJammer client GUI to a server?
First, you need to make sure you have a SourceJammer server up and running that you can connect to. For questions about getting the server up and running, please refer to the server FAQs.
When you first start the SourceJammer client GUI, a dialog called "Connections" will pop up. This dialog displays a list of SourceJammer archives that your client knows how to connect to. Before your client can know how to connect to an archive, you have to give it the connection information.
To set up the connection information for an archive, click the New button in the Connections dialog.
After you click the new button, a 2nd dialog called "Connection Info" pops up. This dialog has three text fields.
- In the first field ("Local alias for this connection"), you can enter any name you want. This is the name that will appear on the list in the "Connections" dialog.
- In the 2nd field ("URL for the SourceJammer server"), enter the URL for the SourceJammer server you want to connect to. This will most likely be something like http://<someURL>/sourcejammer/servlet/rpcrouter.
- In the 3rd field ("Archive name on the server") enter the name of the archive you want to connect to. If you have not created any archives on your server yet, you will need to create an archive before you can connect.
When you have entered the information, click OK. Now you will see the name of the connection you created in the Connections list. Select this connection and click "Connect" to connect to it.
[ Top ]
What URI does SourceJammer's SOAP server listen on?
The default URI for SOAP is:
For example: http://localhost:8080/sourcejammer/servlet/rpcrouter
If you know how to configure Tomcat, you can change this.
[ Top ]
What does SourceJammer mean by "Check In", "Check Out", and "Get"?
|Check Out –
When a user checks out a file, that user has exclusive access to that file until he or she checks it in. In a nutshell, here's what happens when you do a checkout. The Server first records that you have checked the file out and blocks any other users from checking out that file. Then the server sends the file to your client which then saves the file to an appropriate place on your file system. If a file with the same name already exists on your system, SourceJammer overwrites the previous version with the latest version from the archive. The client also makes sure that the file is not read-only when the check out is complete.
|Check In –
A user checks a file in to the archive when some required changes to the file have been completed. When the file is checked in, other users are then allowed to check out that same file. In a nutshell, here's what happens when a file is checked in: the client uploads the file to the server. The server stores the checked in file as a new version (keeping the previous version that was checked out in its version history for that file). Then the file is marked as no longer being checked out, so other users can check it out. Then a confirmation message is sent back to the client. When this message is received, the client sets the file on your local file system to be read-only as a reminder to you that you do not have that file checked out.
The get command retrieves a file (potentially, any version of that file) or a number of files from the server without checking those files out.
[ Top ]
How do I create a new archive on my SourceJammer server?
Before you can store or retrieve any files on a SourceJammer server, you must create an archvie. Using the GUI, you can create an archive by selecting Archive | Make Archive. You must be logged in as an admin user to create an archive.
There are two "modes" for creating archives: connected and disconnected. If you have already created an archive on your server, the easiest way to create a new archive is to connect to an existing one first. The system requires less information in connected mode since the system already knows your connection and login information. When you create an archive while connected, the only information you need to enter is the name for the new archive.
But it is also possible to create an archive while disconnected. In fact, after you install the SourceJammer server for the first time, you must create your first archive while disconnected since there is no archive to connect to.
To create an archive while disconnected, select Archive | Make Archive. In the Make New Archive dialog, enter a name for the new archive, the URL of your SourceJammer server (http://<some url>/sourcejammer/servlet/rpcrouter), and the login and password for an admin user.
[ Top ]
Is there an Eclipse plugin for SourceJammer?
Not yet, but one is in the works.
[ Top ]
Is there a NetBeans plugin for SourceJammer?
No. If you are interested in developing one, please let us know.
[ Top ]
Are there any Ant tasks to allow me to access my SourceJammer archives?
Yes. There are tasks to allow you to get a folder and a label, but these remain essentially undocumented. The SourceJammer ant tasks reside in the sj_ant.jar file in the bin directory in the 2.1 beta 7 client and later.
A sample build.xml file can be found here.
[ Top ]
SourceJammer does not seem to handle non-US English characters properly. Characters such as accented vowels are often corrupted both in file/folder names and when the occur in text files. Is there a way to fix this?
Yes. This is very easy to fix. Hopefully I'll provide better documentation for this feature soon.
Locate the file conf.xml on your SJ server and your SJ client. Open and edit this file. Add the following node to the XML within the root node. If the nodes already exist, modify them accordingly:
This tells SourceJammer to use the ISO-8859-1 character set. This character set should manage non-US English characters properly.
[ Top ]
When I try to run the SourceJammer GUI client, I get the following error message: Exception in thread "main" java.lang.NoSuchMethodError: javax.swing.JSplitPane: method setResizeWeight(D)V not found. How do I fix this?
This exception means that you are trying to run the SourceJammer GUI client under a version of the Java Runtime Environment (JRE) previous to 1.3. The SourceJammer client requires JRE version 1.4 or later. You can download the latest version of the JRE from Sun Microsystems at java.sun.com.
[ Top ]
I am trying to run the SourceJammer client on a Solaris 2.x machine but every time I try to start it I get the message "java.lang.UnsatisfiedLinkError: Can't load library:". How do I fix this.
This is either a bug or a shortcoming (depending on how you look at it) with Java 1.4.1. Java (JRE and J2SDK) will not run under Solaris 2.6 (nor under 2.7 or 2.8, it would seem). For more details on this, try these links:
We generally recommend that SJ be run using the JRE or J2SDK 1.4.1_x, but plenty of people run it using 1.4.0_x, so this is your work-around.
[ Top ]
My default directories really seem to be messed up. The SourceJammer GUI seems to think that two separate projects are the same. It wants to put them in the same default directory and I can't seem to make it stop. What should I do?
Yes, this has been known to happen. If your default directories really seem to be messed up beyond repair, your best bet is to start over with a clean slate. To do this you just need to delete the file that holds your default directory information.
The file you want to delete will be in the conf directory for you client installation. Most likely, this is c:\SourceJammer\conf, c:\SourceJammer\client\conf, /usr/local/sourcejammer/conf, or /usr/local/sourcejammer/client/conf.
The file you want to delete will have a name matching the pattern [archive].[user], where [archive] is the name of the archive whose default directories you want to reset and [user] is the user name you use to connect to that archive. So if your archive is called MyArchive and your user name is joe, then the file you need to delete will be called MyArchive.joe.
After you delete this file you will need to restart the client. At that point, you will have set all of your default directories for this archive again.
[ Top ]
I'm trying to connect to my newly installed SourceJammer server. I'm using the default admin/admin user name and password, but SourceJammer says the user does not exist. What can I do?
This is an odd error that has been reported from time to time. We are not completely sure what causes this to happen. The proximate cause is that the SJ server can't find the users.xml file (in the filesys directory). But generally this should not happen.
Stopping and re-starting the SourceJammer server seems to fix the problem. If you're unfamiliar with Tomcat and have recently installed it on your computer, check and make sure that Tomcat is not running as a service. If it is, just make sure you stop and start the service to stop and start SourceJammer.
[ Top ]