When installing an application on a terminal server it is necessary to change the server to install mode by running “change user /install” from a command prompt or by performing the install through “Add/Remove Programs.” After the installation you must run “change user /execute” to bring it out of install mode. This ensures that the .ini files for the installed application are stored in the Terminal Server system directory. These files are used as the master copies for the user-specific .ini files.
Why is this important? When a user runs an application for the first time, the application looks in the home directory for its .ini files. If it does not find them in the home directory it will look in the Terminal Server system directory and copy them to the user’s home directory. If an application is installed while the server is not in install mode, the .ini files will be saved to the home directory. New users will therefore be unable to pull down the .ini files from the Terminal Server system directory, and the application will not run.
Change Terminal Server Session properties, use when installing software on a terminal server.
CHANGE USER /options
CHANGE LOGON /options
CHANGE PORT /options
To change .INI file mapping: (administrator rights required)
CHANGE USER /INSTALL Enable install mode. This command has to be run before
installing any new software on a Terminal Server.
This will create a .ini file for the application
in the TS system directory.
CHANGE USER /EXECUTE Enable execute mode (default)
Run this when an installation is complete.
CHANGE USER /QUERY Display current settings.
To enable or disable terminal session logins:
CHANGE LOGON /QUERY Query current terminal session login mode.
CHANGE LOGON /ENABLE Enable user login from terminal sessions.
CHANGE LOGON /DISABLE Disable user login from terminal sessions.
To list or change COM port mappings for the current session.
This can allow DOS applications to access high numbered ports e.g. COM12
CHANGE PORT portx=porty Map port x to port y.
CHANGE PORT /D portx Delete mapping for port x.
CHANGE PORT /QUERY Display current mapping ports.
How .ini files work:
Installing an application will create a .ini file in the TS system directory.
The first time a user runs the application, the application looks in the home directory for its .ini file. If none is found then Terminal Server will copy the .ini file from the system directory to the users home directory.
Each user will have a unique copy of the application’s .ini file in their home directory.
To learn more about what happens when the system is put into install mode run CHANGE USER /?
The CHANGE command replaces CHGLOGON, CHGUSER, and CHGPORT from Citrix Winframe.