INSTALLING


Setting up Lotus Notes installation using scriptable setup
The scriptable setup option uses the CONFIGFILE= setting in the NOTES.INI file to provide user information for the setup phase of the Lotus Notes installation program.

The CONFIGFILE= setting in the NOTES.INI file points to a text file (for example ConfigFile=C:\Program Files\Lotus\Notes\Data\setup.txt) that contains the Lotus Notes users' setup parameters that you want to pass to the installer for use in configuring th euser after installation is complete. The Lotus Notes installer processes the contents of this file to complete the user's setup. The user is able to bypass any install screen panels or prompts for which parameters have been provided in the setup.txt file.

The settings that you can configure in the text file are as follows:

Note: For more information about using scriptable setup, see "Example: Applying scriptable setup using a transform file during Lotus Notes install" and Lotus Tech Note 1112835 "How to set up a Notes client without user intervention using a scriptable setup."

Note: Support for direct dialup modem (X.PC) connections is not available after Domino 8.5.

Table1. Configurable text file settings
SettingDescription
UsernameUser's hierarchical name -- for example, John Smith/Acme
KeyfileNameDirectory path to the user's ID file name --for example, c:\program files\lotus\notes\data\jsmith.id
Domino.NameDomino server in the same domain as the user name. You do not need to enter a hierarchical name.
Domino.AddressAn address for the IBM Lotus Domino server, such as the IP address of the server, if needed, to connect to the server. For example, server.acme.com or 123.124.xxx.xxx
Domino.PortPort type, such as TCPIP
Domino.Server1 to connect to the Domino server, 0 for no connection
AdditionalServices1 forces display of the "Additional Services" panel even if sufficient information is provided for these services; the Additional Services panel lists Internet, proxy, and replication settings.
AdditionalServices.NetworkDialTo configure a network dialup connection to Internet accounts created via Additional Services dialog box
Mail.Incoming.NameIncoming mail account name, a friendly name used to refer to these settings
Mail.Incoming.ServerIncoming mail (POP or IMAP) server name
Mail.Incoming.Protocol1 for POP; 2 for IMAP
Mail.Incoming.UsernameMail account user name or login name
Mail.Incoming.PasswordMail account password
Mail.Incoming.SSL0 to disable; 1 to enable the SSL protocol for incoming Internet mail
Mail.Outgoing.NameOutgoing mail account name, a friendly name used to refer to these settings
Mail.Outgoing.ServerOutgoing mail (SMTP) server name
Mail.Outgoing.AddressUser's Internet mail address, such as user@isp.com
Mail.InternetDomainInternet Mail domain name such as isp.com
Directory.NameDirectory account name, a friendly name used to refer to these settings
Directory.ServerDirectory (LDAP) server name
News.NameNews account name, a friendly name used to refer to these settings
NetworkDial.EntryNameName of remote network dialup phone book entry
NetworkDial.PhonenumberDial-in number
NetworkDial.UsernameRemote network user name
NetworkDial.PasswordRemote network password
NetworkDial.DomainRemote network domain
DirectDial.PhonenumberPhone number of Domino server
DirectDial.PrefixDialup prefix, if required. For example, 9 to access an outside line.
DirectDial.PortCOM port to which the modem is connected
DirectDial.ModemFile specification of modem file
Proxy.HTTPHTTP proxy server and port -- for example, proxy.isp.com:8080
Proxy.FTPFTP proxy server and port -- for example, proxy.isp.com:8080
Proxy.GopherGopher proxy server and port -- for example, proxy.isp.com:8080
Proxy.SSLSSL proxy server and port -- for example, proxy.isp.com:8080
Proxy.HTTPTunnelHTTP tunnel proxy server and port -- for example, proxy.isp.com:8080
Proxy.SOCKSSocks proxy server and port -- for example, proxy.isp.com:8080
Proxy.NoneNo proxy for these hosts or domains
Proxy.UseHTTPUse the HTTP proxy server for FTP, Gopher, and SSL security proxies
Proxy.UsernameUser name if logon is required
Proxy.PasswordUser password
Replication.ThresholdTransfer outgoing mail if this number of messages held in local mailbox
Replication.ScheduleEnable replication schedule
IM.ServerLotus Instant messaging server name required unless you have set the NOTES.INI variable IM_NO_SETUP= 1.

