1.8 Known Issues for iFolder 2.1.2 on Novell Nterprise Linux Services Support Pack 1

The following are known issues for Novell iFolder 2.1.2 running on Novell® Nterprise™ Linux Services.

1.8.1 Localized Versions of the iFolder Client Are Available

In Novell Nterprise Linux Services Support Pack 1, the iFolder 2.1.2 client is available in the following languages:

  • English
  • German
  • Spanish
  • French
  • Italian
  • Japanese
  • Portuguese
  • Russian

The server’s Locale setting determines which supported language the installation uses for the iFolder client installation file. Before you install iFolder, you must specify the appropriate ISO 639 Language Code in the server’s Locale setting to identify your language preference. If the server’s Language Code setting is something other than one of the supported languages, the installation copies the iFolder client in English.

1.8.2 iFolder 2.1.2 Installation Requires the Zip/Unzip Utility

To install iFolder server with the non-English version of the iFolder client that you prefer, the Linux Zip/Unzip utility must be available on the Linux server where you plan to install Novell Nterprise Linux Services Support Pack 1. If the Unzip utility is not present, only the English iFolder client is installed.

If you installed iFolder server on a Linux server without the Unzip utility, to get the iFolder client in your preferred language:

  1. Uninstall the iFolder server RPM from the Linux server.

    In Novell Nterprise Linux Service Support Pack 1, the iFolder server RPM is

    novell-ifolder-bldNumber-bldDate_bldTime.rpm
    

    where bldNumber, bldDate, and bldTime are values representing build information.

  2. Install the Linux Zip/Unzip utility on your Linux server.

  3. Make sure the language specified in the Locale setting of the server is set to a supported language.

    For information, see Section 1.8.1, Localized Versions of the iFolder Client Are Available.

  4. Reinstall the iFolder server RPM.

  5. Run the post-reinstallation configuration script. For information, see Section 1.8.6, After Upgrading or Reinstalling iFolder 2.1.2, iFolder Services and Web Access Do Not Function.

1.8.3 RedHat Linux Server Displays Incorrect IP Address

Novell iFolder 2.1.2 server requires a static IP address to install and operate properly. If your RedHat Linux server displays the incorrect IP address of 127.0.0.1 (loopback address), you must resolve this problem before installing iFolder.

To verify the IP address displayed by your RedHat Linux server, enter the following command at the server console

hostname -i

The response should display the IP address you want to use for your iFolder server.

If the response displays 127.0.0.1 as the IP address of the machine, edit the /etc/hosts file to replace 127.0.0.1 with the IP address you want to assign to your iFolder server.

Verify the correct IP address by executing the hostname -i command again.

If you have already upgraded the iFolder RPM with this problem exiting, you must uninstall the iFolder RPM, reinstall the iFolder RPM, then run the post-reinstallation configuration script. For details, see Section 1.8.5, Upgrading iFolder 2.1.2 to Support a Localized iFolder Client .

1.8.4 Upgrading iFolder 2.1.2 to Support the English iFolder Client

In Novell Nterprise Linux Services Support Pack 1, you can upgrade your iFolder 2.1.2 server to support a localized, non-English iFolder client or keep the English version of the iFolder client. For a list of supported languages, see Section 1.8.1, Localized Versions of the iFolder Client Are Available. Your server's Locale setting determines whether an English or non-English client is installed during the upgrade process.

To upgrade iFolder 2.1.2 for Novell Nterprise Linux Services Support Pack 1 and keep the English version of the client, use the following prerequisites and procedures.

To upgrade iFolder 2.1.2 to support a non-English, localized version of the iFolder client, see Section 1.8.5, Upgrading iFolder 2.1.2 to Support a Localized iFolder Client .

Prerequisites

Your Novell Nterprise Linux Services server must meet the following prerequisites before upgrading or reinstalling the iFolder 2.1.2 server:

Procedure

