3 Setting Up Web Servers for Consoles

This chapter contains the following topics:

3.1 Understanding Web Server Setup

You must set up additional information in your web servers to enable the charts to appear correctly in the console.

See JD Edwards EnterpriseOne Tools Server and Workstation Administration Guide

3.2 Setting Up Charts on the Web Server

This section discusses how to enable charts in non-Windows environments.

3.2.1 Enabling Charts in Non-Windows Environments

You need to set up a Java environment variable for your JD Edwards HTML server in the WebSphere administration console to enable charts in non-Windows environments such as UNIX, Linux, and IBM iSeries with WebSphere Application Server 6.0.


Note:

Perform these steps after you install or upgrade the JD Edwards HTML Server.

To enable charts in non-Windows environments:

  1. Sign in to the WebSphere Application Server Admin Console.

  2. Select Servers from the File menu.

  3. Select Application Servers from the Servers menu.

  4. Select the JD Edwards HTML Server, for example, AS_JS_81.

  5. Expand the Java and Process Management link.

  6. Select Process Definition, and then select Java Virtual Machine.

  7. Select Customer Properties, and then click New.

  8. Enter java.awt.headless in the Name field.

  9. Enter true in the Value field, and click the Apply button.

  10. Click the Save link on the Confirmation screen.

  11. Click Save.

  12. Restart your JD Edwards HTML Server.

3.3 Setting Up Font Listing JSP

The Font Listing JSP enables you to review the fonts that are loaded to your server. This diagnostic tool enables you to review the fonts by creating a JSP file in a web application on your application server.

The Font Listing JSP does not tell you the fonts that are expected.

This section discusses how to:

  • Determine the fonts on the server.

  • Review the fonts.

3.3.1 Determining the Fonts on the Server

