FREQUENTLY ASKED QUESTIONS


  -1- What services does R.E.D. Server Development provide?  
  -2- Who is authorized to use R.E.D. Server Development?  
  -3- How to use R.E.D. Server Development?  
  -4- How to create your own R.E.D. Server Development?  
  -5- How to get help about the PyRED program and R.E.D. Server Development?  
  -6- What files are needed to submit a job to R.E.D. Server Development?  
  -7- How to download/access a project generated by R.E.D. Server Development?  
  -8- How are jobs handled by R.E.D. Server Development?  
  -9- How does a R.E.D. Server Development user know when her/his job starts and ends?  
-10- Can a R.E.D. Server Development user kill one of her/his job?  
-11- How long are the projects generated by R.E.D. Server Development kept available for downloading?  
-12- Which browser can be used to access R.E.D. Server Development?  
-13- Why one cannot open the Internet link to a R.E.D. Server Development job by using Internet explorer?  
-14- What is the format of the Gaussian outputs generated by R.E.D. Server Development?  
-15- How to use geometry optimization outputs generated by NWChem, Q-Chem, Turbomole or Jaguar in R.E.D. Server Development?  
-16- What are these error messages generated by R.E.D. Server Development when uploading input files?  
-17- Is there any limitation in R.E.D. Server Development and why?  
-18- How to generate a standalone graphical interface to parse R.E.D. Server Development outputs?  
-19- How to construct a PDB input file for R.E.D. Server Development using Jmol?  
-20- How to exchange data between users using R.E.D. Server Development?  
-21- How and when to contact the authors of R.E.D. Server Development?  
-22- How to cite R.E.D. Server Development?  



  -1- What services does R.E.D. Server Development provide?  

      -1.1- R.E.D. Server Development provides the software and hardware required for RESP and ESP atomic charge derivation, force field library building and force field parameter generation for new molecule(s) and/or new molecular fragment(s) (see Scheme 1):


Scheme 1

      a) Software
- In agreement with the Gaussian Inc. company, R.E.D. Server Development is authorized to interface the Gaussian program. Different versions of the Gaussian program are available (versions 2003 E.01, 2009 A.02, 2009 C.01 as well as the latest one 2009 D.01).
- In agreement with the GAMESS developers, the latest version of the GAMESS-US and Firefly versions are also interfaced by R.E.D. Server Development.
- The latest version of the PyRED program developed by the q4md-forcefieldtools team is executed by R.E.D. Server Development.
      b) Hardware
R.E.D. Server Development runs on a cluster of quadri-core Intel® Xeon® (processor E5430) and AMD dual-Core OpteronTM (processors 8212 and 8220). 8 cores (i. e. 2 or 4 cpus, with 16 Gb RAM per node) are used for a R.E.D. Server Developement job.

      -1.2- Help for R.E.D. Server Development users is provided (see FAQ 5 for more information).

      -1.3- A tutorial is now available.

      -1.4- A demonstration is also available from the Demo service at the R.E.D. Server Development home page.

      -1.5- For each project computed by R.E.D. Server Development a Jmol based graphical interface (in the html format) is generated allowing the user parsing and displaying the corresponding data (see also FAQ 18). Screen snapshots describing the graphical interface corresponding to the W-46 R.E.DD.B. project are described in Figure 1(A-B). The graphical interface as well as the corresponding data generated by R.E.D. Server Development for the F-45 and F-50 R.E.DD.B. projects are available here (with the last features incorporated in PyRED the "F-45" and "F-50" R.E.DD.B. projects can now be generated in a single R.E.D. job).

