setup-tty

setup-tty is a script that installs SIMS and related files and packages onto the system.

---

Note - Because setup-tty is not installed on the target system, you must retrieve the setup-tty program from the distribution image and not from the system. On the CD, the setup-tty script can be found in /cdrom/sun_internet_mail_3_5/products/sims/setup-tty.

---

setup-tty's interface is considered to be "unstable." See attributes(5) for a description of interface stability.

Syntax

setup-tty [-c install | remove] [-d]

The options for this command are:

-c install	Specifies a standard install of SIMS and related files and packages.
-c remove	Specifies an uninstall of SIMS and related packages and files from the system.
-d	Specifies a non-interactive automated install using the /tmp/sims_setup.dat file, if it exists. If /tmp/sims_setup.dat does not exist, setup-tty will default to the standard interactive install and prompt the user for necessary information. See TABLE 2-1 for a description of the parameters included in the sims_setup.dat file.

Examples

The following command performs a standard interactive installation:

% setup-tty -c install

Execute the following to uninstall SIMS and related packages and files from the system:

% setup-tty -c remove

The following command:

% setup-tty -d

performs a non-interactive install which uses the file /tmp/sims_setup.dat if it exists. It will gather all necessary configuration data from the /tmp/sims_setup.dat file. If the file does not exist, setup-tty reverts to the interactive install, which prompts the user for necessary information. If /tmp/sims_setup.dat exists and setup-tty is executed without the -d option specified, the /tmp/sims_setup.dat file is removed and the interactive install continues

sims_setup.dat File

The following table describes the parameters included in the sims_setup.dat file. The sims_setup.dat file can be provided by the user when the -d option is specified in the setup-tty command.

TABLE  2-1   sims_setup.dat File

Parameter	Description
do_upgrade	Specifies whether or not to upgrade to SIMS 3.5 (1=upgrade, 0=do not upgrade).
upgrade-possible	Specifies whether the current system is upgradable and which SIMS product package it is (0=not upgradable, 1=upgradable departmental, 2=upgradable enterprise).
install-mode	Specifies which SIMS product package to upgrade (1=Departmental, 2=Enterprise, 3=add-on/standalone).
remote-ldap	Determines where the LDAP server is located (0=local host, 1=not local).
calendar	Determines whether or not to install the calendar option (0=do not install, 1=install).
webaccess	Determines whether or not to install the WebAccess option (0=do not install, 1=install).
hjviews	Determines whether or not to install the HotJava Views option (0=do not install, 1=install).
ha_install	Determines whether or not to install the High Availability option. (0=do not install, 1=install).
ha_master	The logical hostname of the HA master host.
ccmail	Determines whether or not to install the cc:Mail channel option (0=do not install, 1=install).
msmail	Determines whether or not to install the Microsoft Mail channel option (0=do not install, 1=install).
profs	Determines whether or not to install the PROFS channel option (0=do not install, 1=install).
remadmin	Determines whether or not to install the remote administrator option (0=do not install, 1=install).
standalone	Determines whether or not SIMS is already installed (0=SIMS already installed, 1=SIMS not installed).
sdk	Determines whether or not to install the SIMS SDK (0=do not install, 1=install).
sdk-doc	Determines whether or not to install the documentation for the SIMS SDK (0=do not install, 1=install).
select-options	Specifies whether or not any options have been selected to install (0=no options selected, 1=HA option only, 2=at least one option selected).
readfromfile	Determines whether or not the directory server license will be read from a local file (0=no, 1=yes).
filename	Name of the file that contains the SIMS license.
hostname	Name of the local host that contains the directory server license.
redundantservers	Name of the redundant license server.
install-lic	Determines whether or not to install the directory server license (0=do not install, 1=install).
install-sws	Determines whether or not to install the Sun web server (0=do not install, 1=install).
maildomain	The mail domain.
rootdomain	The root domain.
mta-role	Determines if the IMTA is installed behind the firewall (0=not behind firewall, 1=behind firewall).
varmail	Determines whether or not the /var/mail message store is supported (0=not supported, 1=supported).
postmaster	The postmaster's ID.
postmaster_uid	The postmaster's UID.
country	The country code.
org-name	The organization code.
smarthost	Has a text string value only if mta-role=1 (behind the firewall).
oux	The descriptive name for the organizational unit. x is a numerical value starting with 1 and continuing up 6 units.
oux-domain	The domain for the organizational unit. x is a numerical value starting with 1 and continuing up to 6 units.
province	The name of the province. This is a text entry.
locality	The name of the locality. This is a text entry.
postal-address	The postal address. This is a text entry.
phone-number	The phone number. This is a text entry.
fax-number	The fax number. This is a text entry.
org-name-long	The name of the organization. This is a text entry.
ldap-server	Hostname of the LDAP master server.
ldap-port	The LDAP port number.
mmad-port	The MMAD port number.
smcs-domain	The domain name of the Sun Messaging Connectivity Services (SMCS) server.
smcs-domain-dns	The name of the DNS for SMCS.
smtp-port	The SMTP port number.
alias-format	Alias format of the SMCS-IN channel.
alias-format-str	The user-entered alias format string.
document-root	The location of the document root for the Sun Web Server.
cgi-bin	The location of the CGI bin directory for the HotJava Views server.
ha_masterlhost	The logical host name for the HA installation.
ha_sharedfs	The shared disk location for the HA installation.
administrator-name	The user name for the administrator.
administrator-passwd	The password for the administrator.