How it Works

Running the CogBox

Once your build is successful, all you have to do is:

% ./build.sh run
    

% ./cygwin-build.sh run
    

Getting Help

The CogBox Main Window

	Load Credential	Screenshot 1 Screenshot 2	Loads up a Globus credential either locally or via MyProxy. If you create a proxy from a local credential then a proxy goes into the default proxy location. If you get a proxy from a MyProxy server the proxy only exists internally to the Cogbox.
	Open Local File View	Screenshot	Opens up a local filesystem view.
	Open Secure Connection	Screenshot 1 Screenshot 2	Attempts to establish a secure connection to the specified server. See the installation instructions for information regarding your cogbox.properties file.
	Open Insecure Connection	Screenshot 1 Screenshot 2	Attempts to establish a connection to the specified server via normal FTP. Enter the desired system name or ip address, and your username and password on that system in the dialog box - note this passes the username and password you enter to the specified server in the clear, hence "insecure".
	Open Anonymous Connection	Screenshot 1 Screenshot 2	Opens up an anonymous ftp connection to the desired machine. All you have to enter in the dialog in this case is the machine name to which you would like to connect.
	Open RSL DropArea	Screenshot 1 Screenshot 2	Opens a window to a server onto which you can drop RSL files from either your local filesystem or the Playpen.
	Open Playpen	Screenshot	Opens the "Playpen", the area in which you store your RSL files for instantiation in DropAreas.
	Quit		Closes all connections, closes all windows, ends CogBox.

Server Windows 

	Refresh View	Refreshes the current directory listing.
	New Directory	Makes a new directory in the current working directory.
	Delete	Deletes selected files (A warning dialog will pop up).
	Transfer Out	If you can't find the window you want to move files to, or Drag&Drop isn't working properly, you can select a list of files from the current working directory and then hit the "Transfer Out" button. A list of currently open server windows will pop up (including the Playpen, if it's open), and you can choose the server to which you want to transfer the selected files.
	Disconnect	Closes this connection, closes this window.

• Double clicking on any directory will cd into that directory.
• Once you have a few windows up, you may drag single files or multiple selections of files from any window to any window.
• You may select a number of files and delete them all at once.
• You may not delete a non-empty directory.

The Playpen 

	Edit RSL	Allows you to view/edit an RSL file in the playpen. There is a radio button which when activated causes the job being edited to throw its output up in a local window. The selected value is remembered from session to session, so setting it once will make all jobs started with that RSL throw up local output windows until you unset it. The Save button will attempt to validate your RSL string before allowing you to save the string to a file. The Revert button restores the saved version of the file in case you want to start over with your edit. NOTE : I add something to the RSL file in order to achieve local output, so if you have Local Output selected for a particular RSL file that RSL file becomes unfit for use elsewhere, although fixing it is beneath trivial. Examining the file in the playpen directory will prove it.
	Transfer Out	Move an RSL file to some open Server Window or DropArea. If you select a Server Window the file is copied to that server. If you select a DropArea the RSL is instantiated on that server.
	Disconnect	Closes the Playpen.

DropAreas 

	STATUS_PENDING
	STATUS_ACTIVE
	STATUS_DONE
	STATUS_FAILED
	STATUS_SUSPENDED

The MDS Search Window 

• Through the cogbox.properties file : You can specifiy new variables in the properties file to use one search as your default search.
  • mdshost : The host of the service, required
  • mdsport : The port of the service, defaults to 389.
  • mdssearch : An LDAP search string, like "&(objectclass=ExtremeSoftware)(name=GSIWUFTPD)", required.
  • mdsattrib : The attribute you want returned from your search, not required, but useful, and your search might not return anything without it.
• Through the MDS Search Input Window : if you don't have all of the required fields set in your properties file a window will open when you press the MDS SEARCH button to prompt you for the information.

	Enter Search Attributes	Screenshot	Allows you to specify new search attributes, including host, port, search string, and attribute to return. If you have values in your cogbox.properties file these values will be filled in the boxes for you so you can edit them, otherwise they will be blank. Once you have entered in a search, the last values you used will be the values that are presented in the dialogue box for you. When you close the MDS search window, these values are reset to their startup values.
	Close MDS Window		Closes the MDS Search Window.

1. Open a DropArea. If your search was for gatekeepers or returned machine names or IP addresses, you can open a window which represents a DropArea to that resource. NOTE: If your search didn't return information regarding gatekeepers then opening a DropArea window to a member of the list won't be very useful.
2. Open a secure ftp connection. If your search returns hostname or hostname:port you can attempt to open a secure ftp connection to that resource with your currently loaded credentials. Attempting to open secure connections to nonsensical search values results in peculiar behavior (on part of the cogbox).
3. Open an anonymous connection. If your search returns hostname or hostname:port you can open an anonymous ftp connection to that resource.