Installing Sumac

  1. How do I install Sumac on my computer?

    1. Click here to ensure that you have the most recent version of Java installed on your computer. On the Java website, click on “Do I have Java?” under the big red button. If you do not have the most recent version, install it. It is necessary to run Sumac.
    2. Click here to Install Sumac on your computer. In most browsers, this button automatically starts the installation process and puts a Sumac icon on your desktop. If this doesn’t happen, but your browser downloaded a “jnlp” file, open the “jnlp” file with Java Web Start.

    As with any downloaded software, when Sumac starts to run, your operating system will perform security checks. If you can tell your computer to trust content from Sumac.com, do so. If not, you may be asked to confirm software from different sources: Softwood Technology, Sun Microsystems, and Legion of the Bouncy Castle. Confirm that you want to run the software, trusting these sources.

  2. How do I re-install Sumac on my computer?

  3. If you double click the Sumac icon and your system says it is unable to run the specified program, your system may have removed or damaged the cache file holding Sumac. So you need to re-install it.

    Step 1: Remove the Sumac program from your computer

    Note that this step removes only the software, it does not affect your Sumac database.

    First, make sure that Sumac is not running.

    On a Windows computer, open the Java control panel, and click the View button. It shows a list of Java applications installed on your computer. Click to select Sumac, then click the X icon to delete it.

    On a Macintosh running the current MacOS, open System Preferences then open the Java control panel, and click the View button; click to select Sumac, then click the X icon to delete it. On somewhat older MacOS, open the Java Preferences application, click the Network tab, then click View Cache Files, click to select Sumac, then click the X icon to delete it. On an older Macintosh use the Finder run the Java Web Start application, from the menu at the top of the window choose Applications, click to select Sumac, then click the X icon to remove Sumac.

    If there is a Sumac icon on your desktop, drag it to the trash.

    Step 2: Re-install Sumac

    Go to Sumac.com, click Client Support Services in the footer of the page, then click Install Sumac to get the current production release.

    As with any downloaded software, when Sumac starts to run, your operating system will perform security checks. If you can tell your computer to trust content from Sumac.com, do so. If not, you may be asked to confirm software from different sources: Softwood Technology, Sun Microsystems, and Legion of the Bouncy Castle. Confirm that you want to run the software, trusting these sources.

  4. How do I install Sumac on a new computer to use an existing database?

  5. When you first run Sumac on a new computer, it will ask for the name of the server and the name of the database. If you don’t know these, here is how to get them:

    1. Run Sumac on another computer (any user computer other than the database server).
    2. Click Utilities/Sumac Administration/Show Configuration.
    3. The window that appears tells you the server and database name.
    4. Now use the new computer. Use your browser to go to Sumac.com, click Client Area at the top of the page, then click Install Sumac to get the current production release. Follow the instructions for installing Sumac.
  6. How do I install new releases of Sumac?

  7. Whenever you run Sumac, it automatically checks to see if there is a new release available. If there is, you are asked if you want to install the upgrade. Click OK and Sumac installs and runs the new version in a few seconds. Occasionally, if a new release of Sumac needs an upgraded database structure, Sumac will ask if you want the database updated. Click to indicate that you do want the database updated. Wait until the progress messages indicate the update is complete (usually a few seconds). Then log on as usual.

  8. What is Java?

  9. Java is a programming language that comes with a lot of support that enables Java programs to run on different computers, to communicate over the Internet, and to be securely installed and updated. Sumac is written entirely in Java. In order to support the running of programs written in Java, your operating system (Windows, MacOS, Linux) requires a Java Runtime Environment (JRE). You install the JRE independently of installing Sumac.

  10. How do I install the most recent Java on my computer?

  11. Click here to download Java. You can also click on “Do I have Java?” under the big red button to see if Java is already installed and check whether you have the most recent version.

  12. How can I tell if my Macintosh is 32-bit or 64-bit?

  13. Click here and follow the instructions on Apple’s web site.

  14. What is the databases.txt file?

  15. The first time you run Sumac on a computer it creates a file named “databases.txt” and puts it into a SumacSettings folder in your user directory. The format of this file is as follows:

    There is one line in the file for each database that you may want Sumac to connect to. Each line contains two parts separated by a space. The first part defines the database server and name, the second defines the driver that Sumac should use to connect to the database. A typical entry might be something like this:

    jdbc:mysql://MainServer/CharityDB com.mysql.jdbc.Driver

    The first part says to connect to a server named “MainServer” and a database named “CharityDB”. The second part tells Sumac which software to use to connect to the database (a piece of software named com.mysql.jdbc.Driver).

  16. How do I prepare for remote installation?

  17. If you licensed Sumac Gold, or if you separately purchased installation services, we install and configure your database. You need to do a bit of preparation work in advance: downloading some files so that the remote installation process will proceed quickly and smoothly.

    On Each User Computer

    Step 1: Get Java

    Make sure that each computer that will be running Sumac has the most recent version of the Java run-time environment (JRE).

    The Frequently Asked Questions in the Support section of sumac.com tell you how to do this. Above you will find FAQs titled How do I install the most recent Java on my Windows/Macintosh/Linux computer? Choose the one that applies to your computer, then follow the instructions to install the current version of Java.

    Step 2: Install Sumac

    Click here to install Sumac on each user computer. The first time Sumac runs on each computer, it asks which database to connect to. Just click Cancel. The database does not yet exist, so you should not specify these settings yet. Now that you have done all this preparation work on each user computer, once the server is set up, it will take just a few seconds to get Sumac running.

    On The Server

    Use your browser to download some software to be installed on your server. DO NOT install it: just download it so it is ready for Sumac personnel to install and configure.

    You should get a directory listing that shows (amongst other things): Server Software. Click to open Server Software. Inside Server Software, click to open the folder that applies to your server: Windows or Macintosh.

    If Windows, then download all the files in this directory.

    If Macintosh, then download the files appropriate to your version of the operating system and processor. Also, download the files in the folder “All Macintosh”.