04. WebAGRIS frequently asked questions

 

  1. After typing the URL into the browser’s “Address” or "Location” bar, the browser gives an error box: “The URL you asked for does not exist on this website”

     
  2. After typing the URL into the browser’s “Address” or "Location” bar, the browser provides the left frame, but the right frame does not appear.

     
  3. WEBAGRIS software is installed on the server.

    How can I run the old DOS ISIS from a client machine?


     
  4. During the installation of Xitami Web Server I have received the following error message: "Could not open http Port 80. Port is already used by another server"

     
  5. How can I uninstall WEBAGRIS software?

     
  6. I am not able to start the system when trying to launch the program on a client computer.

     
  7. I am not able to start the system when trying to launch the program on the server computer from either the shortcut icon on my desktop (WEBAGRIS) or by typing the URL address into the browser.

     
  8. The system accepts your LOGIN, but does not allow you to start entering data in a new record.

     
  9. The system gives this message: "The URL you asked for does not exist on this website". How to desactivate the proxy server which within the LAN filters out the “cookies” when you want to access the Data Entry subsystem

     
  10. When updating I get following message:

    Error code: -101

    Data Base access denied (data entry lock).

    When I try to unlock the database (using the CDS-ISIS DOS-interface) nothing happens.


     
  11. Can I use WEBAGRIS with MS IIS instead of Xitami Web Server?

     
  12. How to install WEBAGRIS in a network computer environment with no DNS defined?
  13. How to change width of the left panel of WEBAGRIS data entry window?

     
  14. How do I manage to export selected records easily from WebAGRIS? Is there any way to mark some records and then to export only those records, for instance while I have to export records that are not in a MFN sequence?

     
  15. How do I access the Data Entry module and how do I define a new user with full rights?

     
  16. What sort of national diacritic characters and codepages can I use with WebAGRIS?

     
  17. Does WebAGRIS support AGRIS Application Profile?
  18. What to do if the message "Database locked by another user. Retry later" is given from DOS CDS/ISIS

     
  19. While working the system blocks and the following Error messages appear on the screen:

    “This server is currently overloaded – please try again later

    Error code: - 102 data base access denied (probably write lock)”.


     
  20. How to extract a debug log from the system (i.e. so as to alert the software developer to your problem).

     
  21. The system works very slow and shows BIREME logo.

     
  22. How to uninstall XITAMI Web Server.

     
  23. Error code: - 1023 User not found or Error code: - 1024 Invalid password.

     



 

  1. After typing the URL into the browser’s “Address” or “Location” bar, the browser gives an error box: “The URL you asked for does not exist on this website”



    This message means that the Web Server works, but it does not see the location of the HTMLs for the WebAGRIS application. It may be that the WebAGRIS folder is not located at the Web Server root; if this is the case, uninstall the system (using the standard Windows ADD/Remove programs procedure available from the Control Panel) and install it again, providing proper parameters for the Web Server root.

    Another possible solution in this case is to define the WebAGRIS folder as the "virtual root directory" of the WEB server; this however requires thorough knowledge of the Web Server you are using.



    top



     
  2. After typing the URL into the browser’s “Address” or "Location” bar, the browser provides the left frame, but the right frame does not appear.



    This may happen in two cases:

    (a) if the cgi directory is not the one you indicated during the installation procedure the Web Server cannot find the program isis3w.exe. In this case, check out the proper name of the cgi directory and copy there the program isis3w.exe, along with the files isis3w.exe.cfg and Isis32.dll.

    (b) it may also happen that your Web Server does not have switched "on" the execution of the cgi programs. In this case, you have to open the Web Server control panel and change the setting for cgi (if you use XITAMI this should never happen).



    top



     
  3. WEBAGRIS software is installed on the server. How can I run the old DOS ISIS from a client machine?



    You can run DOS CDS/ISIS on the server machine (as all data base administrator functions are executed on the server. You can also map the shared folder (as e.g. X drive) of the server from the client machine and then run isis.exe. All the parameters (paths) required by isis.exe should be defined relatively.



    top



     
  4. During the installation of Xitami Web Server I have received the following error message: "Could not open http Port 80. Port is already used by another server"



    When installing Xitami Web Server it may happen that Port 80 (which is the default port used by Xitami) is already dedicated to another Web Server installed on your PC. If this is the case, Xitami will not open up correctly when typing the URL http://localhost. You may or may not receive the following error message: "Could not open http Port 80. Port is already used by another server".



    You should then change the Port number assigned to Xitami, by editing the Xitami.cfg file (using Notepad), located in the Main Xitami directory (C:\Xitami if you have not changed the defaults during the installation process), and assigning to the parameter portbase a number different than zero.



    Remember that the Port number and the portbase value should be assigned in a way that: Port no. = 80 + portbase. The 2 variables are dependent. Once you decide the value to be assigned to one of the two, the other should be calculated according to the formula above



    For example, if you decide to use Port no. 120, then you should type 40 as Portbase value in the Xitami.cfg file. If you decide to assign 10 to the Portbase value, then your Port number will be 90.



    Note: If you are going to start WEBAGRIS on the server computer using the icons WEBAGRIS Search and WEBAGRIS Data Entry, remember to add the same port number in the icons destination field.



    top



     
  5. How can I uninstall WEBAGRIS software?



    To uninstall the system:

    - use the icon Add/Remove Programs on the control panel

    - find the system WEBAGRIS

    - click on REMOVE button



    top



     
  6. I am not able to start the system when trying to launch the program on a client computer.



    We assume that the system works properly on the Web Server, but when you trying to launch the program on a client computer by typing the URL address into your browser - you are not able to start the system:



    (a) Verify the URL, especially the "port" part. Please note that normally the port number is omitted from the URL if its value is 80, otherwise it should be stated (if you have changed the Port number to a value different than 80, then you should remember to insert the new Port number in all the URL addresses).

    (b) Check if other web resources on the server are available for the client, try for example using the URL: http://server_url/ (if you use xitami web server try http://server_url/admin). If the URLs don’t work you should verify the connectivity between client and server computer

    - in terms of hardware – check if the client is connected to the LAN,

    - in term of software – check if the client has the TCP/IP connectivity installed.



    top



     
  7. I am not able to start the system when trying to launch the program on the server computer from either the shortcut icon on my desktop (WEBAGRIS) or by typing the URL address into the browser.



    First, check if the connectivity between client program (browser) and Web Server (Xitami) can be established:<BR>

    To solve this problem, open your browser and check if the following URL works http://127.0.0.1/



    If you see the XITAMI welcome page, the XITAMI Web Server is installed correctly.

    If at URL http://127.0.0.1/agris, you see the WEBAGRIS search screen, but at http://www4.isis.org/agris you cannot get a connection, there are two possible problems:



    (a) your server has no DNS

    (b) the attempt to assign the name http://www4.isis.org/locally has failed



    To solve this problem:

    - search for the file host (in standard installations of Windows 95 and Windows 98 - the file is usually in the catalogue Win95, or Win98 respectively)

    - open the file using Notepad. You should see the following line:

    127.0.0.1 local host

    - Go to a new line and type the following:

    127.0.0.1 www.isis.org

    - reboot the server



    Another reason might be that the server does not work - check it by indicating another URL valid for this server (in the case of XITAMI, try for example the URL: http:/localhost/admin. This should bring up the Xitami administration panel. If nothing happens, then the server does not work; just restart the Xitami WEB server.



    If you are sure that the Web Server works properly, and the TCP/IP connectivity is set up properly but you still cannot fix the problem, try to uninstall the system. After removing WEBAGRIS, reboot the computer and repeat the installation procedure



    top



     
  8. Cookies not working. The system accepts your LOGIN, but does not allow you to start entering data in a new record.



    This may be caused by the following:

    (a) “Cookies” option does not work in the browser. Check the setting of your Web Browser's "cookies" option You can check this by going to the Netscape Tool Bar (click on EDIT -> Preferences -> Advanced);

    (b) Cookies are still not working. Check in the file isis3w.exe.cfg the value of the parameter CookieDomain and use this value as the DNS in calling WEBAGRIS (this is actually full name). If for example the value of the parameter is isis.icie.pl, use for the data entry the url http://isis.icie.pl/asfa/de.html.



    top



     
  9. Cookies not working (cont.)The proxy server within the LAN filters out the “cookies” when you want to access to the Data Entry subsystem the system gives the message like this "The URL you asked for does not exist on thie website"



    This problem could be solved by the LAN manager who should disactivate a proxy server for addresses beginning with the DNS of the server of your application.

    If you want to try this yourself, follow these steps:

    Step 1: Launch Internet explorer browser by clicking Explorer icon

    Step 2: On the Menu bar click on 'Tools'

    Step 3: You will see a combo box with a list of options

    Step 4: Select 'Internet option' command and click on it

    Step 5: Now you see the 'connections' button

    Step 6: Click on the button

    Step 7: Now you will see the 'LAN Settings...' button

    Step 8: Click on this button

    Step 9: The system opens a window on 'Local Area Network (LAN) settings'

    Step 10: In this window click on the 'Advanced...' button

    Step 11: Now you can see a window 'Proxy Settings'

    Step 12: Enter the http address of your proxy server (I have entered 125.125.1.1 and Port 80)

    Step 13: Underneath the sentence ' Do not use Proxy Server for Addresses beginning with:' type www.isis3w.org in the white space

    Step 14: Click on 'OK'

    Step 15: Close the windows and start Internet explorer

    Step 16: In the address part type http://www.isis3w.org/agris

    Step 17: You will see the WebAgris main page

    If you wish to enter data in WebAgris, enter the following in the address area of your Internet explorer : http://www.isis3w.org/agris/de.html You will be asked for your 'User Name' and 'Password'. Enter dba against 'User Name' and dba against 'Password'. Press 'Enter' . When you see the message: 'DATA ENTRY' 'User dba logged in', you can enter your data.

    For example: In Internet Explorer/Tools-Internet options-> Connections -> LAN Settings-> Proxy server->Advanced-> Do not use a proxy server for addresses...type the DNS for your application.



    top



     
  10. When updating a record I get following message:

    Error code: -101

    Data Base access denied (data entry lock).

    When I try to unlock the database (using the CDS/ISIS DOS-interface) nothing happens.



    Run the CDS/ISIS DOS-interface and do the following :

    1) From the main menu select I (Inverted file services)

    2) Select U (Update inverted file) as the inverted file update may be pending

    3) Go back to main menu and select M (Master file services)

    4) Select C (Reorganize master file)

    Note: Steps 1 and 2 are not always necessary but they are included in the procedure becuase the reorganization of the master file cannot be done while the inverted file is pending.

    We strongly recommend running Full Inverted File Generation (options I and then F) at the end.



    If these steps are not successful, you should try to clear the WORK database, by doing the following:



    Run the CDS/ISIS DOS-interface;

    From the Main menu select option C-change database to WORK;

    Select option D-define database;

    From the Secondary menu select option I-initialize database;

    Make ure that the database is WORK and not AGRIS.



    top



     
  11. Can I use WEBAGRIS with MS IIS instead of Xitami web server?

    To start the system under IIS you must:

    1) Install WEBAGRIS with our installation procedure

    2) Define under IIS the directory WEBAGRIS as a virtual WEB directory.

    3) Define the cgi-bin directory (under file explorer) as the virtual cgi-bin directory, with rights to execute scripts and programs (for more information see the Word document).

    4) Test the system from the Web Server and/or connected clients

    top



     

  12. How to install WEBAGRIS in a network computer environment with no DNS defined?



    There are two solutions:

    1) Use IP address of the server instead of http address. Remember that http address must be consistent with CookieDomain specified in isis3w.exe.cfg, so in this case CookieDomain must show IP address.

    2) Add http address line to "hosts" file on all computers (e.g. C:\WINNT\system32\drivers\etc\hosts)



    More information you can find in documentation "Network Computer Environment" for WEBAGRIS section 3 and 4.2.



    top



     
  13. How can I change width of the left panel of WEBAGRIS data entry window?



    1) Find in the WEBAGRIS directory the file de.html

    2) Open it with notepad

    3) Change the size of the frame in the phrase:

    ...

    <FRAMESET COLS="184,*" border="0" frameborder="0" framespacing="0">

    <NOFRAMES>

    <B>Sorry, wrong browser! - you must use Netscape 4.x or IE 4.x </B>

    </NOFRAMES>...



    top



     
  14. How do I manage to export selected records easily from WebAGRIS? Is there any way to mark some records and then to export only those records, for instance while I have to export records that are not in a MFN sequence?

    You can create your own search strategy to do this. Here are some tips to help: If you want to export to the central AGRIS database, we advise doing it through the search interface.



    a.   Click on the Advanced button

    b.   Select only records with status C - Completed

    c.   Select from the date entered the month and year for the range of records you want to export or use the TRN search by typing begining common part for the range of TRNs and put dollar sign as a mask, for example: CU200400001$ will extract you all TRN ending from 100 to 199,or click on List at the TRN row to select the specific TRNs that you want to export



    1. Click on Search

    2. Check the "Selected for Export" box then click "Export"

    3. Select the format for export that can be tag/text, ISO2709 or XML as export type and click "Export"

    4. At this point you should have the Save as/Open dialog box that will allow you to save the records to a batch



    In data entry module you can also export range of MFN if the required records are in MFN order and export them in desired format

     

    top



     

  15. How do I access the Data Entry module and how do I define a new user with full rights?

    As mentioned earlier, the folder WWWISIS contains a link to the authorization file. The file defines two user groups, namely admuser and admval. The first group of users is authorized to enter/modify bibliographic records. The second group is authorized the authority re-cords, such as Corporate names, Serial Titles, Conference Names. The original file defines two users:

    . dba with the password dba: This user is authorized to enter, modify and delete all types of records.

    . user with the password user: this user is authorized to enter, modify and delete the bibliographic records only

    It is recommended to change the password of the defined users. In addition, depending on the needs one can define other users, assigning them User Id and passwords. If for organizational matters it is desirable that some of the users are restricted in entering the authority records, one can define the user privileges based on the user specification. If all of the users should have all privileges we use the specification dba for creating new users, just by copying the text

    ...

    <isis_user> name = dba; password = dba; groups = admusr, admval; </isis_user>

    and changing the name and password.



    If you want to add a name and password, just add the tag above, replacing the values "dba" with your name and password. For ex., if you had Agris1 as user and "welcome" as password, you should add a tag after the above, writing: <isis_user> name = Agris1; password = welcome; groups = admusr; </isis_user> This will define a user called agris1 (note that this is case sensitive) with a password "password" with the same rights as the dba user, that is "create", "modify" and "delete".



    top



     

  16. What sort of national diacritic characters and codepages can I use with WebAGRIS?

    Here we have to distinguish between the typed data and interface language versions.

    There is a documentation on how to create new language interface which can be distributted on request.



    If the input is done for the central AGRIS database, there are still existing restrictions valid.

    Otherwise WebAGRIS generally works with Latin-1 ie ISO-8859-1 character set. It supports diacritics for languages such as French, Spanish, Catalan, Galician, Basque, Portuguese, Italian, Albanian, Afrikaans, Dutch, German, Danish, Swedish, Norwegian, Finnish, Faroese, Icelandic, Irish, Scottish, English.

    Texts written in other languages, abstracts, titles, names should use common methods of transliteration to Latin-1. Especially should be avoided direct copying and pasting of texts with non-Latin-1 national diacritics, since they cannot be registered as a valid Agris input.

    Experience was gained with inputting and displaying data in other languages Arabic, Chinese etc.

    This data can be shown on display (after changing code pages in the interface), but the search is still limited to and ASCII tables of 256 characters.

    Support for Unicode is not yet available.



    top



     

  17. Does WebAGRIS support the AGRIS Application Profile?

    WEBAGRIS is a tool for distributed data input, processing and dissemination of agricultural bibliographic information. This tool is used for preparing input for the central AGRIS database. It conforms to the AGRIS Application Profile by using a specific XML format in the export function of the system.

    top



     

  18. The message "Database locked by another user. Retry later" comes from the DOS CDS/ISIS

    The procedure to unlock the database is as follows:



    1) From the main CDS/ISIS DOS menu select option D (Database definition services)

    2) Select R (Unlock database)

    3) Select D (Database locks)

    4) Press X twice to go back to the main menu

    5) From the main menu select I (Inverted file services)

    6) Select U (Update inverted file) as inverted file update can be pending

    7) Go back to main menu and select M (Master file services)

    8) Select C (Reorganize master file)



    top



     

  19. While working the system blocks and the following Error messages appear on the screen:

    “This server is currently overloaded – please try again later

    Error code: - 102 data base access denied (probably write lock)”.

    A:The problem is with the WORK database. To keep the system from blocking it is recommended that the WORK database be cleaned from time to time.

    The best way to clean it is to replace 8 of the 12 files which are contained in the directory C:\Xitami\webpages\DB\agris\Work with the 8 files contained in the zipped file Work.Zip, included in the same directory.

    The following procedure is recommended:

    Open the Work.zip file, and extract the 8 files contained there into the WORK folder (C:\Xitami\webpages\DB\AGRIS\Work, unless you changed the destination drive during installation).

    If you don’t have empty work database zipped, you could go to DOS/ISIS and Re-initialize the database WORK.

    Change the name of your database to “work” . Select option D-database definition and then to I- Initialize database. Be sure that you are in work database. (It is advisable to take backup of your “agris” database before this operation expecialy if you do it for the first time).

    Note that the WORK database is NOT the database containing your AGRIS records; it is a database within the system used for storing session details, therefore you don't have to worry about losing your AGRIS records.

    Also note that it is advisable to delete the Internet Temporary files from time to time, since some of these files may interfere with the system.

    top



     

  20. How to extract a debug log from the system (i.e. so as to alert the software developer to your problem).

    In the event that you cannot find the solution to your problem in these FAQ or the suggested procedures do not solve the problem, you can extract a “log file” from the system, which can then be sent to the software developer (and FAO) in order to identify the reason for this error.

    The procedure to extract the log file is as follows:

    1. Identify the file isis3w.exe.cfg in the directory C:\Xitami\cgi-bin

    2. Identify the line containing DebugLevel 0

    3. Change DebugLevel 0 to DebugLevel 20000 and save the file isis3w.exe.cfg

    4. Return to the application, sign on and after receiving the “Error” exit from the system

    5. Return to the file isis3w.exe.cfg and change again DebugLevel 20000 to DebugLevel 0 and save the file

    6. Identify the file debuglog and send it to the software developer (and FAO)

    7. For example the debuglog could be located in C:\Xitami\webpages\debuglog.txt

     

    top



     

  21. The system works very slow and shows BIREME logo

    Check that the environment variable BAP with the value: OS23470a exists. This variable is automatically created during the installation of WEBAGRIS. If the installation did not finish successfully, the variable may not exist so you have to add it.

    top



     

  22. How to uninstall XITAMI Web Server.

    The following procedure should be carried out:

    1. Use the icon Add/Remove Programs available from the Control Panel

    2. Find XITAMI

    3. Click on the REMOVE button

    4. After carrying out this procedure some files remain in the XITAMI folder, therefore go to the directory XITAMI and manually delete the files contained in the folder and the folder itself.

     

    top



     

  23. Error code: - 1023 User not found or Error code: - 1024 Invalid password.

    When starting the application, one of the following error messages is displayed on the screen:

    “Error code: - 1023 User not found” or “Error code: - 1024 Invalid password”.

    Check that the Username and Password are correct. If you are using the default Username and Password dba, then make sure that it is typed in small letters and NOT in capital letters.



    top