If your server meets the prerequisites, you are ready to upgrade iFolder 2.1.2 and keep the English version of the iFolder client.

  1. Log in to your Novell Nterprise Linux Services server as the root user.

  2. Use the Red Carpet channel to upgrade your Novell Nterprise Linux Services server to Novell Nterprise Linux Services Support Pack 1.

  3. Run the post-reinstallation configuration script.

    For information, see Section 1.8.6, After Upgrading or Reinstalling iFolder 2.1.2, iFolder Services and Web Access Do Not Function.

  4. Upon completion of the Apache restart in Step 3, the iFolder 2.1.2 services and Web access are functional.

1.8.5 Upgrading iFolder 2.1.2 to Support a Localized iFolder Client

In Novell Nterprise Linux Services Support Pack 1, you can upgrade your iFolder 2.1.2 server to support a localized, non-English iFolder client or keep the English version of the iFolder client. For a list of supported languages, see Section 1.8.1, Localized Versions of the iFolder Client Are Available. Your server's Locale setting determines whether an English or non-English client is installed during the upgrade process.

To upgrade iFolder 2.1.2 to support a non-English, localized version of the iFolder client, use the following prerequisites and procedures.

To upgrade iFolder 2.1.2 and keep the English version of the client, see Section 1.8.4, Upgrading iFolder 2.1.2 to Support the English iFolder Client.

Prerequisites

Your Novell Nterprise Linux Services server must meet the following prerequisites before upgrading or reinstalling the iFolder 2.1.2 server:

  • Configure your server with a valid static IP address.
  • Determine which one of the supported languages you want to use for the iFolder client. For a list of supported languages, see Section 1.8.1, Localized Versions of the iFolder Client Are Available. You need this information for Step 2 of the upgrade process.
  • If it is not already installed, install the Linux Zip/Unzip utility.

Procedure

If your server meets the prerequisites, you are ready to upgrade iFolder 2.1.2 for use with a localized version of the iFolder client.

  1. Log in to your Novell Nterprise Linux Services server as the root user.

  2. If you have not already done so, configure your server's Locale setting to the desired supported language.

    For a list of supported languages, see Section 1.8.1, Localized Versions of the iFolder Client Are Available. If the Locale setting is set to English or to a non-supported, non-English language, the upgrade installs the English version of the client.

    For example, to set the server's Locale, enter the following lines at the server console:

    export LANG=ru_RU

    export LC_CTYPE=ru_RU

    Replace ru_RU with the actual ISO 639 language code and ISO 3166 country code that you require.

  3. Use the Red Carpet channel to upgrade your Novell Nterprise Linux Services server to Novell Nterprise Linux Services Support Pack 1.

    During the upgrade process, the language-specific iFolder RPM is installed. After the NNLS upgrade, iFolder services and Web access do not function until you complete the remaining steps.

  4. Uninstall the iFolder 2.1.2 RPM.

    1. Locate the iFolder 2.1.2 RPM on your server.

      In general, the iFolder server RPM is named

      novell-ifolder-bldNumber-bldDate_bldTime.rpm

      where bldNumber, bldDate, and bldTime are values that specify build information. You can also use the rpm -q -a switch to locate the RPM. For example, enter the following command at the server console:

      rpm -q -a | grep ifolder

    2. Change directories to go to the directory where the iFolder RPM resides.

    3. To uninstall the iFolder RPM, use one of the following methods:

      • NNLS Uninstall: At the server console, enter

        ./install .sh

        At the script prompt, enter Uninstall, enter the number next to the iFolder module option, then follow the uninstall instructions.

      • RPM Uninstall: At the server console, enter

        rpm -e novell-ifolder-bldNumber-bldDate_bldTime.rpm

    4. Remove all installed instances of the iFolder server in the following directories:

      /opt/novell/ifolder
      
      /var/opt/novell/ifolder
      
      /etc/opt/novell/ifolder
      

      IMPORTANT:Do not remove the iFolder user data in the directory /var/opt/novell/ifolderdata. Do not remove the iFolder schema objects.

  5. Reinstall the iFolder RPM using the rpm -ivh switch.

    For example, enter the following command at the server console:

    rpm -ivh novell-ifolder-bldNumber-bldDate_bldTime.rpm

  6. Run the post-reinstallation configuration script.

    For information, see Section 1.8.6, After Upgrading or Reinstalling iFolder 2.1.2, iFolder Services and Web Access Do Not Function.

  7. Upon completion of the Apache restart in Step 6:

    • The iFolder Management console is accessible in English.
    • The iFolder Management console Help is accessible in the selected non-English, localized format.
    • The iFolder Web site is accessible in the selected non-English, localized format.
    • The non-English, localized version of the iFolder client, Quick Start, and Client Help are available for users to download from the iFolder Web site.

