Maintenance Commands                              instancecfg(1M)


NAME
     instancecfg - create, delete, or  list  PC  NetLink  virtual
     server instances.

SYNOPSIS
     instancecfg [-a] [-l] [-d instance]

DESCRIPTION
     The instancecfg command will create  or  delete  PC  NetLink
     virtual servers, and list those that have been configured.

     An instance of a PC NetLink virtual server  functions  as  a
     single  PC  NetLink  server,  independently of other virtual
     servers running on the same Solaris machine.   Each  virtual
     server has its own set of datafiles, including a database of
     "shares", a user account database (SAM), and  an  ACL  data-
     base.   Each  may  optionally  be configured with its own IP
     address.

     A virtual server instance is created by the instancecfg com-
     mand.  The command allocates a number which is used to iden-
     tify the virtual server instance.  It prompts the user for a
     directory  path and creates the virtual server's data direc-
     tories and files in this path.  It then prompts the user for
     an  IP  address which will be the address used by Netbios to
     register  the  virtual  server  instance's  Netbios   names.
     Finally,  the  user  will be given the option of configuring
     the instance's server name, domain name, and role.

     If the SunCluster product is also configured on the  Solaris
     machine,  the user will be given the option of assigning the
     virtual server instance to a clustered logical host.  Confi-
     guring  the  instance  in  a  logical  host  will  allow the
     instance to move to another machine in the  cluster  if  the
     machine crashes or hangs.

     If there is more than one virtual  server  instance  config-
     ured,  PC  NetLink  commands must be given either the server
     name or number of the instance.  The instance may be  speci-
     fied  either on the command line or by the environment vari-
     able PCNL_INSTANCE.  If there is only one  instance  config-
     ured, it is not necessary to specify an instance while using
     PC NetLink commands.

OPTIONS
     The instancecfg command supports the following options:

     -a   Creates a  virtual  server  instance  and  invokes  the
          "joindomain" command which allows the user to configure
          the instance's server name, domain name, and role.

     -d instance
          Deletes a virtual server instance.  The  instance  must
          be  specified  by  number,  not  by  server  name.  The
          instance's "server" service must have been stopped.  In
          other  words, the daemons associated with this instance
          must not be  running.   The  data  maintained  by  this
          instance, such as the user account database (SAM), will
          be deleted.

     -l   Displays a list of configured virtual server instances,
          including  the  server  name,  the instance number, the
          pathname of the location of the datafiles.  If the sys-
          tem  is  running  on  a  Sun  Cluster, the logical host
          assigned to the instance is also displayed.



SEE ALSO
     joindomain(1),

NOTES