Upgrading IBM Content Navigator for Microsoft Office silently

You can create a silent upgrade of IBM Content Navigator for Microsoft Office that you deploy to the client machines.

Before you begin

Copy the IBM Content Navigator for Microsoft Office component from the IBM Content Navigator CD or download the component from Passport Advantage®.

About this task

If you create a silent upgrade of IBM Content Navigator for Microsoft Office, you must decide how you will deploy the silent upgrade to the client machines in your environment. For example, you can:

Push a silent upgrade of IBM Content Navigator for Microsoft Office to your client machines
Create a batch executable file that includes the silent upgrade command and instruct your users to download the executable file from a URL

To silently upgrade IBM Content Navigator for Microsoft Office, you must construct a command that includes the appropriate information about your IBM Content Navigator environment. After you construct the command, you must run the command on the client machines. Some suggestions for how to deploy the silent installation are offered in the previous paragraph.

Important: When you upgrade IBM Content Navigator for Microsoft Office, the configuration.ini file is not updated. If you want to change the configuration.ini file, you must manually edit the file and push the updated version of the file to the client machines in your environment.

Procedure

To silently upgrade IBM Content Navigator for Microsoft Office:

Change to the directory where you downloaded the IBM Content Navigator for Microsoft Office product and enter the following command: ICNforOfficeInstall.exe /s /v"/qn ICNURL=URL Optional Parameters LICENSE_ACCEPTED=true".

Tip: If you want to generate an installation log file, you can add the following argument to the command:/L*v fully_qualified_path_of_the_log_file

For example, you might enter: ICNforOfficeInstall.exe /s /v"/qn /L*v C:\InstallLog.txt ICNURL=URL Optional Parameters LICENSE_ACCEPTED=true".

Modify the command based on the values that you need to specify for yourIBM Content Navigator installation:

Parameter	Description
ICNURL	Required. You must specify the URL of the instance of IBM Content Navigator that you want users to connect to from IBM Content Navigator for Microsoft Office. The parameter must have the following format: `ICNURL=http://host_name:port_number/context_root`. For your installation, you might enter: `ICNURL=http://myhost:8880/navigator`. Tip: The format of the URL can vary depending on your environment: If you deployed IBM Content Navigator to a highly available cluster, the URL must point to the load balancing server: `http://load_balancer_host_name:load_balancer_port_number/context_root`. If you are using SSL, the protocol of the URL is HTTPS: `https://host_name:port_number/context_root`. If you are using IBM Security Access Manager for single sign-on (SSO), the URL is `http://TAM_server_name/context_root`. By default, the context root is navigator.
DesktopID	Optional. If you want users to access a specific IBM Content Navigator desktop, you must specify the ID of the desktop. If you omit this parameter from your command, users automatically connect to the default desktop. The parameter must have the following format: `DesktopID=desktop_ID`. For your installation, you might enter: `DesktopID=mydesktop`.
ADD_LOCAL	Optional. You can specify which features of IBM Content Navigator for Microsoft Office to install. If you omit this parameter from your command, all of the features of IBM Content Navigator for Microsoft Office are installed. Valid values are: Excel Outlook Powerpoint Word Use a comma to separate multiple values, but do not include a space between the values. The parameter must have the following format:`ADD_LOCAL=value1,value2`. For your installation, you might enter: `ADD_LOCAL=Excel,Powerpoint,Word`.
SAVE_SETTINGS_FOR_ALL	Optional. You can specify whether IBM Content Navigator for Microsoft Office is installed for all users of the client machine or only the currently logged on user. If you omit this parameter, IBM Content Navigator for Microsoft Office is installed for only the current user. Valid values are: 1 Install for all users. 2 Install for only the current user. This is the default value. The parameter must have the following format: `SAVE_SETTINGS_FOR_ALL=value`. For your installation, you might enter: `SAVE_SETTINGS_FOR_ALL=1`.
IBMECMTABLABEL	Optional. You can customize the name that is displayed for IBM Content Navigator for Microsoft Office in the ribbon bar at the top of the application. If you omit this parameter, the default display name, IBM ECM, is used. The parameter must have the following format: `IBMECMTABLABEL=display_name`. For your installation, you might enter: `IBMECMTABLABEL=My Company Name ECM`
LICENSE_ACCEPTED	To install IBM Content Navigator for Microsoft Office, you must accept the license agreement. The parameter must have the following format: `LICENSE_ACCEPTED=true`.