1.8.6 After Upgrading or Reinstalling iFolder 2.1.2, iFolder Services and Web Access Do Not Function

After you upgrade your Novell Nterprise Linux Services to Novell Nterprise Linux Services Support Pack 1, the iFolder 2.1.2 services do not function until you execute the post-reinstallation configuration script. If you reinstall the iFolder 2.1.2 RPM, the same problem occurs.

You might observe the following issues:

  • Login fails from the iFolder Admin Console.
  • Login fails from the iFolder Java applet on the iFolder Web site or the from the direct URL.
  • Existing iFolder client connections to the server stop synchronizing.

After the upgrade or reinstallation is complete, run the post-reinstallation configuration script to ensure iFolder functionality:

  1. Stop the Apache Web server by entering the following command at the server console:

    /etc/init.d/novell-httpd stop
    

    Allow enough time for a graceful stop before proceeding.

  2. To run the iFolder post-reinstallation configuration script, enter the following command at the server console

    /opt/novell/ifolder/bin/ifolder_config.sh 
    
  3. The script prompts the user for input. Specify the input in the following format. Respond appropriately to the series of LDAP prompts and the request for an Admin username and password.

    • LDAP Host: Enter the DNS name or the IP address for the Novell eDirectory™ server. For example, enter

      ldap1.yourdomain.com

    • LDAP Port: Enter the port number for SSL access to LDAP. For example, enter

      636

      NOTE:The iFolder post-install configuration configures the system to use the secure LDAP port. You can modify it later using the iFolder Admin Console.

    • LDAP Users Context: Enter the eDirectory Distinguished Name (DN) for the context where iFolder creates iFolder user accounts. Separate the DN with commas and no spaces.

      For example, enter

      ou=OU,o=O

    • LDAP Admin DN: Enter the eDirectory DN for eDirectory administrator. Separate the DN with commas and no spaces.

      For example, enter

      cn=admin,ou=OU,o=O

    • Admin Password: Enter the eDirectory administrator password.

    • Admin Users: Enter the eDirectory common names of the users who will be iFolder administrators. For multiple names, separate the names with semicolons and no spaces.

      For example, enter

      admin;admin1

  4. Because the iFolder schema objects already exist from the previous installation, the LDAP server attempts to modify the iFolder schema, but cannot. The LDAP server notifies you that no modification occurred, which is expected. Accept the notifications by clicking OK.

  5. Start the Apache Web server by entering the following command at the server console:

    /etc/init.d/novell-httpd start
    

1.8.7 Restart Apache Services After Upgrading the iFolder RPM for Russian or Japanese

If the Locale setting of your Novell Nterprise Linux Services Support Pack 1 server is set to Russian (such as LANG=ru_RU) or to Japanese (such as LANG=ja_JP), you must restart the Apache services after upgrading the iFolder 2.1.2 RPM (either by the rpm -Uvh console command or by the redCarpet installation). The RPM upgrade modifies parameters in the /etc/opt/novell/httpd/conf.d/httpd_ifolder_unix.conf file. Restarting Apache services (novell-httpd) effects the changes.