CVRG Portal

Below you will find a list of technologies used by the CVRG to create both the portal and portlets. These technologies have all been deployed/tested in CentOS 5.2(RHEL) running in VMWare on Windows XP as the host OS:

Once the portal is installed and active, information regarding User and Permissions administration can be obtained here: http://wiki.cvrgrid.org/index.php/PortalAdministrationGuide-CVRG

CVRG Developer Workstation Hardware Requirements
We recommend the following minimum hardware configuration if you are a developer looking to extend the portal's functionality or to create portlets.

CVRG Server Hardware Requirements
We recommend the following minimum hardware configuration if you deploying the CVRG portal at your institution.

CVRG Portal Ant Build Script

build.xml Target Interaction Graph

• Orange boxes depict ant condition properties(tests that evaluate to true/false)
• Blue boxes are ant targets

CVRG Portal Ant Build Properties

The following properties will need to be updated in order to deploy the CVRG Portal on your system, not all the properties have been listed here only those that need to be updated by the end user/developer/administrator. We RECOMMEND deploying the CVRG portal on a Linux Environment.

Installing the CVRG Portal

1. Obtain host certificate and key certificate from a CVRG Certificate Authority (CA) Administrator (currently Stephen Granite CVRG CA Admin). Please include a the following in the email:
   1. subject line - "Request for Host Certificate"
   2. body
      1. Fully qualified domain name (FQDN) ex. (aHost.adomain.com)
      2. Your First Name:
      3. LastName:
      4. Organization:
      5. Project:
      6. Phone Number:
      7. Reason for requesting a host certificate:
2. From the CVRG CA Administrator's perspective, they will need to use the CVRG User Interface (UI) to generate the requested certificates: Creating a CVRG Host Certificate
   1. Go to the CVRG UI folder (e.g. /home/sgranite/Desktop/Software/CVRG_Dev_SoftwareStack/applications/cvrg-ui) and type "ant ui".
   2. Once the interface comes up properly, click the "Login" button.
   3. Enter your CVRG username and password and click the "Authenticate" button.
   4. If the username exists and the password entered is correct, the "Proxy Manager" window will appear.
   5. Click the "Set Default" button.
   6. Click "OK" on the prompt screen that appears and then close the "Proxy Manager" window.
   7. Under the "My Account" Menu, select "Request Host Certificate" item.
   8. In the "Request Host Certificate" window that appears, replace the "Host" entry with the FQDN in the e-mail.
   9. Click the "Request Certificate" button.
   10. By default, the host and the key will save in the .cagrid/certificates directory (e.g. /home/sgranite/.cagrid/certificates). E-mail both of these files to the requester and store the files in a secure location.
3. You will need to place the certificates into your /home/userDir/.globus/certificates directory (you may need to create this directory), this includes the CVRG Root Trust Certificate, and both the host and host key certificate. The CVRG administrators will need to add your host to the CVRG WebSSO server.
4. Check out the CVRG Portal using SVN from the following location https://project.bmi.ohio-state.edu/svn/cvrg/trunk/dev/portal/cvrgPortal-1.1
5. Install Globus (Media:Ws-core-4.0.3.zip). Unpack the zip into a location of your choice. This location will be configured into the build.properties file. If you are using the CVRG Development Image, globus is already installed.
6. Create mysql user for the portal DB admin, unless it already exists. Instructions to create a mysql user can be found here: Adding a mysql user account.
7. Update properties file (cvrgPortal-1.1/build.properties)
   1. All properties shown directly above need to be updated in the cvrgPortal-1.1 project that you just checked out from SVN.
8. Verify that your group for your local user has full access to the ${tomcat.liferay.bundle.root.dir} (as shown above in the build.properties settings) directory. If not, run sudo chmod -R 775 ${tomcat.liferay.bundle.root.dir} (e.g. /opt).
9. Open a terminal window and change your working directory to the location where you checked out the CVRG source code.
   1. [type] sudo ant installCaCerts - hit enter at the end (the 1 is assumed)
   2. [type] ant createTomcatPortalKeystore
      1. All values needed for the application have been printed to the console window in order. Just copy and paste them at each prompt. They are derived from the values that you set in the build.properties file above.
      2. At last prompt, hit enter (no password is necessary for the private key).
   3. [type] ant all - Deploys the CVRG portal to the location of the directory chosen in the property file.
   4. Verify that ${CATALINA_HOME} is set to ${tomcat.liferay.bundle.root.dir}/tomcat-cvrgportal. If not, edit your .bash_profile.
      1. gedit (or vi) /home/userDir/.bash_profile.
      2. Restart the system.
   5. Once installed type ant startTomcat to start the CVRG Tomcat container.
10. To access the your portal, go to your fully qualified domain name(aHost.adomain.com):8443/web/guest/home
    1. Example: https://myPortalRocks.mydomain.com:8443/web/guest/home
11. To add the CVRG logo add the Enterprise Admin portlet to the page
    1. Click the ">> Tab" -> "Settings Tab" -> Under the Display tab and Just Under the default liferay logo click the change link -> Browse for your Logo -> Click Save
12. To add a favicon drop your own icon with the same name as the Liferay icon, your icon will appear as the bookmark/favorites icon instead of the Liferay icon. (See below)

CVRG LOGO
${cvrgPortal-1.1/WebContent/images/CVRG_logo_final.png

CVRG Favicon
${cvrgPortal-1.1/WebContent/images/liferay.ico

Where to place favicon
/Your_Theme/html/themes/example/images/liferay.ico 
(eg. /opt/tomcat-cvrgportal/webapps/ROOT/html/themes/classic/images if you are using the classic theme which is the default.