IBM Content Navigator, Version 2.0.3 Supports: Content Manager, FileNet P8

Installing IBM Content Navigator for Microsoft Office silently

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

Before you begin

Before you install IBM Content Navigator for Microsoft Office, you must have a deployed instance of IBM Content Navigator, and you must have at least one desktop in your environment.

You must also 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 installation of IBM Content Navigator for Microsoft Office, you must decide how you will deploy the silent installation to the client machines in your environment. For example, you can:

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

To silently install 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.

Start of change The IBMECMTABLABEL parameter is no longer configurable from the IBM Content Navigator for Microsoft Office silent installation command. However, you can configure the tab label at the desktop level in the IBM Content Navigator administration tool. End of change

Procedure

To silently install 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: By default, the silent installation log file is written to a subdirectory of the user directory that you logged in with, for example:

If you logged in as the Administrator, the log file is written to the C:\Users\Administrator\AppData\Local\Temp directory.
If you logged in as a nonadminstrative user, the log file is written to the C:\Users\user_name\AppData\Local\Temp directory. user_name is your user name.

If you want to generate the log file in a different location, 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 your environment.

Important: If you specify a property value that includes a space, the value that you specify must be surrounded by double quotation marks that are prepended with a backslash (\"). For example, if you specify a directory for the log file that includes a space, you must enter the fully qualified path of the log file with the following format: \"C:\Program Files\IBM\NMO\InstallLog.txt\"

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 Tivoli® Access Manager for e-business 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`.
ADDLOCAL	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: `ADDLOCAL=value1,value2`. For your installation, you might enter: `ADDLOCAL=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`. Remember: If you instruct users to install IBM Content Navigator for Microsoft Office for all users on Windows Vista, Windows 7, or Windows 8, only the client machine administrator can edit the configuration.ini.
NMO_APPDATA	Optional You can use a central configuration.ini file to specify the URL by which you want users to access IBM Content Navigator. If you need to change the URL, you can update the central configuration.ini file without updating each IBM Content Navigator for Microsoft Office client. For more information, see Customizing the IBM Content Navigator for Microsoft Office interface. The NMO_APPDATA parameter can point to a shared directory or a mapped network drive. If the configuration.ini file is not found in the specified location, the default location for the configuration file is used: If you installed IBM Content Navigator for Microsoft Office for all users, the default directory is C:\ProgramData\IBM\Content Navigator for Microsoft Office. If you installed IBM Content Navigator for Microsoft Office for the current user, the default directory is C:\Users\`user_account`\AppData\Roaming\IBM\Content Navigator for Microsoft Office, where the `user_account` directory is the current user. Important: To use a central configuration.ini file, you must modify the configuration.ini file and place it in the directory that you specify for this parameter. The value that you specify is used as the path in the NMO_APPDATA environment variable. The parameter must have the following format: `NMO_APPDATA=\\location`. For your installation, you might enter: `NMO_APPDATA=\\my_location`. Restriction: Do not include a caret (^) in the value that you specify for the NMO_APPDATA parameter. Windows removes the character from the environment variable that is created by this parameter.
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`.