| Oracle® Retail Advanced Inventory Planning Installation Guide Release 14.1 E56751-04 |
|
 Previous |
 Next |
| Oracle® Retail Advanced Inventory Planning Installation Guide Release 14.1 E56751-04 |
|
Previous |
Next |
This chapter contains the typical steps for installing the AIP Oracle application to your Oracle WebLogic Server.
Before proceeding, you must install Oracle WebLogic Server 12c Enterprise Edition 12.1.3, plus any patches listed in Chapter 3, "Preparing for Installation" of this guide.
Also make sure to first install the AIP Oracle database components as outlined in Chapter 4, "Installing the AIP Oracle Database Server Components".
AIP Oracle is deployed to WLS managed server instance or cluster within the Oracle WebLogic Server 12c Enterprise Edition installation. It is assumed that Oracle RDBMS 12c has already been configured and loaded with the appropriate AIP Oracle schema for your installation.
|
Note: AIP uses Oracle WebLogic Server 12c Enterprise Edition, but also supports Oracle WebLogic Suite 12c. |
Ensure that the WebLogic admin server and node manager are running for your AIP Oracle installation. Refer to the Oracle Retail Application Server Administrator's Guide for details on how to start the admin server and node manager.
Perform the following procedure to create a new managed server instance for the AIP Oracle installation. If the application is being installed to a clustered WLS, then create an instance for each node of the server. All such instances should be under the same cluster.
|
Note: If you are deploying to an existing managed server instance, you can skip this step since your environment is already prepared for installing AIP Oracle. |
Log in to the administration console which is running your WLS 12c installation.
Example: http://localhost:7001/console
Choose a name for the new managed server instance.
Example: aip_MS
Create this managed server instance as documented in the Oracle Retail Application Server Administrator's Guide.
|
Note: If you do not have SOA installed, make sure the DMS/Oracle JRF deployments/libraries are not targeted to the AIP managed server. |
Configure the managed server to assign it to a machine, listen address, listen port, and so on. Also, ensure that the machine using the managed server has the node manager installed and is running.
Log in the WebLogic admin console and navigate to the server start options for the AIP managed server that was created.
In the Arguments text box enter:
-XX:MaxPermSize=512m
Save and activate the changes. Refer to the Oracle Retail Application Server Administrator's Guide for details.
Start the managed server instance. You can do this through the administration console, or on the command line. See the Oracle Retail Application Server Administrator's Guide for more information.
Verify that the managed server instance was fully started. In the admin console, the instance should have a green check mark indicating that it is running. You can also verify that aip_MS java process is running on the command line.
Sample Syntax:
ps -ef | grep aip_MS
Before you run the AIP Application Server Installer, make sure you have performed the following:
Log in to the UNIX server as the user who owns the WLS 12c installation. Create a new staging directory for the AIP Oracle application distribution (AIP-online-appserver- installer.zip).
Example: $ORACLE_HOME/aiporacle_staging
This location will be referred to as <INSTALL_DIR> for the remainder of this chapter.
Make sure there is a minimum of 500 MB disk space available for the application installation files.
Copy AIP-online-appserver- installer.zip to <INSTALL_DIR> and extract its contents.
|
Note: If you are going to run the Installer in GUI mode using an X server, which is the recommended installation method, you need to have the X Server extension enabled. This setting is not always enabled by default in your X server. Verify the extension is enabled. |
Set the ORACLE_HOME and WEBLOGIC_DOMAIN_HOME and JAVA_HOME environment variables. ORACLE_HOME should point to your Oracle WebLogic Server 12c Enterprise Edition installation. WEBLOGIC_DOMAIN_HOME should point to the directory where your WebLogic domain was installed. JAVA_HOME must point to a valid Java 1.7 or later JDK.
Once you have an managed server instance that is started, you can run the AIP Oracle application installer. This installer will configure and deploy the AIP Oracle application and AIP Oracle Integration files.
Extract AIP-online-appserver- installer.zip to <INSTALL_DIR> directory.
Change directory (cd) to the <INSTALL_DIR>/AIPOnlineAppServer directory.
Run the following install.sh script to start the Installer.
./install.sh
|
Note: The command must be executed with the preceding period and forward slash (./). |
When the installation is complete, a detailed installation log file is created. This file is named aip14.1.0install--app.<timestamp>.log where <timestamp> represents the date and time the installation was performed. This file is located in the <INSTALL_DIR>/AIPOnlineAppServer directory.
If this process is being run on an X-Windows emulator (such as Exceed), a graphical user interface (GUI) to the Installer opens. If you are running in console mode through a terminal emulator, the text interface to the Installer opens.
To run the Installer in the GUI mode, which is the recommended installation method, adjust the DISPLAY environment variable. For example use following command to adjust DISPLAY in Exceed:
export DISPLAY=<ipaddress>:0
In both cases, the requested information is identical. In the GUI, you may be shown a checkbox to signal whether you want a component installed; in text mode, you are prompted for a response of true or false.
|
Note: In text mode, the default value will appear in square brackets []. To use the default value and continue, press Enter. If you wish to use a different value, enter the new value. When prompted to create a directory, respond with yes and press Enter.Password fields will appear masked, but the previous and default values will appear in plain text when running in the text mode. |
The AIP Oracle Installer Window opens and displays the components that will be installed during installation process, as well as the required components. Click Next to continue to the Data Source Details Window.
The Security Details Window opens. Indicate whether or not you would like to enable SSL for AIP and then click Next to continue to the JDBC Security Details Window.
The JDBC Security Details Window opens. Indicate whether or not you would like to enable a secure JDBC connection for AIP and then click Next to continue to the Data Source Details Window.
The Data Source Details Window opens. Enter the information as shown in the following table and then click Next.
If you selected Yes in the JDBC Security Details Window, continue to the Secure Data Source Details WindowIf you selected No, continue to the WebLogic Administration Window.
| Field | Description |
|---|---|
| AIP JDBC URL | Enter the path for the JDBC connection, |
| AIP DB schema user | Enter the AIP database schema user name. |
| AIP DB schema password | Enter the AIP database schema password. |
| Enter the AIP schema owner | Enter the AIP database schema owner which is typically the same as the AIP DB schema user. |
| Enter the AIP schema alias | Enter the AIP database schema alias. This is used to securely store the username/password in a wallet file. |
The Secure Data Source Details Window opens. Enter the information as shown in the following table and then click Next to continue to the WebLogic Administration Window.
| Field | Description |
|---|---|
| Identity Keystore location | Location or path where identity keystore file is stored. |
| Identity Keystore type | The type of the keystore used. For example, JKS |
| Identity Keystore Passphrase | The password for the Identity Keystore. |
| Identity Truststore location | The path of the keystore which contains the SSL root and optionally intermediate certificates as obtained from the certificate authority |
| Identity Truststore type | The type of the truststore used. For example, JKS |
| Identity Truststore Passphrase | The password for the Identity Truststore. |
The WebLogic Administration Window opens. Enter the information as described in Table 5-1 and click Next to continue to the Application Deployment Details Window.
Table 5-1 WebLogic Administration Fields
| Field | Description |
|---|---|
|
Hostname |
Hostname of the server where the AIP weblogic admin server is running. |
|
WebLogic admin port |
Enter the WebLogic admin port found in $WEBLOGIC_DOMAIN_HOME/config/config.xml file. Example of Port Definitions in config.xml File:
|
|
WebLogic admin user |
Enter the WebLogic admin user name. |
|
WebLogic admin password |
Enter the WebLogic admin user password. |
|
WebLogic admin alias |
This is the alias for the WebLogic username/password to store in the wallet file during installation. |
The Application Deployment Details Window opens.
Enter the information as described in Table 5-2 and click Next to continue to the AIP Oracle Installation Directory Window.
Table 5-2 Application Deployment Details Window Fields
| Field | Description |
|---|---|
|
AIP 14 context Root |
Enter the context root that the application will use. Example:
where aip141 represents the context root required for this field. |
|
AIP 14 app deployment name |
Enter the name to be used by the application server to identify the AIP Oracle application. |
|
AIP 14 server/cluster |
The managed server or cluster to which AIP deploys. |
The AIP Oracle Installation Directory Window opens.
Enter the directory where AIP Oracle will be installed and click Next to continue to the AIP Oracle Integration Window.
The AIP Oracle Integration Window opens.
Enter the directory where AIP Oracle Integration components are to be installed and click Next to continue to the AIP Online Integration Install Window.
The AIP Oracle Integration Home field defaults to the value of the AIP Online Install Dir field from the AIP Oracle Installation Directory Window.
You may choose to install the integration components to another location on the same server at this point, or you may choose to move the installed files once the installation process is complete.
The AIP Online Integration Install Window opens. Complete all the AIP Integration Install fields and click Next to continue to AIP Online RIB Enable Window.
|
Note: Refer to the Oracle Retail Advanced Inventory Planning Online Implementation Guide as well as the Oracle Retail Extract, Transform, and Load (RETL) Installation Guide for further details on the AIP Integration Install fields. |
The AIP Online RIB Enable Window opens.
Indicate whether or not you would like to configure RIB for AIP at this point in time. If you do not, refer to the Oracle Retail Advanced Inventory Planning Operations Guide in manually configuring RIB for AIP.
If you select Yes, click Next to continue to the AIP Online RIB Enable Details Window. If you select No, click Next to continue to the Installation Summary Window.
|
Note: Disregard the screen directions to leave the values blank on the following page if you select No. If you select No and click Next, you continue to the Installation Summary Window. |
The AIP Online RIB Enable Details Window opens. If you selected No on the previous AIP Online RIB Enable Window, leave these values blank. If you selected Yes, then enter the RIB application details and then click Next to continue to the Installation Summary Window.
The Installation Summary Window opens. Verify the values and then click Next to continue to Installation Progress Window.
The Installation Progress Window opens.
Once you are ready to begin installation, click Install to continue to the Installation Progress Details Window.
The Installation Progress Details Window opens.
This window displays the progress of the installation routine. Click Show Details to view the log output as the installation is performed. If you do not select to view the details, a graphical representation of the installation steps appears.
You can toggle between detailed mode at any time during or after the installation.
When the installation has finished, the Finished Pop-up Window opens. Click OK to close the pop-up and open the Complete Window.
The Complete Window opens. To view the installation details, click Show Details. The window displays two tabs:
Output
Errors
It is recommended that you review these tabs for any issues that may have occurred during the installation process.
When the installation is complete, a detailed installation log file is created. This file is named aip14.1.0install-app.<timestamp>.log where <timestamp> represents the date and time the installation was performed. This file is located in the <INSTALL_DIR>/AIPOnlineAppServerdirectory.
If the application installer encounters any errors, it will halt execution immediately. You can run the installer in silent mode so that you don't have to retype the settings for your environment. Refer to "Reinstalling in Silent Mode" of this guide for instructions on silent mode.
Refer to the "Troubleshooting" section of this guide for a list of common installation errors.
Since the application installation is a full reinstall every time, any previous partial installs will be overwritten by the successful installation.
The AIP Oracle Installer places the AIP Oracle Integration directory, AIPONLINE_DIR, with the rest of the AIP Oracle application files.
The integration directory can be located in a different location if you cannot run them from under the AIPONLINE_DIR. To install the integration files in a different location, copy the entire $AIPONLINE_DIR/AIPOnlineIntegration directory to the appropriate destination. Refer to Chapter 6, "Installing the AIP Integration Components" of this guide for more information.
|
Note: Skip this section if you chose the default option of allowing the installer to complete the installation to the application server. Refer to Chapter 6, "Installing the AIP Integration Components" of this document for more information. |
The Installer includes the option to configure the application locally and skip deployment to the application server. If this option is chosen, the installer will make the configured application files available under
<INSTALL_DIR>/AIPOnlineAppServer/aip/configured-output/.
If you chose this installer option, you can complete the installation by following these steps:
Inspect and then overlay files from
<INSTALL_DIR>/AIPOnlineAppServer/aip/configured-output/ into your application server installation.
Deploy the AIPOnlineApp EAR file using the WLS Admin Console Web interface.
The configured EAR file is located at:
<INSTALL_DIR>/AIPOnlineAppServer/aip/configured-output/AIPOnlineApp.ear.
When deploying the EAR file, you should provide the same application name you entered in the Installer. This value is stored in the <INSTALL_AIP>/AIPOnlineAppServer/ant.install.properties file by the Installer for later reference.
Deploy the AIPOnlineApp-help EAR file using the WLS Admin Console Web interface.
The configured EAR file is located at:
<INSTALL_DIR>/AIPOnlineAppServer/aip/configured-output/AIPOnlineApp-help.ear.
The weblogic.policy file requires editing if RIB was configured for AIP. The file is located at WL_HOME\server\lib\weblogic.policy. Entries should be created to grant full permissions to the location of the deployed application as well as the EJB Compiler Cache location.
Example
An example of these entries looks like this:
grant codeBase ”file:/u00/webadmin/product/12.1.3/WLS/user_projects/domains/soa_domain/servers/AIP_SERVER/tmp/_WL_user/aip/-” { |
|
| permission java.security.AllPermission; | |
| permission oracle.security.jps.service.credstore.CredentialAccessPermission ”credstoressp.credstore”, ”read,write,update,delete”; | |
| permission oracle.security.jps.service.credstore.CredentialAccessPermission ”credstoressp.credstore.*”, ”read,write,update,delete”; }; | |
grant codeBase ”file:/u00/webadmin/product/12.1.3/WLS/user_projects/domains/soa_domain/servers/AIP_SERVER/cache/EJBCompilerCache/-” { |
|
| permission java.security.AllPermission; | |
| permission oracle.security.jps.service.credstore.CredentialAccessPermission ”credstoressp.credstore”, ”read,write,update,delete”; | |
| permission oracle.security.jps.service.credstore.CredentialAccessPermission ”credstoressp.credstore.*”, ”read,write,update,delete”; }; | |
Oracle Retail Advanced Inventory Planning can be accessed through a secure HTTP connection. Using a secure message transport such as SSL/TLS will provide confidentiality for messages as they traverse the network. This is the recommended configuration for Advanced Inventory Planning.
For more information on using SSL/TLS see the section ”Configuring SSL” found in the WebLogic guide Securing Oracle WebLogic Server.
When you have successfully finished the postinstallation steps in the following sections, you should have a working AIP Oracle application installation. To launch the application client, open a Web browser and go to the client URL. You can find the URL in the log file that was created by the Installer.
Example: http://myhost:7501/aip141/
Clients using certain languages are required to edit the Java Font Configuration file on the client machine. Follow the instructions in this section if you are using these languages:
French
German
Greek
Russian
Turkish
Follow these instructions to add the Cyrillic character set:
Verify the Java installation path.
Open Task Manager and while java.exe is running, right-click on java.exe to view which path is used (either C:\Program Files (x86)\Java\jre7\bin or C:\Program Files\Java\jre7\lib)
Go to your Java path\lib (either: C:\Program Files (x86)\Java\jre7\bin or C:\Program Files\Java\jre7\lib)
Make a copy of fontconfig.properties.src and rename this to fontconfig.properties
On fontconfig.properties, modify the line:
sequence.allfonts=alphabetic/default,dingbats,symbol
to
sequence.allfonts=cyrillic,alphabetic/default,dingbats,symbol
This section provides the procedures to create an AIP Oracle enterprise and the initial administrator for the newly created enterprise.
Select the link displayed in the AIP Oracle Setup to load the AIP Oracle application System Administration.
In the event that the page has timed out or been closed, enter the application URL in the Web browser as shown in the following example. Example: http://<server>:<port>/<context root>/phantasm
For the User Name field and Password field, enter the user name and password that were set for the "Default Admin User Details". The System Administration page opens.
|
Note: A Warning - Security window may appear asking if the signed applet that is to run the Enterprise Administration window can be trusted. If this window opens, click Yes. |
Click Enterprises in the Enterprise Data section. The Enterprise Administration window opens.
Click New.
On the Company Info tab, enter the following information.
| Field | Description | Example |
|---|---|---|
| Company name | Enter your company name | My Company |
| Enterprise code | aiponline | aiponline |
| Contact Email | Enter the AIP Administrator's e-mail address | admin@server.com |
|
Note: The Industry and Company type fields are not required. |
On the initial Admin tab, enter the following information.
| Field | Description | Example |
|---|---|---|
| First Name | Enter the AIP Administrator's first name. | John |
| Last Name | Enter the AIP Administrator's last name. | Doe |
| Username | Enter the AIP Administrator's user name to be used when logging into AIP Oracle. | doejohn |
| New Password | Enter the AIP Administrator's AIP Oracle password.
When selecting a password, make sure it meets the following requirements:
|
aip140online |
| Retype New Password | Retype your password. Remember, the password is case sensitive, so you must type it exactly as it was entered in the Password field. | aip140online |
Navigate to the Services tab. Two services are displayed, Core Administration and AIP Oracle. Perform the following steps:
| Step | Direction |
|---|---|
| a. | Click the Enabled cell of Core Administration. |
| b. | Double-click the User Limit cell of Core Administration and enter an integer value in the cell. This integer value represents the number of users that can be created per application. If the exact number of users is not known, enter a large number such as 100. This number can be changed later by the system admin user. |
| c. | Press Enter to accept your input. |
| d. | Click the Enabled cell of AIP Oracle. |
| e. | Double-click the User Limit cell of AIP Oracle and enter an integer value in the cell. This integer value represents the number of users that can be created per application. If an exact number of users is not known, enter a large number such as 100. This number can be changed at a later time by the system admin user. |
| f. | Press Enter to accept your input. |
On the Enterprise Administration window, click Save. Close the Enterprise Administration window when the save is complete.
On the System Administrator page, click the LOG OUT link located at the top right of the page.
This section provides the procedures to create AIP Oracle users. New users should be created using the administrator account created in the previous step.
Load the application URL in a browser to access the AIP Oracle application login page.
Example: http://<server>:<port>/<context root>
Input the administrator username and password, and click LOG IN. The Application page opens.
Click the Core Administration link. The Administration page opens.
Click Users in the Application Setup section. The Core Administration: User Administration window opens.
Select the Users tab and click New. A user information form is displayed.
In the Details tab, enter all relevant user information in the form.
| Field | Example |
|---|---|
| First Name | John |
| Last Name | Doe |
| jdoe@company.com | |
| Username | doejohn |
| New Password | aip140online |
| Retype New Password | aip140online |
| Password Status | Normal |
Click the Permissions tab. A user permissions form opens.
Select the Enabled cell of the AIP Oracle service. Available Types selection box is populated with data.
Select All AIP Permissions from the Available Types selection box. Click > to move this permission type to the Selected Types box, and then click Save.
Repeat steps 5 through 9 until you have added the necessary user accounts.
When you have added all the necessary user accounts, close the Core Administration: User Administration window.
To exit, click LOG OUT.
