Before doing this, you should have already created at least one project.
Before you can load data into SIFTER, you need a few Perl scripts installed. These need the same set of Perl modules as the other Perl components. Access to the database for the client is done by invoking a CGI script which uses a protocol called SOAP. In order to invoke the CGI script, you'll need the client realm information (the URL to the CGI script) and the web userid and password (if the page is password protected).
As with the demo and project, a script will prompt you for the relevent information (this should start looking familiar). The Perl code is installed and tested. If all is successful, you're ready to set your project attributes and then load maps and results into your project database.
It's time to install the client software. As in the demo 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.
cd [whereever]/sifter-1.00 Start in SIFTER distribution directory perl -w perl/scripts/clientinstall.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) +---------------------------------------------------- | Install SIFTER Client Software +---------------------------------------------------- Here are some things we need from you: (1) The name of the project you created earlier. This is also the realm we'll use for testing. (2) The directory where the SIFTER client code can find the URL for the web server. You provided this when you created (1). (3) If the URL you provided in (2) requires a userid/password to access the data, you will need to know * web userid to use * web password to use (4) A directory where the client software should be installed. This is specified as the PREFIX (top level directory) for the bin, man, lib etc directories where the software will be installed. You must have write access to these directories. These directories should be readable by anyone loading data into SIFTER. (5) A directory where the SIFTER modules will be installed. These Perl modules are necessary for the client scripts to work properly. You must have write access to this directory. If this is not in the Perl default INCLIB path, you will need to set the PERl5LIB environment variable so that Perl can find the SIFTER modules. Are you ready to install the client software? 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 the project created earlier. We will test in this realm: MYPROJ We need the directory where the client information was saved. You specified this creating the project. Enter directory path: /SOMEPATH/sifter/client Good answers, found a URL This means we found something that looked like a realm directory and found a URL. Be sure to verify the URL we found is what you expect. If 'https://www.YOURDOMAIN.com/MYPROJ' is password protected, provide the userid or press enter for none: MYUSER Provide the password or press enter for none: MYPASSWORD If accessing the URL mentioned two lines above will required a password, provide the userid and password here. Ask your web master. Provide the PREFIX for a directory where we can install the client software. This will have a bin, man lib etc subdirectory created in it: /PREFIX This must be a fully qualified path (start with '/') which contains a subdirectory 'bin'. This need not be available to every user in the system - as it is ONLY used by those users who will load results into SIFTER. Provide a directory where the SIFTER modules should be installed: /MODPATH/perl5 '/MODPATH/perl5' is NOT in the default Perl INC path. Client software will include a -I flag so the SIFTER code is found If the path you provide is in the path (@INC) used by Perl, all is fine. If, however, you specified a directory that is not in the standard path, we will add this path to the startup invocation of the Perl client scripts. Let's check this one last time: Project=MYPROJ URL=https://www.YOURDOMAIN.com/MYPROJ webuid=MYUSER webpwd=MYPASSWORD Client details will be in '/SOMEPATH/sifter/client' Install client software starting at '/PREFIX' SIFTER modules will be installed at '/MODPATH/perl5' This is NOT in the default Perl modules path Shall we continue? 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. Creating user information to access the URL... Created user realm file '/home/tpg/.sifter/user.cfg' This is where we save the web userid and password to access your URL. Saved pointers to realm data in '/tmp/clientinstall.data' Retrieving realm details from '/tmp/clientinstall.data' Some of the input to clientinstall.pl is saved here. You may delete this after this install is successful. Cleaning SIFTER for install. Ignore errors. Creating Makefiles starting at '.' Makefiles were created. See log file '/tmp/clientinstall.clientinstall.log' We start by finding where you have installed the SIFTER code and then doing 'perl Makefile.PL'. Since you have provided all the details earlier, you do not need to answer the questions. Preparing SIFTER for install. Ignore deprecated messages... SIFTER client ready for install. See log file '/tmp/clientinstall.install.log' 'make client' has created the modules with the paths you provided. Installing SIFTER client... Can't stat blib/arch: No such file or directory Ignore this error message. Get list of SIFTER programs we installed Corrected /PREFIX/bin/addanalysis.pl Corrected /PREFIX/bin/addattr.pl etc. If the path you specified for the SIFTER modules was not in the default Perl path, we correct the first line of each script to include the SIFTER modules path. Install was successful. See log file '/tmp/clientinstall.install.log' Everything is copied to the PREFIX you specified. Try to access database using SOAP... Client program can access SIFTER database. See log file '/tmp/clientinstall.client.log' We run showsifter.pl to access the database using the web server. If it works, everything else will work. SIFTER client software is ready for you to use.
Congratulations, your SIFTER client programs have been installed and should work. Now it's time to set the attributes for your project and then load data into the SIFTER database.Version=$Id: clientinstall.html,v 1.5 2002/10/02 12:59:17 tpg Exp $