Documente Academic
Documente Profesional
Documente Cultură
Copyright 2001, 2014, Oracle and/or its affiliates. All rights reserved.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their
respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used
under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD
logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a
registered trademark of The Open Group.
This software and related documentation are provided under a license agreement containing restrictions on use and
disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement
or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute,
exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or
decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you
find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf
of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any
programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are
"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific
supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs,
including any operating system, integrated software, any programs installed on the hardware, and/or
documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights
are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not
developed or intended for use in any inherently dangerous applications, including applications that may create a risk
of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to
take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and
its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous
applications.
This software or hardware and documentation may provide access to or information on content, products, and
services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all
warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its
affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party
content, products, or services.
Author
Dean Hillman, Prakash Pulla
This book was published using:
Oracle Tutor
Table of Contents
Oracle iLearning Installation Guide - Release 6.1 .........................................................................................1-1
Oracle iLearning Installation Guide - Release 6.1 ..........................................................................................1-3
Overview of Oracle iLearning 6.1 Release .................................................................................................1-4
Oracle iLearning 6.1 Release Information ..................................................................................................1-8
Upgrade to Oracle iLearning Release 6.1 from Release 6.0 ......................................................................1-12
New Installation of iLearning 6.1 ................................................................................................................1-16
Oracle iLearning Content Server and Oracle CMI Adapter ........................................................................1-29
Scheduling and Running Batch Jobs .........................................................................................................1-38
Troubleshooting Oracle iLearning 6.1 ........................................................................................................1-39
The Learning Path section is removed from the Overview page to make the Overview
page easier to navigate and also to have a more consistent functionality.
The two columns "Start Date" and "Enrolled" on the Learner Home page are now
combined into one called Start Date. For synchronous online and offline (classes and
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
web conference), iLearning displays the offering Start Date and for asynchronous
online and offline (e-learning and self-study), iLearning displays the Enrollments Date.
Note that the Start Date column is available in the PC version of iLearning and not the
simpler version on mobile devices.
New icons are added to the left of the headings on the different pages under the Home
tab.
Select the number of items to view on Learner Pages:
Learners can now select how many items are shown on the different pages under the
Home tab (except the History page). This feature is available in both the mobile device
and PC versions of iLearning.
New "Resume Last" button:
Learners can click the new Resume Last button on the Overview page, which will
take learners to the last course that they played in the Player. If the content provides
the necessary information, then iLearning displays the exact location in the chapter that
learners had left earlier. If this information is not provided by the content, then learners
are taken to the beginning of the chapter that they had left. This functionality is
available both in the full and the simple interface of iLearning.
Transcript sub tab moved and renamed:
The Transcript sub menu available from the Profile tab is now moved to the Home tab
and renamed to History.
Removed line and hyperlinks from the bottom of the Learner pages:
From this release, iLearning will no longer display the lines and hyperlinks on the very
bottom of all the Learner pages.
Back button added on Learner pages:
In this release, a Back button is added to the following Learner pages:
Learning Path detail page
Integrated Learning detail page
Software certification
Release notes
Available languages
Oracle Enterprise Edition RDBMS Release 11.2, with the following configuration
options:
Oracle Intermedia
UTF-8 Database character set
IE 9, IE 10
Firefox 17.0.1
Safari 5.0.5. Safari 5.1.7 is certified for all features except the Chat applet.
The iLearning Chat client requires the latest version of the 1.6 or 1.7 Java plug-in.
Note: For the latest certification information and patch sets, please visit My Oracle Support
(formerly MetaLink).
Release Notes
The following information pertains to the release of Oracle iLearning:
If you plan to configure multiple Oracle iLearning middle tier application servers, an
Oracle Application Server 10gR3 cluster configuration using Oracle AS infrastructure is
optional. If an Oracle Application Server cluster using Application Server Infrastructure
is used, then the cluster of oc4j instances must be set up prior to an Oracle iLearning
installation. Detailed configuration for this setup is beyond the scope of this document.
Please refer to the Oracle Application Server 10gR3 documentation for creating and
managing an AS cluster.
If you have problems with your installation, please refer to the Troubleshooting section.
When installing Oracle Application Server 10gR3, you should consider the following
The operating system username used to install Oracle Application Server 10gR3
must be the same username used to install Oracle iLearning.
If Web Cache is installed, make sure all URLs starting with /ilearn are exempted
from caching. Oracle iLearning application pages are personalized for individual
users and should not be cached.
Oracle iLearning uses dynamic jsp pages to display relevant information to the logged
in user. Oracle has made every effort to prevent caching, but it is recommended that
proxy server caching of Oracle iLearning pages be disabled (if applicable) to ensure
data between user sessions does not get mixed.
Oracle recommends installing Oracle Portal on a separate machine, not on an Oracle
iLearning middle tier application server. Otherwise, you may encounter conflicts
between Portal and Oracle iLearning common files.
When using an Oracle11g database:
If the middle tier application servers are unable to communicate with the database,
you may need to update the JDBC driver on all Oracle iLearning middle tier
application servers. Oracle iLearning uses the database drivers located under
<AS_HOME>.
After a successful installation and configuration of Oracle iLearning, you should be able
to access the application using a browser by performing the following steps:
Enter into your browser the URL that you chose as the Oracle iLearning Website
Address during the Oracle iLearning installation.
For example, http://ilearning.mycompany.com:7777
The default login page for Oracle iLearning will be displayed. Log in to Oracle
iLearning as the Root Site super administrator:
Username: system
Password: manager
Site: Root Site
Note: The site field in the login page will show up only if you have more than one site.
The values for Username and Password are case-sensitive, but the value for Site is
not.
Please refer to the Available Language Translations section below to review the
different language translations available for Oracle iLearning
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
ORACLE_HOME refers to the location of the Oracle Home where Oracle iLearning will
be installed
AS_HOME refers to the location where the Oracle Application Server is already
installed
There is only one role configured during the installation, called SuperUser, unless the
Oracle iLearning Demo Site is installed
All Oracle iLearning middle tier installations should be performed on a dedicated server
(not shared with other applications)
You must create a new Oracle database specifically for an Oracle iLearning database
installation. Do not use a database that is currently being shared with other
applications
In Oracle iLearning installations where multi-byte languages are used, you will require
additional fonts. These are located on the Oracle iLearning CD under the Support
directory. Copy all .ttf files in this directory to the
<AS_HOME>/jdk/jre/lib/fonts directory on all middle tier application servers. If
these fonts are not installed, buttons in multi-byte languages such as Traditional
Chinese, Korean, and Japanese will not appear correctly.
Language Code
Brazilian Portuguese
pt_br
Chinese (Simplified)
zh_tw
Chinese (Traditional)
zh_cn
Czech
cs
Danish
da
Dutch
nl
English
en
Finnish
fi
French
fr
German
de
Hungarian
hu
Italian
it
Japanese
ja
Korean
ko
Norwegian
no
Polish
pl
Spanish
es
Swedish
sv
Turkish
tr
There are no configuration steps required to make these languages available to users. Based
on the users' language settings in their browser, the corresponding language in Oracle
iLearning will be displayed.
Changing the Oracle iLearning Schema Password
You can change the passwords for the Oracle iLearning Schema Name and Oracle iLearning
Schema Report Name at any time. For example, you might require passwords to be changed
every three months for security reasons.
Optional: If Oracle Portal is configured for Oracle iLearning, modify the entry for the
Oracle iLearning Schema Name in the data-sources.xml file (located in the
<AS_HOME>/j2ee/oil/config directory)
Restart the Oracle Application Server on all middle tiers for these changes to take
effect. For more information on starting and stopping this server, refer to the Oracle
Application Server 10gR3 documentation.
Make sure that the upgrade has completed successfully before attempting to upgrade
the production environment.
You may want to document all the prerequisites like total time required to upgrade,
resource requirements, and other technical issues specific to your environment/site.
This information will help you to fine tune the resource requirements and minimize the
down-time of your production server during the upgrade process.
Perform Pre-Upgrade Steps
1. Shut down the Oracle iLearning middle tier servers and database.
2. Take a full backup of:
Entire existing Oracle iLearning installation including the database and all the middler
tier servers before starting the upgrade process.
Any customized JSPs. These files may get overwritten when the patch is installed.
The backup should be taken in such a way that you should be able to restore it in case the
Oracle iLearning 6.1 upgrade process fails. Once the database portion of the patch has been
applied or has failed, it cannot be reverted.
Prepare to Upgrade to Oracle iLearning 6.1
Before applying this patch, please make sure the iAS 10.1.3 web server is shutdown:
3. Unzip the file iLearning 6.1 installation zip file (OIL_17325195.zip). Note the directory
where the installation file was unzipped.
4. Verify database base backups are taken.
Perform the Middle Tier Application Upgrade
Note: You must complete the following steps on each Oracle iLearning middle tier application
server.
Back up the 6.0 Release Files
5. Backup the following directories:
<IAS_HOME>/j2ee/oil/applications/ilearning/ilearn/en
<IAS_HOME>/j2ee/oil/applications/ilearning/ilearn/lmsapi
<IAS_HOME>/j2ee/oil/applications/ilearning/ilearn/WEBINF/lib/classes
6. Backup the following files if they exist:
<IAS_HOME>/j2ee/oil/applications/ilearning/ilearn/lms6.0.0.0.jar
<IAS_HOME>/j2ee/oil/applications/ilearning/ilearn/lms6.0.0.1.jar
<IAS_HOME>/j2ee/oil/applications/ilearning/ilearn/lms6.0.0.2.jar
<IAS_HOME>/j2ee/oil/applications/ilearning/ilearn/WEBINF/lib/css.jar
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
11. Run the script that creates tables and indexes for new 6.1 features.
Start sql*plus from the "OIL_17325195/Software/upgrade_from_6.0/sql" directory as the
ilearn database user and run ilearn.sql.
Provide the reporting schema user and ilearn schema index tablespace as parameters.
SQL> @ilearn.sql ilearnrpt ilearn_index
Check the ilearn_upgrade_61.out file for errors. You may see object already exist errors if
you've previously installed 6.0 patches.
12. Run the custom reporting upgrade script.
Start sql*plus from the "OIL_17325195/Software/upgrade_from_6.0/sql" directory as the
ilearn_rpt database user and run ilearn_rpt.sql.
Provide the ilearn schema user as a parameter.
SQL> @ilearn_rpt.sql ilearn
Apply the Content Server Patch
This patch contains a new CMI Adapter and a Javascript Player Adapter that was originally
introduced in the 6.0 patch 14075342 - Javascript Player. You should skip steps 14, 15 and 16 if
you already installed the 6.0 patch.
The new Javascript CMI Adapter uses a JSP to communicate back to iLearning. In order to use
the new Javascript CMI adapter, the content server must be an Application Server that supports
JSPs.
On each content server,
13. Copy or FTP the whole OIL_17325195/Software/content_server/lmsapi directory to the
content server under a directory that supports JSPs.
(ie. <IAS_HOME>/j2ee/oil/applications/ilearning/ilearn
or <IAS_HOME>/j2ee/home/default-web-app).
This new directory should be accessible by a web browser. Make a note of the URL. You
will need it when creating a CMI Adapter in the iLearning Admin pages.
14. Back up the following file in the Oracle_CMI_Adapter directory:
Oracle_CMI_Adapter/version.js
15. Copy or FTP the files in OIL_17325195/Software/content_server/Oracle_CMI_Adapter to
the Oracle_CMI_Adapter directory on the content server, overwriting the existing files.
Perform iLearning System Admin Configuration
The CMI Adapters defined in the iLearning Admin Pages determine whether the content on the
content server will use the new Javascript or the old applet player. They are currently
configured to use the iLearning Player Java applet.
Skip this step if you already installed the 6.0 Javascript Player patch.
For each site,
16. Edit the CMI Adapters from the Site -> More... menu. Change the CMI Adapter Path to
point to the new lmsapi directory copied to the content server.
ie, change
http://ilearning.mycompany.com/ilearn/content_server/Oracle_CMI_Ada
pter/
to
http://ilearning.mycompany.com/ilearn/lmsapi/ or
http://ilearning.mycompany.com/j2ee/lmsapi/
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
5.
6.
7.
8.
Select the ilearning applications check box and press the Deploy button.
9.
Provide the location of the ilearning.ear file unzipped from the installation directory
(OIL_17325195) and press the next button.
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
10. Leave all fields unchanged and press the Next button.
for example
<native-data-source user="ilearn" password="welcome"
url="jdbc:oracle:thin:@//myhost.oracle.com:1521/ORCL"
data-source-class="oracle.jdbc.pool.OracleDataSource"
jndi-name="jdbc/PortalConnection" name="PortalConnection"/>
13. Edit <AS_HOME>/j2ee/oil/config/server.xml. Replace the following lines in two places.
Change:
<code-source path="<AS_HOME>/ord/jlib/ordim.jar"/>
<code-source path="<AS_HOME>/ord/jlib/ordhttp.jar"/>
To:
<code-source path="../applications/ilearning/ilearn/WEBINF/lib/iAS/ordim.jar"/>
<code-source path="../applications/ilearning/ilearn/WEBINF/lib/iAS/ordhttp.jar"/>
Note:
<AS_HOME> may either be a physical or relative path to the ORACLE_HOME for iAS.
When you copy and paste from Adobe Acrobat Reader, sometimes the '-' character is
lost. The pasted value ends up as WEBINF instead of WEB-INF.
14. Edit <AS_HOME>/j2ee/oil/config/application.xml. Add the following lines right under
<library path="../../home/lib/scheduler.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/classes"/>
<library path="../../../lib/xmlparserv2.jar"/>
<library
path="../../home/applications/datatags/webapp/WEBINF/lib/bc4jhtml.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/SNZ9RHRB.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/capsapi.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/datatags.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/ifsadk.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/ifsemail.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/ifsrelease.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/ifsrepos.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/ifsutils.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/jdev-rt.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/opnTools.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/pwdhash.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/ucm.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/ucmClientCookies.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/wfapi.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/wflov.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/wfmon.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/css.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/xerces.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/ilearning.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/bc4juixtags.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/iAS/ordhttp.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/iAS/ordim.jar"/>
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
<library path="../applications/ilearning/ilearn/WEBINF/lib/portal/10.1.3/pdkjava.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/portal/10.1.3/pdkstruts.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/portal/10.1.3/ptlshare.jar"/>
<library path="../../home/jazn.jar"/>
<library path="../../home/jazncore.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/portal/10.1.3/oracle-portlet-tags.jar"/>
<library path="../../../datadirect/sun/lib/jndi.jar"/>
<library path="../applications/ilearning/ilearn/WEBINF/lib/iAS/uix2.jar"/>
<library path="../../../jdbc/lib/ojdbc14dms.jar"/>
<library path="../../../jdbc/lib/orai18n.jar"/>
<library path="../../../jdbc/lib/orcs12.jar"/>
<library path="../../../diagnostics/lib/ojdl.jar"/>
<library path="../../../lib/dms.jar"/>
-Djbo.viewlink.consistent=false
-Djbo.server.in_oc4j=false
XX:MaxPermSize=128m
-Djbo.pers.max.active.nodes=-1
-Dilearning.home=<AS_HOME>/j2ee/oil/applications/ilearning/ilearn
-Djbo.debugoutput=SILENT
-Dfile.encoding=UTF-8
-Djbo.initpoolsize=2
-Djbo.poolminavailablesize=2
-Djbo.poolmaxavailablesize=200
-Djbo.poolmaxinactiveage=30000
-Djbo.poolmonitorsleepinterval=30000
-Djavax.net.ssl.truststore=<AS_HOME>/jdk/jre/lib/security/cacerts
b. Change 4 occurrences of -Dhttp.webdir.enable=false to Dhttp.webdir.enable=true.
16. Edit <AS_HOME>/j2ee/oil/application-deployments/ilearning/ilearn/orion-web.xml. Add
include-war-manifest-class-path="true" to <web-app-class-loader.
<web-app-class-loader search-local-classes-first="true"
include-war-manifest-class-path="true" />
Configure Oracle iLearning
17. Install the UIX 2.3.6.5 installables. UIX 2.3.6.5 is shipped with iLearning 6.1.
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
Unzip
<AS_HOME>/j2ee/oil/applications/ilearning/ilearn/WEB-INF/lib/iAS/uix2-install.zip
into
<AS_HOME>/j2ee/oil/applications/ilearning/ilearn.
This should create a cabo directory. When you unzip the UIX files, you will be prompted
that a file already exists. Choose n (no) to replace the existing file.
18. For a new install, back up the ilearning.properties file in
<AS_HOME>/j2ee/oil/applications/ilearning/ilearn/WEB-INF.
Edit the ilearning.properties file
19. Edit the following properties in the ilearning.properties file.
Hosting Companys Domain
The domain specifies the network domain where all middle tier servers and your web site
are located. If you are running Oracle iLearning internally, your company network domain
should suffice. If you are hosting Oracle iLearning through an ISP, you may need to obtain
this value from your network administrator. All middle tier application servers should have
the same value.
HOST=http://localhost
DOMAIN=.oracle.com
Outgoing SMTP Mail Server Name
Oracle iLearning uses mail servers for email notifications. To enable these features, you
need to provide the address of your company's SMTP mail server. All middle tier
application servers should have the same value.
MAIL_HOST=mail.host.com
Administrator Email Address
Email notifications generated by Oracle iLearning are sent by default from the administrator
email address entered during installation. A valid email address is required. Administrators
of Oracle iLearning sites can override this value in the administrative user interface. All
middle tier application servers should have the same value.
ADMIN_EMAIL=nobody@oracle.com
CONTENT EXPORT/IMPORT SETUP
Recommendation: Change only ftpuser and ftpgroup to correct values.
Default setting: listed below, defaults for ftpuser and ftpgroup must be changed.
Required properties for iLearning export and content servers functionality.
Requires a ftp server running with any correct user and password settings to
transfer files
ftpuser
ftppassword
ftpuser and ftppassword
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
This is an FTP user that should be set up on the FTP Server on your content server
machine. This user should have permissions on the content server directory to transfer
content using FTP. The default values during installation are:
FTP User: ftpuser
FTP Password: ftpuserpassword
For example, if a UNIX ftp user called ilearnftp was created on the content server machine
with password ilearn_transfer, the following values could be used:
ftpuser=ilearnftp
ftppassword=ilearn_transfer
Note: The ftpuser and password must be the same on all middle tiers and content servers.
Log Path
Directory for logging error messages during import and other operations
LOG_PATH=d:/apacheg/apache/logs
imsdtd=http://localhost:port/ilearn/en/admin/dtd/content.dtd
classroom_dtd=http://localhost:port/ilearn/en/admin/dtd/classroo
m.dtd
performance_dtd=http://localhost:port/ilearn/en/admin/dtd/perfor
mance.dtd
Oracle iLearning Protocol
Oracle iLearning supports the delivery of application pages using either the HTTP or
HTTPS protocol. Select the available protocol on your Oracle iLearning application.
Alternatively, select Use Both HTTP and HTTPS if you want to enable the Oracle
iLearning site administrators to select the protocol to be used for each site.
Encryption Key
Enter an encryption key which will be to generate a security key for encryption. The key
should be an integer. This same value should be used as the seed for all installations of
middle tiers sharing this instance of Oracle iLearning.
ENCRYPTION_KEY=1b8201bae87b574b1999c17e1eaccb4c840ff9bd82c547ff8
13b6ef1abc788f5
Note that when the ENCRYPTION_KEY is changed, you have to change the encrypted
passwords in the connect strings. The ENCRYPTION_KEY must be the same on all middle
tiers and content servers.
WF_MAIL_MODE
Email notifications are sent by iLearning. System administrator can use the
WF_MAIL_MODE property to configure whether a notification/approval request is sent
immediately, or queued and sent by the notification batch job. As email connections can be
slow, it is up to the customers whether they want the UI to wait for the email to be sent.
iLearning recommends that customers start out sending mail in batch mode. To send mail
in batch mode, you must schedule a batch job.
#***************************************************************
***************
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
Set up a secured content server to enable users to access content from within Oracle
iLearning.
Set up the Oracle CMI Adapter on content servers to facilitate communication between
SCORM compliant content and Oracle iLearning.
Please refer to the Oracle Application Server 10gR3 documentation for detailed
information on starting and stopping this service.
6. Stop the Oracle Application Server 10gR3 daemon on each content server machine and
every Oracle iLearning Middle Tier application server machine.
Please refer to the Oracle Application Server 10gR3 documentation for detailed
information on starting and stopping this server.
7. Create a physical directory on each content server machine where content will be stored.
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
8.
Note: This document only describes the setup of a content directory under the
<AS_HOME>/Apache/Apache/htdocs/ directory. For example:
<AS_HOME>/Apache/Apache/htdocs/ilearning/content_server
Copy the Gatekeeper module file from the
OIL_17325195/Software/content_server/gatekeeper directory into the
appropriate directory on each content server machine.
9.
The HOST and LISTEN port values must be the same in order for the Gatekeeper
module to function properly.
Windows Only: This line enables the Oracle Application Server 10gR3 to locate the
Gatekeeper module. This should go in the section labeled Dynamic Shared Object
(DSO) Support:
AddModule mod_auth_ila.c
Add an Alias for the Oracle Application Server 10gR3 of your physical directory to
locate the stored content. This should go in the section labeled Aliases under
IfModule mod_alias.c:
Alias /<virtual content directory>/
"<AS_HOME>/Apache/Apache/htdocs/<physical content directory>/"
Use the information below to help define the base directory where all content used by
Oracle iLearning will be stored:
Determine where the content will be stored.
Note: This document only describes the setup of a content directory under the
<AS_HOME>/Apache/Apache/htdocs/ directory. For example:
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
<AS_HOME>/Apache/Apache/htdocs/ilearning/content_server
Alternatively, you could establish UNIX soft links to any other directory from this
location.
Any name can be used for the <virtual content directory> directory.
The <virtual content directory> and <physical content
directory> values are required when setting up content servers within the
Oracle iLearning application
For example, to store content in the
<AS_HOME>/Apache/Apache/htdocs/ilearning/content_server/
directory, you would use the following:
Alias /content/
"/u01/app/ias/Apache/Apache/htdocs/ilearning/content_server
/"
Add the following lines to protect the secure directory to which Apache has access.
You must also create the physical directories that are specified here.
<Directory "<AS_HOME>/Apache/Apache/htdocs/<secure physical
directory>">
AuthType iLearning
require valid-user
iLearningAuth on
iLearningAuthKey <ENCRYPTION_KEY value from
ilearning.properties entry>
ErrorDocument 403 http://<Oracle iLearning Website
Address>
</Directory>
Use the information below to help configure this line:
This command protects all content under <secure physical directory>,
except streaming media audio files which must be exempted from the secured
location (.wma).
For example, to prevent unauthorized access to content under the
<AS_HOME>/Apache/Apache/htdocs/ilearning/content_server/sec
ure directory, you would specify the following
<Directory
"/u01/ias/Apache/Apache/htdocs/ilearning/content_server/sec
ure">
AuthType iLearning
require valid-user
iLearningAuth on
iLearningAuthKey
1b8201bae87b574b1999c17e1eaccb4c840ff9bd82c547ff813b6ef1abc
788f5
ErrorDocument 403 http://<Oracle iLearning Website
Address>
</Directory>
If your content server will also store Windows Media streaming (.wma) files, add
the following lines to ensure that gatekeeper does not prevent the player from
accessing these files. This line, if added, must be included in the <Directory>
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
Add the following lines to unprotect the public directory to which Apache has access:
<Directory "<AS_HOME>/Apache/Apache/htdocs/<unsecure physical
directory>">
AuthType iLearning
require valid-user
iLearningAuth off
ErrorDocument 403 http://<Oracle iLearning Website
Address>
</Directory>
Use the information below to help configure this line:
This command removes Gatekeeper protection from the <unsecure
physical directory> and all its subdirectories.
The FTP username must be the same operating system username used for
installing Oracle Application Server 10gR3 and Oracle iLearning. The same
operating system user should be used during the installation of both Oracle
Application Server 10gR3 and Oracle iLearning, regardless of whether they are
being installed in the same or different Oracle Homes.
The same username and password must be used when configuring the ftpuser
and ftppassword properties in the ilearning.properties file (Refer to the
Oracle iLearning configuration step 11).
The Upload Files feature in the Oracle iLearning administrative user interface can
only succeed if the owner of the Oracle Application Server 10gR3 files is used for
the ftpuser property when setting up the ilearning.properties file.
The FTP protocol is required only between Oracle iLearning application servers and
the content servers.
Oracle iLearning does not use the FTP protocol to upload files from the users
browser. The compressed ZIP files are transferred from the browser to the Oracle
iLearning application servers using the standard HTTP protocol and then are
transferred from the Oracle iLearning application server to the content server using
the FTP protocol.
For each alias created in your httpd.conf file (as per step 9)
Make sure all required physical directories have been created
Make sure the FTP user has full access to the base directory when all Oracle
iLearning content will be stored. For example, if the following directories were
created:
/u01/ias/Apache/Apache/htdocs/ilearning/content_server/secu
re
/u01/ias/Apache/Apache/htdocs/ilearning/content_server/publ
ic
Then, the FTP user should have full access on the
/u01/ias/Apache/Apache/htdocs/ilearning/content_server
directory.
From another machine, attempt to FTP to this machine using the username and
password you just created. If you are unsuccessful, stop and restart the FTP server
and try again.
Refer to your specific FTP server documentation for more information.
Note: Windows 2003 Server installations only:
There is a default FTP server created during the Windows 2003 Server installation.
You can either:
Disable the Windows 2003 FTP server (from the Internet Services Manager) and
install another FTP server
Configure the Windows 2003 FTP server. The following steps may assist your
configuration:
From Start Menu->Administrative Tools, launch Start Internet
Services Manager
Select the name of the machine in the tree and create a new FTP site using the
wizard. You need to define the following:
A new name for the FTP site
The IP address and port
The default home directory for the FTP site
Both Read and Write for the directory
Edit the properties for the FTP site. From the Security Accounts tab:
Select Allow Anonymous Connections
In the Username field, select a username. This must be the same user that
will be specified as the FTP user in the ilearning.properties file. You
will enter this in step 11.
Enter the password for the user. This must be the same password that has
will be specified as the FTP user in the ilearning.properties file. You
will enter this in step 11
Select the FTP server site you just created, and use the wizard to create a new
Virtual Directory. You need to define the following:
An alias that will be used to access the Oracle content server directory. This
must be the same virtual directory that was specified as the alias in the
httpd.conf file. For example, content
The physical content server location. This must be the same physical directory
that was specified as the alias in the httpd.conf file. For example,
c:\oracle\ias904\Apache\Apache\htdocs\content_server
Privileges for the FTP user, which should be both Read and Write for the
directory
Edit the properties for the windows directory that you specified as your physical
content server location.
Select the Security tab
Add the username that you created in the FTP server setup
11. Modify the file ilearning.properties file on all Oracle iLearning middle tier application
servers.
Note: This is not required on content server machines, unless they are also an Oracle
iLearning middle tier application server.
Edit this file to provide the correct values for the ftpuser and ftppassword. This
is an FTP user that should be set up on the FTP Server on your content server
machine. This user should have permissions on the content server directory to transfer
content using FTP. The default values during installation are:
FTP User: ftpuser
FTP Password: ftpuserpassword
For example, if a UNIX ftp user called ilearnftp was created on the content server
machine with password ilearn_transfer, the following values could be used:
ftpuser=ilearnftp
ftppassword=ilearn_transfer
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
If this is set to 3, a checkbox Use Secure FTP will be present on the content
server setup page.
Specify the ports for normal/secure FTP (there is no site property for this).
FTP_PORT Conventional FTP port (default 21)
12.
13.
14.
15.
16.
17.
This must be performed on the content server machine and all middle tier application
servers for the above changes to take effect.
Please refer to the Oracle Application Server 10gR3 documentation for detailed
information on updating the repository.
Stop the Oracle Application Server 10gR3 daemon on each content server machine and
every Oracle iLearning Middle Tier application server machine.
Please refer to the Oracle Application Server 10gR3 documentation for detailed
information on starting and stopping this server.
Start the Oracle Application Server 10gR3 daemon on each content server machine and
every Oracle iLearning Middle Tier application server machine.
Please refer to the Oracle Application Server 10gR3 documentation for detailed
information on starting and stopping this server.
Start the Oracle Enterprise Manager daemon on each content server machine and every
Oracle iLearning Middle Tier application server machine.
Please refer to the Oracle Application Server 10gR3 documentation for detailed
information on starting and stopping this service.
The content server is now set up.
All Oracle iLearning middle tiers can access this content server.
queued_notification - sends emails about enrollments and approvals. This job sends
the emails that are queued from using WF_MAIL_MODE=batch
Batch Jobs are in OIL_17325195/Software/batchjobs. They rely on an environment variable
AS_HOME.
You can run these two batch jobs for a specific site by using the -site parameter in the
command line. The default action is to run the job for all sites. If you want the job to run for all
sites, then do not specify the parameter.
%as_home%/jdk/bin/java -mx100M -ms64M Djbo.pers.max.active.nodes=-1 Dilearning.home=%as_home%/j2ee/oil/applications/ilearning/ilearn
oracle.ila.common.util.notif.model.QueuedNotificationJob -l
%LOG_DIR% -site "Root Site"
Resolution: This occurs if any middle tier cannot communicate with the database. This
may happen if the database is down; the database Oracle iLearning schema name or
password is different to values contained in the ilearning.properties
configuration file on the middle tier application servers; or the JDBC driver cannot
connect to the database due to network or database listener problems. Check the
schema name and password and attempt to connect to the Oracle iLearning schema
using SQL*Plus. Make the appropriate changes to the Oracle iLearning configuration
file or the database.
Issue: Is Oracle iLearning capable of load balancing and high availability?
Resolution: Oracle iLearning can load balance across application servers using the
OC4J cluster mechanism.
Issue: The default session time-outs in the Oracle iLearning installation are too short.
How can they be increased beyond 1 hour?
Resolution: Add the following timeout entries to the
<AS_HOME>/j2ee/oil/applications/ilearning/ilearn/WEB-INF/web.xml
file. These properties specify the length of time (in minutes) before idle browser
sessions are invalidated due to inactivity. The following syntax is used to set inactive
session time out value to 75 minutes:
<session-config>
<session-timeout>75</session-timeout>
</session-config>
Note: Please refer to your Oracle Application Server 10gR3 documentation for more
information.
The following parameter applies specifically to the Oracle iLearning player. This value
can be set from the ilearning.properties file located in the same directory:
PLAYER_TIMEOUT=7200000
Issue: When attempting to run reports in Oracle iLearning, I receive one or more of the
following errors
"Error checking out an application module from the reporting
pool"; or
JBO-29000: Unexpected exception caught: java.sql.SQLException,
msg=ORA-01031: insufficient privileges ORA-06512: at
"SYS.DBMS_SESSION",
line 58 ORA-06512: at "ILEARN_RPT.ILA_VPD", line 7 ORA-06512: at
line 1
Resolution:
The Oracle Context option may not be installed on your database server, or may not be
configured correctly. Check that the ILA_CONTEXT object exists in the sys or system
database schemas. If not, try creating this object using the following commands:
SQL> CONNECT SYSTEM/<password>@<connect string>
SQL> CREATE CONTEXT ila_context USING ILEARN_RPT.ila_vpd;
Check that there are no invalid objects in the CTXSYS schema by
SQL> SELECT OBJECT_NAME, STATUS FROM DBA_OBJECTS WHERE
STATUS='INVALID' AND OWNER='CTXSYS';
View the ilearning.properties file to ensure your reporting schema name and
passwords are correct and sufficient application modules are configured in the pool for
Oracle iLearning. The parameters to check are:
reporting.connectString=jdbc:oracle:thin:<ilearning rpt
schema>/<new ilearning rpt pwd>@<servername>:<port>:<sid>
reporting.initialsize=5
reporting.maximumsize=40
Retry a report execution.
You can only have one database schema that uses ILA_CONTEXT. If two ilearning
schemas exist in the database, this can cause reports to fail. Drop the previous
ILA_CONTEXT and use the install.sql in the
<ORACLE_HOME>ilearn/src/sql/adhoc/ directory to reinstall only the adhoc
reporting related parts pointing to your Oracle iLearning schema.
Issue: No content can be played from Oracle iLearning. A File Not Found error
message is received.
Resolution: Please make sure the host name and port number is defined correctly in
your ilearning.properties file. Also verify the LMS_URL and AICC_URL values
are correct.
Issue: Files cannot be successfully uploaded to an Oracle iLearning secured content
server.
Resolution:
Make sure that value of the directives DocumentRoot and Directory are set
correctly in the httpd.conf file.
There also needs to be an ftp server process running on the content server.
The username and password supplied in the ilearning.properties must
match a user created in the ftp server. This user also requires write permissions in
the directory specified in the httpd.conf file.
If a load balancer is in place, ensure the load balancer FTP Port is set up and
accepts FTP connections
Issue: When launching content on an Oracle iLearning Secured Server, the user
receives a HTTP 403 Permission Denied error
Resolution:
The following entries must match exactly:
httpd.conf ServerName
ilearning.properties HOST parameter of the content server
Host and Port setup of the content server all must match exactly
Verify the value of the oracle.ila.player.cookie in:
http://<yourwebsite>:<yourport>/ilearn/en/learner/shared/jsp/env.jsp
Issue: Installation completes, but a window is left open after installation.
Resolution: If the installation has completed successfully, you should be able to exit
the installer. The open window was created by the installer to start the Oracle
Enterprise Manager website. Do not close this window if you are planning on using
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
Possible Reasons:
Ensure the xml file being imported references the correct instance of Oracle
iLearning if a reference to Oracle iLearning is present. If the schema validation is
attempting to access another URL, it may be slow or hang completely.
Common Content Server Configuration Errors When Uploading Content
How does Content Upload Work?
When the user uploads content files using the Oracle iLearning administrative user interface,
the content file is transferred from the users machine to the Oracle iLearning middle tier server
in a physical directory determined by a designated content server.
The content file is uploaded in three steps:
First, the content file is placed in a temporary location $TEMP_DIR/TempImportExportDir/ImportFiles/ directory by the web server using http
protocol. The process renames the file to make it unique by suffixing additional characters.
Second, the file is transferred from the temporary location mentioned above to the content
server directory using the ftp protocol. After the file is transferred, it is removed from the
temporary location.
Third, if the content file is a zip file, the web server triggers a servlet process to unzip the file in
the same directory. If the uploaded file is an individual file, then it is renamed to its original
name. The zip file is removed from this directory after successful unzip.
What are most common issues encountered in configuring a content server?
(1) The content file is not transferred from the users machine to the middle tier server.
Error message:
"The content server is not running on <Virtual IP > on Port <port number>. No files were
uploaded to the content server."
(2) The middle tier server fails to transfer the file from the location as mentioned in the first step
above to the location mentioned in second step (i.e. content server location).
Error message:
"The FTP server is not running on the content server <Virtual IP > on Port <port number>. No
files were uploaded to the content server."
(3) The zip file have been uploaded into the appropriate directory in the content server but the
unzip process failed.
Error message:
"The FTP server is not running on the content server <Virtual IP > on Port <port number>. No
files were uploaded to the content server."
No error message is seen during upload, but the file is not viewable or playable. If you
physically inspect the content location directory, you find a zip file there instead of the regular
content files.
How to Fix Content Server Not Running issues?
The content server is not configured properly. Please follow the instructions as contained in
Oracle iLearning install guide to configure the content server.
How to Fix FTP Server Not Running issues?
Provide ftp access from the middle tier servers to the content server. If the middle tier servers
and the content server are on the same machine, the ilearning owner (the unix user) should be
able to ftp to localhost. This error message could also be thrown by the web server if the content
sever is not configured properly.
Copyright 2014, Oracle and/or its affiliates. All rights reserved.