SIF Repair Tool 1.0

Date: 7-23-2013

Download: SIF Repair Tool v1 Release

Concensus Technologies SIF Repair Tool (SRT)

DISCLAIMER

THIS SOFTWARE IS PROVIDED - AS-IS. CONCENSUS TECHNOLOGIES MAKES NO OTHER EXPRESS OR IMPLIED WARRANTIES, INCLUDING BUT NOT LIMITED TO ANY WARRANTY WITH RESPECT TO THE PERFORMANCE OF THIS SOFTWARE.
CONCENSUS TECHNOLOGIES IS NOT RESPONSIBLE FOR LOSS OF DATA OR LOSS OF USE OF ANY OF YOUR COMPUTER OR NETWORK SYSTEMS RESULTING FROM USE OF THIS SOFTWARE.

IMPORTANT!
This ReadMe only details technical operation of the SRT. You MUST review the SIF Rollover process to fully understand the preparatory steps and impact of this tool.
https://concensus.jira.com/wiki/display/SIFDD/SIF+Rollover+Process+2013+v1.0

DO NOT USE THIS TOOL DURING THE SCHOOL YEAR.

Failure to do so could result in damage to your system.

Installation:

This tool requires a Java 1.6 or later runtime environment (JRE). Please ensure that one is installed and accessible from the command line.

Open a command prompt or terminal and execute the command:

java -version

You should see output similar to:

C:\>java -version
java version "1.7.0_21"
Java(TM) SE Runtime Environment (build 1.7.0_21-b11)
Java HotSpot(TM) 64-Bit Server VM (build 23.21-b01, mixed mode)

Your output may vary. If this command does not run, you will need to either install a 1.6 or later JRE or add the java bin location to your path.

Java can be found at http://www.oracle.com/technetwork/java/javase/downloads/index.html or java.oracle.com.

Extract the SRT zip file into a folder on a workstation.

To run the SRT from the command line, go to the extraction folder and
type the following:

java -jar "SIF_Repair_Tool.jar"

Or, if on Windows and java is integrated, you may be able to double click it to run it.

Instructions:

On the Connection tab, fill in the parameter fields as detailed below. It is highly recommended that the tool use the same eDirectory server as the SIF driver.

Provider URL: Enter the LDAP URL of the IDM server; eg: ldaps://mysifserver.customer.edu
- If LDAP is not on the standard ports, specify the port thus: ldaps://server.edu:port

Security Principal: The Administrator DN in LDAP format; eg: cn=admin,ou=sa,o=system

Security Credentials: The above admin account password

Driver DN: The LDAP DN of the SIF driver; eg: cn=Concensus SIF 4,cn=Driver Set,o=system
- Note that driver sets are containers named with the CN attribute.

Section LDIF Filename, School LDIF Filename, and Student Attributes LDIF Filename: Accept the default (which writes into the same location as the SRT executable) or choose your own file name and location.
- These are the output/log files generated by the three main processes of the SRT.

Note: The output files are always overwritten when the tool is ran.

Switch to the "Clean Up" tab to proceed.

On the "Clean Up" tab, check the "Process" box beside each task you wish to perform.

If you choose to do them one at a time, please do them in the order listed for best results.

Check the "Simulate" box to prevent the tool from directly writing updates to the LDAP server. Leave it unchecked to allow it to write to the LDAP server.

You can optionally set the number of threads with the sliders. The SRT uses threads for the LDAP update tasks. More threads will improve performance on updates, however it can overload the LDAP server.

It is recommended that a simulate run be peformed prior to a 'live' run. After the simulate run, review the output LDIF files to ensure that the operations are correct and desired.

Click "start" to perform the clean up.