r12 - 18 Feb 2010 - 17:30:18 - ApoorvaKulkarniYou are here: Wiki >  AppLogic27 Web > RefWinCfg
ALERT! AppLogic 2.7/2.8 Documentation The latest production release is AppLogic 3.0.30

wincfg Reference

Overview

The wincfg utility makes it easy for AppLogic users to change the SID, Computer Name and Administrator password for a running Windows appliance from the AppLogic command line shell. wincfg starts the application that contains the appliance if it is not already started.

Important:

  1. The NewSID utility is no longer provided by Sysinternals. Please visit the following wesbites to read further.
  2. It is assumed that the targetted Windows appliance has the NewSID utility installed in it for the purpose of changing the SID (wincfg prompts the user to download and install NewSID into their Windows appliance). You may obtain NewSID from a source known to you, or use either of the following alternate sources:
  3. The appliance must have ssh access enabled through the default interface (typically ssh access is through port 22; enabling the windows firewall may block port 22 by default).

Invocation

Command Syntax

Description: Configure a Windows appliance
Syntax: util wincfg name=app_name:comp_name computer_name= name admin_pw=- --newsid
Arguments: name=app_name:comp_name Name of appliance to configure in the form application_name:component_name
computer_name=name New computer name of the appliance
admin_pw=- The password can be set either directly, by supplying the password string on the command line, or typed to a 'shadow-display' password prompt that does not reveal the entered characters. The shadow entry option is selected by using a single '-' character as the password, i.e. admin_pw=-. The admin_pw=- option should ALWAYS be used to prevent others from potentially seeing the password by hitting the up arrow key.
--newsid Change the SID of the appliance.
Examples: util wincfg name=tst-windows:main.WIN03S computer_name=WIN03TST - Change Computer Name of the Windows appliance to WIN03TST
util wincfg name=tst-windows:main.WIN03S admin_pw=- - Change Administrator password for the Windows appliance.
util wincfg name=tst-windows:main.WIN03S --newsid - Change SID for the Windows appliance
util wincfg name=tst-windows:main.WIN03S computer_name=WIN03TST admin_pw=- - Change Computer Name and Administrator password for the Windows appliance.
util wincfg name=tst-windows:main.WIN03S computer_name=WIN03TST --newsid - Change Computer Name and SID of the Windows appliance.
util wincfg name=tst-windows:main.WIN03S admin_pw=- --newsid - Change Adminstrator password and SID of the Windows appliance.
util wincfg name=tst-windows:main.WIN03S computer_name=WIN03TST admin_pw=- --newsid - Change Computer Name and SID of the Windows appliance.
Notes: wincfg is invoked in the AppLogic command line shell using util wincfg. Help is displayed using help util wincfg.
The option --yes or -y can be added to answer yes to all questions.
If the application was stopped before the command was executed, then wincfg will ask if the application should be started.
* If the answer is yes, then the application is started and the required changes are made. After the appliance is restarted for the changes to take effect, the user is asked if the application should be kept running or shut down.
* If the answer is no, then wincfg performs no action and returns success.
In order for the new SID or computer name changes to take effect the appliance needs to be restarted. Once wincfg changes any of these properties, it will ask the user if it wants to restart the appliance.
* If the user answers no, then it is up to the user the restart the appliance.
* If the user answers yes, the appliance is restarted.
If the application is running and the appliance is stopped, the user is asked whether the appliance should be started.
* If the answer is yes, the appliance is started, the changes are applied and the user is asked whether the appliance should be left running or shut down
* If the answer is no, wincfg performs no action and returns success.

-- ApoorvaKulkarni - 23 Oct 2008

 
Copyright © CA 2005-2011. All Rights Reserved.
%