Figure 1(A-B)

      -1.6- For each project computed by R.E.D. Server Development a specific web address is created allowing users to directly access and download the corresponding data (see FAQ 7). A graphical interface to the Qstat command is also available to follow the jobs in the R.E.D. Server Development queuing system (see FAQ 9).

      -1.7- Jmol based java applets have been developed allowing any user building PDB input files for R.E.D. Server Development (see FAQ 19).

      -1.8- Data generated using R.E.D. Server Development can be automatically submitted to R.E.DD.B. if a R.E.D. Server Development user wants to use this option (see R.E.DD.B. FAQ 5 for more information).

      -1.9- Finally, the latest developments in term of force field development carried out by the q4md-forcefieldtools team will be provided through R.E.D. Server Development. The release of these new developments will be carried out from time to time, and the description of those new features released in R.E.D. Server Development will be available at the PyRED news web page.


  -2- Who is authorized to use R.E.D. Server Development?  

      All researchers (from the academic world and from private laboratories) can use R.E.D. Server Development.

      -2.1- In agreement with the developers of the GAMESS-US and Firefly programs any user is authorized to interface GAMESS-US and Firefly with R.E.D. Server Development.

      -2.2- In agreement with Gaussian Inc. only academic users are authorized to interface Gaussian with R.E.D. Server Development.


  -3- How to use R.E.D. Server Development?  

      -3.1- Registration to use R.E.D. Server Development is not mandatory. However, in agreements with the developers of the GAMESS-US, Firefly and Gaussian programs, the direct use of R.E.D. Server Development (i. e. without any registration step) is limited to the execution of GAMESS-US or Firefly.

      -3.2- R.E.D. Server Development provides also the opportunity to a user to create at any time a private space of work or account. In these conditions, a user has to Register at the R.E.D. Server Development home page and select "Registration to get a private account". To fulfill the agreements established between the developers of R.E.D. Server Development and these of the GAMESS-US, Firefly and Gaussian programs, it is requested to any researcher interested in registering as a R.E.D. Server Development user to certify if she/he is an academic users or not. However, after registration a user retains her/his account only if she/he keeps using it. Thus, after three months of inactivity the private account is automatically deleted, and a user has to re-register if she/he wants to interact with R.E.D. Server Development by using a private account again.

      The two ways to access R.E.D. Server Development are described in Table 1:

Ways to access
R.E.D. Server Dev.
 
Registration
required
 
Email of the
user required
 
QM programs
interfaced (*)
 
Account
used
Direct use of
R.E.D. Server Dev.
 
No
   
No
 
GAMESS-US
Firefly
 
A common public account
Use of a
private account
 
Yes
 
Yes
 
Gaussian 2016
Gaussian 2009
Gaussian 2003
GAMESS-US
Firefly
 
