|
Oracle® Collaboration Suite Certified Configuration Deployment and Cloning Guide
Release 9.0.4.1 for Linux x86 Part No. B12145-01 |
|
|
|
|
This chapter describes post-configuration steps for an Oracle Collaboration Suite Certified Configuration (Oracle Collaboration Suite CC). You must complete the following post-configuration tasks corresponding to your deployment.
This chapter contains the following sections:
Post-Configuration Steps for Deployments From the Gold Image
Post-Configuration Steps for Deployments From the Product CD-ROMs
Complete the following post-configuration tasks for all deployments from the gold image.
Apply patch ARU 4797874 for bug number 3143044 on the database-tier Calendar Server Oracle home and the middle-tier Calendar Web client Oracle home. On the middle-tier Calendar Web client Oracle home, do not run the uniclean and unistart commands as documented.
Use the following to perform post-configuration for Files.
You must modify the following credential managers for Files: SmallServiceConfiguration, MediumServiceConfiguration, and LargeServiceConfiguration. This procedure enables Files to connect to OID to retrieve authentication information.
Each time you run Oracle9iFS Credential Manager Configuration Assistant (ifscmca), you can only modify one existing Credential Manager. Use the following steps to run ifscmca. Run ifscmca three times, once for each credential manager.
As the owner of the middle-tier Oracle home, run the Oracle9iFS Credential Manager Configuration Assistant. ($ORACLE_HOME/ifs/files/bin/ifscmca.)
The Welcome window opens.
Click Next.
The Login to Oracle9iFS window opens.
Enter the iFS schema name (ifssys) schema password, Files Infostore database host name, listener port number, and the database service name (TNS alias). Then, click Next.
The Existing Credential Managers window opens, listing the following existing Credential Managers: SmallServiceConfiguration, MediumServiceConfiguration, and LargeServiceConfiguration.
Select the entry OiD under the Credential Manager you want to modify, click Modify, then click Next.
The OiD Login window opens.
Ensure that the OiD host name, port number, and password entries are correct. Then, click Next.
The wizard connects before going on to the next screen to ensure that the information you entered is valid.
The Supported Functions window opens.
Click Next.
The Authentication Types window opens.
Click Next.
The Oracle9iFS Specific Passwords window opens.
Click Next.
The Subscribers window opens.
Click Next.
The Summary window opens.
Click Configure.
The configuration begins. A task completion window opens to inform you when the configuration is complete.
Repeat this procedure until all three Credential Managers are configured.
If Files is running, stop the OC4J_iFS_files processes. As the owner of the Oracle home, run the following command:
$ $ORACLE_HOME/dcm/bin/dcmctl stop -co OC4J_iFS_files
Start the OC4J_iFS_files processes as the owner of the Oracle home by running the following command:
$ $ORACLE_HOME/dcm/bin/dcmctl start -co OC4J_iFS_files
The site_admin user password for Files can be modified by going through the Files admin login interface. The default password for this user from a gold image installation is welcome1.
Use the following to change the administrative user for Files:
Start the Files processes. (You must do this before you can log into the admin login interface.)
Using EM, start up the OC4J_iFS_files component and the Files local domain components.
Connect to http://<hostname.domain>:7778/files/app/AdminLogin and log in as site_admin/<current_pwd>.
Click the Preferences link on the top right corner of the browser.
Click the Password link on the left side of the browser.
Enter the old password, new password, and confirm the new password. Then click Apply.
You have changed the site_admin user password for the site.
Perform the following post-configuration steps for Infostore databases:
Run SQL*Plus against the Email or Real-Time Collaboration Infostores, and log in as the system user, using the password that you selected during configuration.
$ sqlplus system/<password>
SQL> select job, schema_user, broken from dba_jobs;
JOB SCHEMA_USER B
---------- ------------------------------ -
4 RTC_APP N
2 RTC_APP N
3 RTC_APP N
5 IFSSYS N
6 IFSSYS N
7 OWF_MGR N
8 OWF_MGR N
SQL> exit;
In the Email Infostore, you can set the jobs owned by IFSSYS, OWF_MGR and RTC_APP to ÒbrokenÓ. In the Real-Time Collaboration Infostore, only set the jobs owned by IFSSYS and OWF_MGR to ÒbrokenÓ.Log in to the Infostore as the schema user of these jobs to disable the jobs. For example, the preceding table shows that the IFSSYS user owns job id 5 and 6.
$ sqlplus IFSSYS/welcome1 SQL> exec dbms_job.broken(JOB_ID, true); e.g. SQL> exec dbms_job.broken(5, true); SQL> exec dbms_job.broken(6, true); SQL> exit; $ sqlplus OWF_MGR/<sys user password> SQL> exec dbms_job.broken(JOB_ID, true); e.g. SQL> exec dbms_job.broken(7, true); SQL> exec dbms_job.broken(8, true); SQL> exit; $ sqlplus RTC_APP/welcome1 SQL> exec dbms_job.broken(JOB_ID, true); e.g. SQL> exec dbms_job.broken(4, true); SQL> exec dbms_job.broken(2, true); SQL> exec dbms_job.broken(3, true); SQL> exit;
After you have disabled all the unnecessary jobs, verify that the jobs are disabled by logging in as the system user. The following table is an example of the output from running the following command:
$ sqlplus system/<password>
SQL> select job, schema_user, broken from dba_jobs;
JOB SCHEMA_USER B
---------- ------------------------------ -
4 RTC_APP Y
2 RTC_APP Y
3 RTC_APP Y
5 IFSSYS Y
6 IFSSYS Y
7 OWF_MGR Y
8 OWF_MGR Y
SQL> exit;
Use the corresponding instructions depending on your deployment type.
Use the following to refresh the ONS configuration for a two-tier deployment:
In the Infrastructure database Oracle home on the database-tier, update the ias.properties file in the $ORACLE_HOME/config directory with the proper host name values for the following entries:
SSOhost
OIDhost
Run the following command in the Infrastructure database Oracle home on the database-tier system. This command updates the $ORACLE_HOME/opmn/conf/ons.conf file with the IP addresses of the database-tier and middle-tier systems.
$ $ORACLE_HOME/dcm/bin/dcmctl listinstances
Verify that the ons.conf file contains the IP addresses of the database-tier and middle-tier systems only.
Run the following command in the Calendar Server Oracle home on the database-tier system. This command updates the $ORACLE_HOME/opmn/conf/ons.conf file with the IP addresses of the database-tier and middle-tier systems only.
$ $ORACLE_HOME/dcm/bin/dcmctl listinstances
Verify that the ons.conf file contains the IP addresses of the database-tier and middle-tier systems only.
You must now stop and start services in all Oracle homes. See "Starting and Stopping Oracle Collaboration Suite Components" for details.
Use the following to create a subscriber administrator for Files:
As the root user, start Files using ifsctl.
Run the following command to start the OC4J component:
# dcmctl start -co OC4J_ifs_files
Go to the following URL:
http://<hostname.domain>:7778/files/app/AdminLogin
Log in as the site_admin user.
Click on New Subscriber, then click Next.
Enter the subscriber quota (at least 2 GB), maximum number of users and the subscriber expiration date.
Enter cst_admin as the user ID. The E-mail address should be cst_admin@<your email domain>.
Enter the number of days before a user is disabled, and the user quota (depending on the customer contract.)
Select the appropriate value for Display Language.
Select the Default Document Properties that you want:
For example:
Default Document Language: English Default Document Character Set: Western (ISO-8859-1)
Set the Workspace Quota.
Review the settings and click Finish to create the subscriber administrator user.
The cst_admin user should then receive an email at http://<midtier-host>:7778/um/traffic_cop containing a password. The cst_admin user can log in to http://<midtier-host>:7778/files/app/AdminLogin as cst_admin/<received password to perform administrative tasks.
If you used the gold image to deploy your Oracle Collaboration Suite CC, then use the following to remove old partner applications on the system. This fix is not required for the deployments installed and configured from the Product CD-ROMs.
Log into the Single Sign On (SSO) Server at:
http://<hostname:<port/pls/orasso
Click SSO Server Administration.
Click Administer Partner Applications.
In the Edit/Delete Partner Application section, delete the following old partner applications:
Oracle Portal (portal) cgoldc_ocscal.<hostname.<domainname cgolds_infraoidsso.<hostname.<domainname cgoldu_ocsmtemail.<hostname.<domainname wireless_deviceportal
If there are two application entries with the same name (for example, wireless_deviceportal), then use the following procedure to identify the old application:
Click on the Edit icon against the partner application.
Note the ID of the application in the Edit Partner Application page.
The application ID with the lesser value is the old partner application
If you installed Oracle Collaboration Suite CC from the gold image, then the running OPMN processes may contain outdated information. You must restart Oracle Collaboration Suite services to ensure the information in the OPMN processes is up to date. See "Starting and Stopping Oracle Collaboration Suite Components" for details on how to start or stop services in a specific Oracle home.
Stop and start Oracle Collaboration Suite in the following sequence:
Stop the Oracle Collaboration Suite mid-tier components Oracle home
Stop the Infrastructure Oracle home
Start the Infrastructure Oracle home
Start the Oracle Collaboration Suite mid-tier components Oracle home
Refer to "Configuring Search Features" in Oracle Collaboration Suite Installation and Configuration Guide (B10874-01) for instructions.
By default, the database datafiles used by Oracle Files are not autoextensible in Oracle Collaboration Suite CC release 9.0.4.1. You can change this setting by performing the following:
Log in to the Files Infostore database as the system database user.
$ sqlplus system/<password>@<connect_string> SQL> select FILE_NAME, TABLESPACE_NAME, AUTOEXTENSIBLE from dba_data_files where TABLESPACE_NAME like 'FILES_%';
You will see an output like the following, listing seven datafiles and their corresponding tablespace names:
FILE_NAME--------------------------------TABLESPACE_NAME-------------AUT /tclona/oradata/data01/files_main.dbf FILES_MAIN NO /tclona/oradata/data01/files_lob.dbf FILES_LOB NO /tclona/oradata/data01/files_ilob.dbf FILES_ILOB NO…
If the ÒAUTÓ column is already set to YES, then you can skip this operation. If not, perform the following for each of the non-autoextensible datafile:
SQL> alter database datafile '/<SID>/oradata/data01/<filename>.dbf' autoextend on;…
After completing the changes, exit SQL*Plus:
SQL> exit;
Complete the following post-configuration task for all deployments from the product CD-ROMs. This fix is not required for the deployments installed and configured from the gold image.
Apply the following patches.
Apply patch ARU 4746420 for bug number 2811897 to fix an issue with the v$session view.
Apply patch ARU 4797874 for bug number 3143044 on the database-tier Calendar Server Oracle home and the middle-tier Calendar Web client Oracle home. On the middle-tier Calendar Web client Oracle home, do not run the uniclean and unistart commands as documented.
Use the following to start all the databases in archive mode:
$ sqlplus ‘/ as sysdba’ startup mount; alter database archivelog; alter database open; shutdown immediate; startup; exit
Use the following to change temp tablespaces to autoextensible to ’YES’ in the Infrastructure database:
$ sqlplus ‘/ as sysdba’ alter database tempfile ‘/<SID>/oradata/data02/temp01.dbf’ autoextend on; alter database tempfile ‘/<SID>/oradata/data02/ptltmp.dbf’ autoextend on; alter database tempfile ‘/<SID>/oradata/data02/discotemp1.dbf’ autoextend on;
Use the following to apply the workaround for bug number 3136600:
Set the ORACLE_HOME variable to the Oracle Collaboration Suite CC middle-tier Oracle home.
Edit the $ORACLE_HOME/webcache/webcache.xml file.
Add the following just before the </CACHEABILITY> </GLOBALCACHINGRULES> tags:
<CACHEABILITYRULE COMMENT="" SSLONLY="NO" COMPRESS="YES"
CANOUTPUTESI="YES" COMPRESSFORNETSCAPE="YES" CACHE="NO">
<SELECTORS>
<URLEXP EXP="\/um\/view_atttachment$"/>
<HTTPMETHODS SIMPLEGET="YES" GETWITHQUERYSTRING="YES"
POST="NO"/>
</SELECTORS>
Use the following to apply the workaround for bug number 3093934:
Set the ORACLE_HOME variable to the Oracle Collaboration Suite CC middle-tier Oracle home.
Set the oracle.mail.sdk.esmail.encryption value to false in the $ORACLE_HOME/j2ee/OC4J_UM/config/oc4j.properties file.
Use the following to apply the OUI workaround for Oracle Collaboration Suite CC middle-tier:
Set the ORACLE_HOME variable to the Oracle Collaboration Suite CC middle-tier Oracle home.
Edit the $ORACLE_HOME/oui/oraparam.ini file to change the JRE_LOCATION to ../../jre/1.4.1.
Refer to "Configuring Search Features" in Oracle Collaboration Suite Installation and Configuration Guide (B10874-01) for instructions.
Use the following to set up the Oracle Collaboration Suite home page for Portal users.
Use the following to grant customization privileges to all Portal users.
Log in to the Portal home page as the orcladmin user, then click Navigator.
Navigate to the Access page for ‘Oracle Collaboration Suite Home’ by using the following steps:
On the Navigator page, click Contents for the OCS_V2_PAGE_GROUP.
Click Pages.
Click Properties for ‘Oracle Collaboration Suite Home’.
Select Access tab.
In the Grant Access section of the Access tab page, perform the following steps:
Enter AUTHENTICATED_USERS in the Grantee field.
Select Customization(Hide-Show) from the drop-down menu.
Click Add.
Click Apply.
Click OK to return to the Navigator page.
Navigate to the Access page for OCS_V2_PAGE_BANNER by using the following steps:
In the Navigator page, click OCS_V2_PAGE_GROUP.
Click Navigation Pages.
Click Properties for OCS_V2_PAGE_BANNER.
Select Access tab.
In the Grant Access section of the Access tab page, perform the following steps:
Enter AUTHENTICATED_USERS in the Grantee field.
Select Customization(Hide-Show) from the drop-down menu.
Click Add.
Click Apply.
Click OK to return to the Navigator page.
Use the following to set the default home page for the orcladmin and portal users.
Log in to Oracle Portal as the orcladmin user, then click Builder.
On the Build page, click the Administer tab.
In the Portal User Profile portlet, enter PUBLIC and click Edit.
In the Default Home Page field, click the list of values (LOV) icon.
Click Return Object beside the ‘Corporate Page’ node.
Click OK in the main window.
Repeat the preceding steps for the orcladmin and portal users.
Use the following to set the default home page for all users.
Log in to Oracle Portal as the orcladmin user, then click Builder.
On the Build page, click the Administer tab.
Click Global Settings.
In the Default Home Page field, click the list of values (LOV) icon and open the OCS_V2_PAGE_GROUP node.
Click Return Object beside the ‘Oracle Collaboration Suite Home’ node.
Click OK in the main window.
Refer to Appendix B, " Troubleshooting" for handling failures during configuration. If the failure requires you to reinstall the software, follow instructions in Appendix C, " Deinstalling" to remove your existing installation.