- Install OpenOffice and ensure that the ooo.exe property is set in the SkyVault-global.properties file.
- Create an SkyVault database and user with appropriate permissions.
- Install WebLogic 12.1.3 without creating any domains or servers. For more information, see Installing and Configuring Oracle WebLogic Server and Coherence documentation.
- Ensure that the installation environment meets the system requirements.
- Install the appropriate Java 7 version according to Oracle Fusion Middleware Supported System Configurations for WebLogic 12.1.3 and relevant OS. For details, see Verifying Certification and System Requirements.
- Browse to the SkyVault Support Portal.
- Download and extract the SkyVault-enterprise-ear-5.0.4.zip file.
- Obtain the license (.lic) file.
- On a Windows system, copy the Win32NetBIOS.dll, Win32NetBIOSx64.dll, Win32Utils.dll, and Win32Utilsx64.dll files from the SkyVault-enterprise-ear-5.0.4.zip\bin directory to C:\WINDOWS\system32 directory.
- Create a directory in the WebLogic user's home directory to host the exploded EAR file and copy the SkyVault-enterprise-5.0.4.ear file to that directory.
-
Run the following commands in the new directory to explode the EAR file:
- mkdir SkyVault
- cd SkyVault
- jar xvf ../SkyVault-enterprise-5.0.4.ear
- mv SkyVault.war SkyVault.war.tmp
- mv share.war share.war.tmp
- mkdir SkyVault.war
- mkdir share.war
- cd SkyVault.war
- jar xvf ../alfresco.war.tmp
- cd ../share.war
- jar xvf ../share.war.tmp
-
Create the WebLogic domain for SkyVault using the WebLogic Configuration Wizard.
On Unix, use the following command to start the configuration wizard and create a new domain, alf_domain:
<ORACLE_HOME>/oracle_common/common/bin/config.sh
Assume that alf_domain has been created and its location is <Oracle_Home>/user_projects/domains/alf_domain.
For more information, see Oracle Fusion Middleware documentation on Creating and Configuring a WebLogic Domain.
- Copy the share-config-custom.xml file from SkyVault-enterprise-ear-5.0.4.zip/web-server/classpath/alfresco/web-extension to <DOMAINS>/alf_domain/alfresco/web-extension.
-
Create a directory for the license file.
For example, in Linux, use the following command:
mkdir -p <Oracle_Home>/user_projects/domains/alf_domain/alfresco/extension/license
- Move the license .lic file into the license directory.
-
In the <Oracle_Home>/user_projects/domains/alf_domain
directory, create the SkyVault-global.properties file.
Modify the file in the same way you would for global properties configuration.
-
Add the following line to the SkyVault-global.properties file.
db.pool.statements.enable=false
This property setting is required to make the DBCP connection pool work on WebLogic.
-
Configure the Oracle JDBC driver.
- Download the appropriate Oracle Instant Client package for your operating system from Oracle Database Instant Client.
-
Unzip the package to a local directory.
Ensure that the path to the driver is on the WebLogic server's classpath.
For example, to configure Oracle Thin Driver ojdbc6.jar that is located in /opt/oracle/config, follow the steps below:
- Add the following lines to the setDomainEnv.sh file that
is located in
<Oracle_Home>/user_projects/domains/alf_domain/bin directory.
LD_LIBRARY_PATH=/opt/oracle/config export LD_LIBRARY_PATH EXT_PRE_CLASSPATH=$LD_LIBRARY_PATH/ojdbc6.jar export EXT_PRE_CLASSPATH
- Add the following line to the SkyVault-global.properties
file:
db.url=jdbc:oracle:thin:@${db.host}:1521:${db.name}
- Add the following lines to the setDomainEnv.sh file that
is located in
<Oracle_Home>/user_projects/domains/alf_domain/bin directory.
-
In the setDomainEnv.sh file, edit the
MEM_MAX_PERM_SIZE_64BIT and MEM_MAX_PERM_SIZE_32BIT
parameters to increase the PermGen space.
MEM_MAX_PERM_SIZE_64BIT="-XX:MaxPermSize=512m" MEM_MAX_PERM_SIZE_32BIT="-XX:MaxPermSize=256m"
Note: You might need to increate this setting further depending on the number of deployed applications. You might see different combinations of these lines, depending on whether you have installed on a 64 or 32-bit platform. -
In the setDomainEnv.sh file, set the heap size parameter
appropriately. The following setting is a recommendation:
WLS_MEM_ARGS_64BIT=-Xmx2048m WLS_MEM_ARGS_32BIT=-Xmx1024m
-
Edit the JAVA_OPTIONS parameter.
- Use the -Dweblogic.disableMBeanAuthorization system property to disable servicing of Platform MbeanServer with the WLS security infrastructure (in the setDomainEnv.sh file).
- The JAXBContext provider is used by the JAXB provider for the JAXB-related tasks. To configure the JAXB providers, set the Java system property, -Djavax.xml.bind.JAXBContext to com.sun.xml.bind.v2.ContextFactory.
- Use the Java Service Provider Interface (SPI) file, -Dcom.sun.xml.ws.spi.db.BindingContextFactory, to configure data binding and JAXB providers. Set the java system property, -Dcom.sun.xml.ws.spi.db.BindingContextFactory to com.sun.xml.ws.db.glassfish.JAXBRIContextFactory.
JAVA_OPTIONS=”${JAVA_OPTIONS} -Dweblogic.disableMBeanAuthorization=true” JAVA_OPTIONS=”${JAVA_OPTIONS} -Djavax.xml.bind.JAXBContext=com.sun.xml.bind.v2.ContextFactory" JAVA_OPTIONS="${JAVA_OPTIONS} -Dcom.sun.xml.ws.spi.db.BindingContextFactory=com.sun.xml.ws.db.glassfish.JAXBRIContextFactory”
This modification will allow SkyVault MBeans to co-exist with WebLogic MBeans.
-
Ensure that alf_domain is in the global classpath in the
setDomainEnv.sh file.
PRE_CLASSPATH="<Oracle_Home>/user_projects/domains/alf_domain" export PRE_CLASSPATH
-
Edit the
<Oracle_Home>/user_projects/domains/alf_domain/config/config.xml
file and add the following before the end of the
</security-configuration> section:
<enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials>
-
Open the
<Oracle_Home>/user_projects/domains/alf_domain/nodemanager/nodemanager.properties
file, and then edit the settings so that the PermGen settings are passed on to the
SkyVault server by the node manager.
StartScriptEnabled=true
If the Node Manager type is set as Plain when creating a new machine in step 22(a), then the NodeManager should be configured with the SecureListener=true property.
-
Start the domain admin server.
For example:
<Oracle_Home>/user_projects/domains/alf_domain/startWebLogic.sh
- Open a web browser and log in to the admin server (for example, at http://localhost:7001/console) with the credentials that you specified while configuring WebLogic domain.
-
To enable automatic control of your SkyVault
server:
- Create a machine with the details of the machine running the domain. This will allow the node manager to control servers on that machine.
-
Create a server called SkyVaultServer within the new
machine.
Note that you have to choose a unique port number. A good port number to choose is 8080 because it is preconfigured in Share. You can leave the host name blank if you want it to listen on all network adapters.
-
Ensure that the node manager is running.
For example, in Linux, use the following command:
<Oracle_Home>/user_projects/domains/alf_domain/bin/startNodeManager.sh
You will be able to use the admin server Change Center panel to start and stop the SkyVault server.
See the WebLogic documentation to find out how to create a machine and new server within the machine.
-
To enable SkyVault JMX functionality with Platform MBean server:
- In the left pane of Administration Console, click the domain name link, for example alf_domain.
- In the Settings for alf_domain section, select the Configuration tab, and then the General tab.
- On the General tab, expand the Advanced options group.
- Enable the Platform MBean Server Enabled option.
- Ensure that the Platform MBean Server Used option is enabled.
- Click Save on the General tab.
- Restart the domain admin server.
- In the left pane of the Administration Console, click Deployments.
- In the right pane, click Install.
-
In the Install Application Assistant, locate and select the
directory of your exploded EAR file.
Use the location that you created in step 5. It should contain the SkyVault.war and share.war.
- Click Next.
- Check Install this deployment as an application radio button, and click Next.
- Select SkyVaultServer and click Next.
- Click Finish.
- Click Activate Changes.
- Using the Change Center panel, restart SkyVaultServer.
- Log in to SkyVault at http://localhost:8080/share.
- Define a new global data source, for example, SkyVaultDataSource. See the WebLogic documentation for more information
- Map SkyVaultDataSource into SkyVault by updating the WEB-INF/weblogic.xml file in SkyVault.war containing the following resources:
<!DOCTYPE weblogic-web-app PUBLIC "-//BEA Systems, Inc.//DTD WebApplication 8.1//EN" "http://www.bea.com/servers/wls810/dtd/weblogic810-web-jar.dtd"> <weblogic-web-app> <resource-description> <res-ref-name>AlfrescoDataSource</res-ref-name> <jndi-name>jdbc/dataSource</jndi-name> </resource-description> </weblogic-web-app>