A private account per user
(*) During the Demo, any of the three QM programs can be interfaced.
Table 1

      -3.3- A private account created by a user is common to R.E.D. Server and R.E.D. Server Development.


  -4- How to create your own R.E.D. Server Development?  

      Any researcher can create her/his own R.E.D. Server Development. The source code of R.E.D. Server Development is distributed under the GNU General Public License, and is available for downloading for this purpose. Users interested in this option can contact us at contact_at_q4md-forcefieldtools.org. They should also contact the developers of GAMESS-US, Firefly and Gaussian if they decide to interface these programs.


  -5- How to get help about the PyRED program and R.E.D. Server Development?

      Any person interested in RESP or ESP charge derivation, force field library building and force field parameter generation for new molecule(s) and/or molecular fragment(s) can obtain help from the q4md-forcefieldtools team.

      -5.1- Each person having a private account and registered as a R.E.D. Server Development user can obtain a private assistance by using the Assistance service provided at the R.E.D. Server Development home page. In this case, the questions asked by each R.E.D. Server Development user will remain hidden to the scientific community and the q4md-forcefieldtools team will try to provide specific answers to each R.E.D. Server Development user's problem.

      -5.2- For more general questions, a general public help is provided by using the q4md-forcefieldtools mailing list. Any researcher can participate in this mailing list by answering and/or sending queries to q4md-fft@q4md-forcefieldtools.org after registration at sympa@q4md-forcefieldtools.org. To register in the q4md-fft mailing list just send an email to sympa@q4md-forcefieldtools.org with "subscribe q4md-fft" in the email subject or body (to un-subscribe just send "unsubscribe q4md-fft"). Archives of the q4md-fft mailing list are public.
      When describing the problem you encountered with R.E.D. Server Development, please also provide the 'PXXXX' R.E.D. Server Development job name in the body of your email so that we can more easily assist you.

      -5.3- We are also registered in the AMBER and CCL mailing lists, and we will answer queries about the q4md-forcefield tools in these two mailing lists as well.


  -6- What files are needed to submit a job to R.E.D. Server Development?  

      A R.E.D. Server Development user needs to prepare PDB input files for R.E.D. Server Development/PyRED (see FAQ 19). A description of the PDB format used is available in the readme.txt file (see the documentation). More generally this documentation describes the different files, which have to be uploaded and used as inputs. The input files to be provided depends on the type of computation to be performed, on the molecules involved in the job as well as on the modes of execution of the PyRED program. These input files have to be uploaded in R.E.D. Server Development as a single archive file. The definition of a PyRED job, as well as the upload of the archive file is performed from the submission service available at the R.E.D. Server Development home page:

      -6.1- The archive file has first to contain a series of Mol_red$n.pdb input file(s) ('$n' starts at 1, and is the number of the consecutive molecules involved in a PyRED job).
      It might also contain a series of geometry optimization Mol_red$n.log file(s), as well as a Project.config, a System.config and/or a frcmod.user files.
      If Re_Fit is set to "On" in the "System.config" file a PyRED job has to be provided in the archive.

      -6.2- See also the tutorials.


  -7- How to download/access a project generated by R.E.D. Server Development?  

      There are two different cases depending on how the user interacts with R.E.D. Server Development:

      -7.1- When a researcher directly uses R.E.D. Server Development without any private account, the address of download for each project generated by R.E.D. Server Development is provided at the end of the input submission procedure (i. e. before the job effectively starts on R.E.D. Server Development).

      -7.2- When a researcher uses her/his private account, the project generated using R.E.D. Server Development can be downloaded via the Download service available at the R.E.D. Server Development home page. The download link is also provided at the end of the input submission procedure.


  -8- How are jobs handled by R.E.D. Server Development?  

      The TORQUE resource manager (version 2.5.12) and Maui scheduler (version 3.3.1) manage jobs on R.E.D. Server Development. A maximum of three or nine jobs per private or public account are allowed on R.E.D. Server Development, respectively. Other jobs are automatically sent to the queuing system. These simple rules insure that every R.E.D. Server Development user gets an equal access the computational resources provided by R.E.D. Server Development. This also means that the public account of R.E.D. Server Development can be quickly saturated if different researchers simultaneously use this account. More generally, the queuing system of R.E.D. Server Development will be adapted if it gets saturated.


  -9- How does a R.E.D. Server Development user know when her/his job starts and ends?  

      There are two different cases depending on how the user interacts with R.E.D. Server Development:

      -9.1- When a researcher directly uses R.E.D. Server Development without any private account, she/he has the possibility to provide her/his email address at the beginning of the submission procedure. Thus, R.E.D. Server Development is able to reach the user to transmit information about the status of the job (initiation and termination). If a wrong email address is provided by error or if a user refuses to provide an email address, the user can still submit a job to R.E.D. Server Development and download the corresponding data. Indeed, the address of download (Internet explorer user: read FAQ 13 for more information!) is given to the user at the end of the submission procedure before the corresponding job terminates (or even starts). In the later case, as the submission procedure cannot guess when a R.E.D. Server Development job ends and cannot contact the user, the status of the job is not given to the user. The time taken by a PyRED job is difficult to estimate, in particular when geometry optimization is performed and/or when complex charge derivation involving multiple molecules and multiple conformations is requested. Consequently, a user has to look at the graphical interface of the Qstat command to find out when a job executed using the R.E.D. Server Development public account terminates.

      -9.2- During the registration procedure to get a private account a researcher provides her/his email address. Thus, when a researcher uses a private account, she/he will receive three different emails from R.E.D. Server Development. The first one is sent when the inputs have been successfully uploaded to R.E.D. Server Development (the address of download of the data generated by R.E.D. Server Development is given to the user at the end of the submission procedure). The second one is sent by the R.E.D. Server Development queuing system when the job effectively starts. The third one is sent when the job has ended. At any time, a researcher can use the graphical interface of the Qstat command to check the status of a R.E.D. Server Development job.

      Moreover, for each R.E.D. Server Development job the different steps carried out by the PyRED program are written in a log file. This file can be displayed by the owner of the job from the graphical interface of the Qstat command. This allows any user checking the status of a given job at any time during its execution. The log file of a R.E.D. Server Development job executed using the public account remains public. On the contrary, a user must provide the login and password of her/his private account to display the .log file of a R.E.D. Server Development job executed using this account.


  -10- Can a R.E.D. Server Development user kill one of her/his job?  

      When using the Job deletion service available from the graphical interface of the Qstat command a user can only kill the R.E.D. Server Development job(s) executed with her/his private account. Indeed, a R.E.D. Server Development job executed using the public account cannot be killed because this account is common and can be used anonymously. To kill a job a user has to provide the R.E.D. Server Development JOB NAME (obtained from the Qstat graphical interface) with her/his login/password.

      The data corresponding to a killed job can now be downloaded by the user from her/his private account.


  -11- How long are the projects generated by R.E.D. Server Development kept available for downloading?  

      There are two different cases depending on how the user interacts with R.E.D. Server Development:

      -11.1- When a researcher directly uses R.E.D. Server Development without any private account, the public account of R.E.D. Server Development is used. Considering that this account can be extensively used and that tremendous amounts of data can be generated, R.E.D. Server Development projects generated using this account are kept only 5 days on the cluster hard drives.

      -11.2- On the contrary, when a researcher uses her/his private account, projects generated using R.E.D. Server Development are kept 20 days on the cluster hard drives.

      After these periods of time, the data are automatically deleted without warning.


  -12- Which browser can be used to access R.E.D. Server Development?

      R.E.D. Server Development is not browser specific. The following browsers have been tested:
      - Internet Explorer from Microsoft,
      - Konqueror from KDE,
      - Opera,
      - Chrome,
      - Mozilla/Firefox,
      - Safari,
      Extensive tests have been carried out using Chrome, Mozilla/Firefox and Opera. Consequently, it is strongly recommended to use one of these browsers...
      Finally, since the R.E.D. Server Development web site uses PHP sessions with cookies (to control the access R.E.D. Server Development), the javascript language (to control the shape of each window and provide information/definitions in 'popup' windows), and Java (to visualize charge values and structures with Jmol), cookies, javascript and java have to be enabled in the user browser. Moreover, the J2SE Runtime Environment (JRE) has to be installed on the R.E.D. Server Development user front-end machine (client) if the user wants to visualize the charges and the structures reported on the R.E.D. Server Development web site. Jmol has been installed on R.E.D. server, each user does not need to install it on her/his own machine.

      Help about configuring Java on Lunix can be found here.


  -13- Why one cannot open the Internet link to a R.E.D. server job by using Internet explorer?  

      At the end of the input submission procedure or in a dedicated email sent to the user, an Internet link is provided to the user to access her/his R.E.D. server job. This Internet link has the following format: http://login:password@address_of_the_cluster/address_of_the_job_in_the_cluster.

      This particular format is not recognized by Internet Explorer (tested versions: 6.x, 7.x and 9.0), and the later is not able to find the corresponding Internet address. To avoid this limitation in Internet explorer the login and password have to be removed from the Internet address (i. e. one should use instead the following format: http://address-of-the-cluster/address-of-the-job) and manually provide the required login and password, or one should use another browser such as Mozilla/Firefox, Opera, Chrome or Safari.


  -14- What is the format of the Gaussian outputs generated by R.E.D. Server Development?

      In agreement with Gaussian Inc., the outputs generated by the Gaussian program are filtered by the PyRED program. Thus, only the pieces of information required in RESP and ESP charge derivation and force field library building are conserved in the Gaussian program outputs. If a user wants to get the complete Gaussian output, she/he will have to execute the Gaussian program without using R.E.D. Server Development on her/his own machine. In this case, downloading and using the R.E.D. tools available from the R.E.D. web site in a standalone mode is an alternative.


  -15- How to use geometry optimization outputs generated by NWChem, Q-Chem, Turbomole or Jaguar in R.E.D. Server Development?

      Before anything else, it is recommended to check the latest updates of R.E.D. Server Development available at the R.E.D. Server Development news. Indeed, this feature might have been released by the q4md-forcefieldtools team at the time a R.E.D. Server Development user needs it. If not available, optimized cartesian coordinates using NWChem, Q-Chem, Turbomole, Jaguar or ADF (among many others) have to be manually re-formatted into a format recognized by the R.E.D. program, i. e. a Gaussian or a GAMESS/Firefly like format. Read the R.E.D.-II FAQ about how to perform this task, and execute R.E.D. Server Development in "Mode 2".


  -16- What are these error messages generated by R.E.D. Server Development when uploading input files?

      When uploading input files for R.E.D. Server Development, the following error messages might be generated:
Warning*: ssh2_scp_send() [function.ssh2-scp-send "http://q4md-forcefieldtools.org/REDServer-Development/function.ssh2-scp-send"]: Unable to read source file in *~/REDServer-Development/xxxxxx.php* on line *xxx*
Upload of the P2N file *number = 1*... [ Failed ]

Warning*: ssh2_scp_send() [function.ssh2-scp-send "http://q4md-forcefieldtools.org/REDServer-Development/function.ssh2-scp-send"]: Unable to read source file in *~/REDServer-Development/xxxxxx.php* on line *xxx*
Upload of the QM file *number = 1*... [ Failed ]


      R.E.D. Server Development might present temporary internal network problems and input files cannot be uploaded. Simply wait for a couple of hours and try again. You might also try reducing the size of the uploaded QM file(s): read the R.E.D.-II FAQ about how to perform this task. Do not hesitate to contact the authors of R.E.D. Server Development for reporting this problem if this problem lasts.


  -17- Is there any limitation in R.E.D. Server Development and why?  

      R.E.D. Server Development has been developed to generate empirical force fields for small molecules and/or molecular fragments. It is not designed to run computation on large molecular systems such as a polypeptide, a polynucleotide or a polysaccharide. Consequently, the maximum number of atoms for a molecule/conformation in an input file is set to 225 atoms. However, this does not mean R.E.D. Server Development cannot be used to generate a force field for a larger molecular system. In the later case a user only needs to split her/his "big" molecule/polymer into elementary building blocks with fully defined conformation(s) and use specific constraints during the charge fitting step to reconstruct the initial/big molecule. See the Tutorials related to the q4md-forcefield tools for more information.

      The maximum time (wall time) used by the queuing system for a R.E.D. Server Developement job is set to three weeks (or 21 days * 8 cores = 168 core days; see FAQ 1 and FAQ 8 for more information).

      A maximum of three or nine jobs per private or public account are allowed on R.E.D. Server Development, respectively (see FAQ 8 for more information). However, the queuing system of R.E.D. Server Development will be adapted if it gets saturated (i. e. more or less computational nodes/jobs per account will be made available).

      The maximum size of the upload archive file is set to 90 MB (see FAQ 6).

      Data generated by users are conserved five (public account) or twenty days (private account) on the R.E.D. Server Developement hard drives (see FAQ 11).

      A user can contact the q4md-forcefieldtools team at contact_at_q4md-forcefieldtools.org to request to postpone one of these limits.


  -18- How to generate a standalone graphical interface to parse R.E.D. Server Development outputs?  

      For any job generated by R.E.D. Server Development, a user can generate a Jmol based graphical interface to parse R.E.D. Server Development outputs. In this case, download the following csh scrit here, read the header of the script to understand how to use it and execute it using "csh Web-Interface.csh PXXX"


  -19- How to construct a PDB input file for R.E.D. Server Development using Jmol?  

      Jmol based java applets have been developed allowing any user building PDB input files for R.E.D. Server Development. Six templates are available for building any type of nucleosides, amino acids, monosaccharides, inorganic complexes and organic or heterocyclic molecules. To be able to use this feature, a user has to install the J2SE Runtime Environment (JRE) on her/his front-end worstation (see the help about configuring Java on Lunix).

      The PyRED program cannot yet add missing hydrogens to a structure, and these hydrogen atoms are required in quantum chemistry computation. However, one can use the Jmol based graphical interface to perform this task (i) open one the Java applets provided above and create your structure, (ii) if some hydrogen atoms are missing in your construction open the Jmol console (right-click and select "Console"), (iii) add the missing hydrogens [write in the console: "calculate hydrogens"; for more information about this command click here; in the case of a bad topology remove/add the additional/missing hydrogens/connectivities using the Jmol Model kit (right-click and select "Computation/Model kit")], and (iv) save the new set of Cartesian coordinates in the PDB file format (write in the console: "write coord PDB"; for more information about this command click here). This new PDB file can now be used as input for a PyRED job.


  -20- How to exchange data between users using R.E.D. Server Development?  

      For each R.E.D. Server Development job a specific web address is created allowing users to download/directly access the data generated. When using the public account these web links can be exchanged between users to study and compare data. On the contrary, we strongly discourage users to exchange web links generated for their private account since a private password has been generated for this account.


  -21- How and when to contact the authors of R.E.D. Server Development?

      -21.1- Ask your questions about the PyRED program and R.E.D. Server Development in the help services available at the q4md-forcefieldtools web site (see FAQ 5 for more information).

      -21.2- If you find a bug, if you have a request or if you need a new feature to be implemented in R.E.D. Server Development, contact the q4md-forcefieldtools team. We will always try to help.


  -22- How to cite R.E.D. Server Development?  

E. Vanquelef, S. Simon, G. Marquant, E. Garcia, G. Klimerak, J. C. Delepine, P. Cieplak & F.-Y. Dupradeau, R.E.D. Server: a web service for deriving RESP and ESP charges and building force field libraries for new molecules and molecular fragments, Nucl. Acids Res. (Web server issue), 2011, 39, W511-W517.

See here.


Valid XHTML 1.0 StrictCSS Valide !

Last update of this web page: April 1st, 2018.

Université de Picardie Jules Verne. Sanford Burnham Prebys Medical Discovery Institute.
© 2009-2018. All rights reserved.