When this variable is set to 1, the IM Configuration dialog box does not display during new client setup or client upgrade, and all IM variables in a scriptable client setup are ignored. If the user wants to configure IM, they can leave the NOTES.INI variable out of their NOTES.INI file or set it to 0 (IM_NO_SETUP=0).

IM.PortIBM Lotus Instant Messaging server port (any positive number)
IM.ConnectWhen(Optional setting) Defines when to connect to Instant Messaging:
  • 0 -- At Notes login (default)
  • 2 -- Manually
IM.ProtocolUse one of these:
  • 0 -- Directly to Lotus Instant Messaging server
  • 1 -- Directly to Lotus Instant Messaging server using HTTP protocol
  • 2 -- Directly to Lotus Instant Messaging server using IE HTTP settings
  • 3 -- Use a proxy
IM.ProxyTypeRequired if IM.Protocol is set to 3. Use one of these:
  • 0 -- SOCKS4 Proxy
  • 1 -- SOCKS5 Proxy
  • 2 -- HTTPS Proxy
  • 3 -- HTTP Proxy
IM.ProxyServerRequired if IM.Protocol is set to 3. Name of Lotus Instant Messaging proxy server
IM.ProxyPortRequired if IM.Protocol is set to 3. Port of Lotus Instant Messaging proxy server (any positive number)
IM.ServerNameResolveOnly used if IM.ProxyType is 1 (SOCKS5) but it is not required. Use one of these values:
  • 0 -- Disable IM.ServerNameResolve
  • 1 -- Enable IM.ServerNameResolve
IM.ProxyUsernameRequired if IM.Protocol is set to 3 and IM.ProxyType is not SOCKS4

Sample scriptable setup file

This is a sample scriptable setup file for a LAN connection. All options are used in this sample file. Username = Joe Employee

KeyFileName=G:\shareddrive\userid\jemployee.id

Domino.Server=1

Domino.Name=servername/domain (For example, server1/sales/enterprise)

Domino.Port=TCP/IP

IM.Server=servername.misc.domain.com

IM.Port=12345

IM.ConnectWhen=2

IM.Protocol=3

IM.ProxyType=2

IM.ProxyServer=sametimeproxy.domain.com

IM.ProxyPort=789

IM.ServerNameResolve=0

IM.ProxyUsername=joeemployee

AdditionalServices=0

Mail.Incoming.Protocol=2

Mail.Incoming.Name=INCOMING INET MAIL

Mail.Incoming.Server=servername.misc.domain.com

Mail.Incoming.Username=jemployee

Mail.Incoming.Password=xyz123

Mail.Incoming.SSL=0

Mail.Outgoing.Name=OUTGOING INET MAIL

Mail.Outgoing.Server=servername.misc.domain.com

Mail.Outgoing.Address=joeemployee@domain.com

Mail.InternetDomain=misc.domain.com

AdditionalServices.NetworkDial=1

NetworkDial.EntryName=TEST 1 Dial-up Connection

NetworkDial.Username=jemployee

NetworkDial.Password=xyz123

NetworkDial.Phonenumber=area code-phone-number (For example, 508-123-4567)

NetworkDial.Domain=domainname

News.Name=NEWS SERVER ACCOUNT

News.Server=server.domain.com

Directory.Name=LDAP DIRECTORY SERVER ACCOUNT

Directory.Server=name.misc.domain.com

Proxy.UseHTTP=0

Proxy.HTTP=proxy.domain.com:8080

Proxy.FTP=proxy.fake.com:8080

Proxy.Gopher=proxy.fake.com:8080

Proxy.SSL=proxy.fake.com:8080

Proxy.SOCKS=proxy.domain.com:1080

Proxy.HTTPTunnel=proxy.domain.com:8080

Proxy.None=domain.com

Replication.Threshold=3

Replication.Schedule=1

Related concepts
Customizing Lotus Notes installation
Automating a customized or default Notes deployment using silent install
Example: Sharing command line utilities for installing Lotus Notes

Related tasks
Example: Applying scriptable setup using a transform during Lotus Notes install
Obtaining a tuner and creating a transform file to customize Lotus Notes installation
Example: Creating and providing a batch file for Lotus Notes silent install