To determine which fonts are on the server:

  1. Create a file called FontListing.jsp in the web client web application on your application server.

  2. Copy these lines into the FontListing.jsp file:

    {!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"} 
    
    {HTML}
    {HEAD}
    {%@ page language="java" contentType="text/html; charset=ISO-8859-1"
    import="java.awt.GraphicsEnvironment, java.awt.Font"
    %}
    {TITLE}Enumerate Fonts{/TITLE}
    {/HEAD}
    {BODY}
    
    
    
    {table}
    {% 
              GraphicsEnvironment graphicsenvironment = 
       GraphicsEnvironment.getLocalGraphicsEnvironment();
       if(graphicsenvironment != null)
       {
          String as[] = graphicsenvironment.getAvailableFontFamilyNames();
          if(as != null && as.length } 0)
          {
             for(int i = 0; i { as.length; i++)
             {
                String theString = as[i];
                String fontFamily = "";
                try
                {
                   Font font = new Font(as[i], Font.PLAIN, 10);
                   fontFamily = font.getPSName();
                } 
                catch (Throwable t)
                {
                   theString = theString + " " + t.toString();
                }
                out.print("{tr}{td}");
                out.print(theString);
                out.print(" {/td}{td}");
                out.print(fontFamily);
                out.println("{/td}{/tr}");
             }
    
          }
       } 
    %} 
    {/table}
    
    {/BODY}
    {/HTML}
    

3.3.2 Reviewing the Fonts

To review the fonts:

  1. Navigate to http://[hostname]/jde/FontListing.jsp

  2. Review the font information.

    You may need assistance from someone familiar with your application server and Java J2EE.

3.4 Setting Up Asian Fonts on Servers

Charts use the Asian fonts on the server to write out text for images. If the fonts are not on the server, then the system displays squares instead of text. You must install Albany fonts for the system to display the text correctly on charts.

To determine which fonts are installed on the server, run the Font Listing JSP.

This section discusses how to:

  • Set up WebSphere running on Microsoft Windows platforms.

  • Set up OAS running with Sun Microsystems JRE.

  • Set up IBM iSeries.


Note:

To get the Albany fonts, download Patch 3244117 from Oracle. Five .ttf files in the patch make up the Albany fonts:

Albany WT: Generic non-East Asian font

Albany WT J: Japanese flavor font

Albany WT K: Korean flavor font

Albany WT SC: Simplified Chinese flavor font

Albany WT TC: Traditional Chinese flavor font


3.4.1 Setting Up WebSphere Running on Microsoft Windows Platforms

IBM servers assume that the Arial Unicode MS font or the Times New Roman font is installed. If they are not installed, you need to install the Arial Unicode MS font. You must be licensed to a product that includes the font. If you are not licensed to a product that includes the font, use the Albany fonts.

To install the Albany fonts:

  1. Download the .ttf file that corresponds to your required font to a temporary directory on the server.

  2. Copy the font file from the temporary directory and paste it into the %win_dir%\Fonts directory in Microsoft Windows Explorer.

    The system installs the font automatically.

  3. Select the Control Panel.

  4. Select Fonts.

  5. Verify that the required Albany font is available.

  6. Select the %was_dir%/java/jre/lib/font.properties file.

  7. Find this line: substitute.0=Arial Unicode MS=%SUBSTITUTE FONT NAME%, where %SUBSTITUTE FONT NAME% is typically equal to a Times New Roman font.

  8. Change the %SUBSTITUTE FONT NAME% to your required Albany font, such as Albany WT, Albany WT J, Albany WT K, Albany WT SC, or Albany WT TC.

  9. Restart your WebSphere Application server.

3.4.2 Setting Up OAS Running with Sun Microsystems JRE

You can use the Albany fonts with Sun Microsystems JRE.

To install the Albany fonts:

  1. Do one of these tasks for the system to install the required font automatically:

    • Download the .ttf file that corresponds to your required font to the [JRE_TOP]/lib/fonts directory or to a directory to which the JAVA_FONTS variable points.

      The directory must be visible to the X display server for the UNIX platform.

    • For Microsoft Windows, extract the .ttf file in the %win_dir%/fonts directory.

  2. Select the [JRE_TOP]/lib/font.properties file.

  3. Change each sanserif block to point to the Albany font. For example:

    sansserif.0=Arial,ANSI_CHARSET
    sansserif.1=Albany WT J
       
    sansserif.bold.0=Arial Bold,ANSI_CHARSET
    sansserif.bold.1=Albany WT J
       
    sansserif.italic.0=Arial Italic,ANSI_CHARSET
    sansserif.italic.1=Albany WT J
       
    sansserif.bolditalic.0=Arial Bold Italic,ANSI_CHARSET
    sansserif.bolditalic.1=Albany WT J
    
  4. Add the font file to the section of [JRE_TOP]/lib/font.properties. For example filename.Albany_WT_J=ALBANWTJ.TTF.

  5. Restart your application server.

3.4.3 Setting Up IBM iSeries

To set up IBM iSeries:

  1. Verify that you have the World Fonts option.

    1. GO LICPGM.

    2. Select Option 10 (Display installed licensed programs).

    3. Press F11 until the headers contain Licensed Program, Product Option, and Description.

  2. Look for Licensed Program 5722SS1, Product Option 43, Description Additional Fonts.

    Order the font if it is not listed. Contact your system administrator to do so.

  3. Download the font.properties.worldfont and fontdir files that are shown on the IBM web site: www.ibm.com

    1. Search on "Using DBCS on NAWT".

    2. Download the files.

  4. Copy the files to a directory on your I5 server.

  5. Run this shell script lines from QSHELL (qsh) using the target directory to which you copied the files:

    mv -i /QIBM/ProdData/Java400/jdk13/lib/font.properties 
    /QIBM/ProdData/Java400/jdk13/lib/font.properties.sav
    mv -i /QIBM/ProdData/Java400/jdk14/lib/font.properties
    /QIBM/ProdData/Java400/jdk14/lib/font.properties.sav
    #
    cp -i font.properties.worldtype
    /QIBM/ProdData/Java400/jdk13/lib/font.properties
    cp -i font.properties.worldtype
    /QIBM/ProdData/Java400/jdk14/lib/font.properties
    cp fonts.dir /QIBM/ProdData/OS400/Fonts/TTFonts/fonts.dir