Re-Install the SIFTER Server Software

Before doing this, you should have already successfully installed SIFTER and loaded data into the database. At this point your goal is just to update the server software.

As earlier, a script will prompt you for the relevent information which should very familar. The Perl code is installed, but unlike before, no real testing is done. If you are not comfortable with this, you should install the demo and convince yourself the software works properly.

It's time to update the server software. As in other documentation, lines you enter are shown in red and commentary is shown in blue. Also note that some of the following was reformatted to make it easier to add comments.

Updating the Server Software

cd [whereever]/sifter-1.00

                    Start in SIFTER distribution directory

perl -w perl/scripts/updateserver.pl 

                    You may need to specify a special Perl library
                    directory. If so, set these environment variables
                    or specify something like this:
                      (PERL5LIB=blahblah; export PERL5LIB; \
                         perl -w perl/scripts/clientinstall.pl)

+----------------------------------------------------
|   Update the SIFTER Software for a Project
+----------------------------------------------------
Here are some things we need from you:

(1) The name of the project to be updated.

(2) We need to know a web server where the SIFTER project is 
accessed. You must tell us the directory in HTDOCS where the
files will be installed.

You will need to provide two directories where some of this
configuration information can be saved. We'll ask for;

(3) We need to know a web server where the SIFTER project will 
accessed. You must tell us the directory in HTDOCS where the
files will be installed.

Are you ready to update the SIFTER project?
Enter y or n:
y 
                    Avoid this with the -quiet option the next time.
                    Do read it at least once so you know what is needed.
                    No point in going further if you don't know the
                    answers to what's going to be asked.

Provide the name of this project. This also is your realm name: MYPROJ

                    The project name is very important as it
                    serves as the realm names for the server
                    and client as well as the directory name 
                    in HTDOCS. Changing this later is not
                    going to be easy. This is case sensitive.

Retrieving realm details from '$HOME/.sifter/createproject.data'
Provide the host name of a web server where sifter-demo will run
  Default=www.YOURDOMAIN.com
  Enter new value or press ENTER for default: 
www.YOURDOMAIN.com 
                    This will almost always be correct as the default
                    is the last value you entered for this.
                    Read carefully, though and be sure!

Provide the protocol to access 'f-www.sph.umich.edu' (https or enter for http)
  Default=https
  Enter new value or press ENTER for default: 
https 
                    This will almost always be correct as the default
                    is the last value you entered for this.
                    Read carefully, though and be sure!

Enter any special port in the URL to access 'f-www.sph.umich.edu' (NNNN or enter)
  Default=
  Enter new value or press ENTER for default: 
 
                    This will almost always be correct as the default
                    is the last value you entered for this.
                    Read carefully, though and be sure!

Provide the full path to the HTDOCS for 'https://f-www.sph.umich.edu'
  Default=HTDOCS
  Enter new value or press ENTER for default: 
HTDOCS 
                    This will almost always be correct as the default
                    is the last value you entered for this.
                    Read carefully, though and be sure!

We need a directory where the server information has been saved.
This directory must be readable by a CGI runnning on
    https://www.YOURDOMAIN.com/MYPROJ
Enter directory path
  Default=/SOMEPATH/sifter/server
  Enter new value or press ENTER for default: 
/SOMEPATH/sifter/server 
                    This will almost always be correct as the default
                    is the last value you entered for this.
                    Read carefully, though and be sure!


Let's check this one last time:
  project=MYPROJ
  URL=https://www.YOURDOMAIN.com/MYPROJ
  CGI database details (server) will be in '/SOMEPATH/sifter/server/MYPROJ'
  HTDOCS is in 'HTDOCS'

Shall we make the various files? y|n y

                    Check the values over carefully. If anything is
                    wrong, enter 'n' and start again. If any errors 
                    are made here, it'll insure something will fail.
Cleaning SIFTER for install. Ignore errors.
Creating Makefiles starting at '.'
Makefiles were created. See log file '/tmp/updateserver.serverinstall.log'

Preparing SIFTER for install. Ignore deprecated messages...
Note: Alert.java uses or overrides a deprecated API.
Note: Recompile with -deprecation for details.
                    Ignore these java compiler warnings.
etc.
Note: Demo.java uses or overrides a deprecated API.
Note: Recompile with -deprecation for details.
SIFTER ready for install. See log file '/tmp/updateserver.serverinstall.log'

                    'make server' has compiled everything and created
                    modules with the paths you provided.

Installing SIFTER...
Install was successful. See log file '/tmp/updateserver.serverinstall.log'

SIFTER project 'sifter-demo' software has been re-installed.

                    Everything is copied to the HTDOCS you specified.
                    You should have a running SIFTER installation.

Congratulations, your SIFTER server has been updated and should work. The data in your project was not touched.