Overview: Share General Properties

The wrapper.share.<n>.* properties enhance the use of Windows shares with the Wrapper.

A common problem:

A common problem when running as Windows Service was that with Windows XP and Microsoft Windows Server 2003, each logon session receives its own set of drive letters, A through Z. Therefore, redirected drives cannot be shared between processes that are running under different user accounts. Additionally, a service (or any process that is running in its own logon session) cannot access the drive letters that are established in a different logon session. However, drive letters that are mapped from a service that is running under the local System account are accessible and visible to all logon sessions.

<n> component:

The "<n>" component of the property name is an integer number counting up from "1". By default, there can be no missing numbers. The wrapper.ignore_sequence_gaps property can optionally be set to allow gaps in the sequence.

wrapper.share.<n>.location

Compatibilidad :3.5.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Soportado)
Plataformas :WindowsMac OSX (No Soportado)Linux (No Soportado)IBM AIX (No Soportado)FreeBSD (No Soportado)HP-UX (No Soportado)Solaris (No Soportado)IBM z/OS (No Soportado)IBM z/Linux (No Soportado)

The location property sets the location of resource such as the Windows Share or Network Printer in UNC format.

Example:
wrapper.share.1.location=\\server\share

ADVERTENCIA

The specified location must NOT have a trailing backslash '\' or the mapping will fail.

NOTA

Please note that this property is mandatory and does not have a default value.

wrapper.share.<n>.target

Compatibilidad :3.5.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Soportado)
Plataformas :WindowsMac OSX (No Soportado)Linux (No Soportado)IBM AIX (No Soportado)FreeBSD (No Soportado)HP-UX (No Soportado)Solaris (No Soportado)IBM z/OS (No Soportado)IBM z/Linux (No Soportado)

The target property sets the target on the local machine to which the resource specified in wrapper.share.<n>.location property should get mapped to.

Example: (Map to a Network Drive)
wrapper.share.1.target=Y:

NOTA

Please note that this property is mandatory and does not have a default value.

wrapper.share.<n>.type

Compatibilidad :3.5.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Soportado)
Plataformas :WindowsMac OSX (No Soportado)Linux (No Soportado)IBM AIX (No Soportado)FreeBSD (No Soportado)HP-UX (No Soportado)Solaris (No Soportado)IBM z/OS (No Soportado)IBM z/Linux (No Soportado)

The type property specifies the type of network resource to connect to. The following values are possible:

  • DISK --specifies a Network Drive.
  • PRINTER --specifies a network printer.
  • ANY --the Wrapper will try to mount the resource with the specification open.

The default value is "ANY".

Example:
wrapper.share.1.type=ANY

wrapper.share.<n>.account

Compatibilidad :3.5.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Soportado)
Plataformas :WindowsMac OSX (No Soportado)Linux (No Soportado)IBM AIX (No Soportado)FreeBSD (No Soportado)HP-UX (No Soportado)Solaris (No Soportado)IBM z/OS (No Soportado)IBM z/Linux (No Soportado)

The account property is specified when users want to connect to a Network Resource for which they have been assigned a user name or account other than the default user name or account. If account is not specified, the Wrapper uses the account under which the Wrapper is running.

This property does not have a default value.

The naming conventions for this property are the same as for the wrapper.ntservice.account property.

Example:
wrapper.share.1.account=domain\user

NOTA

When running as a service under the LOCAL SYSTEM user, it is currently not supported to mount a remote resource under a different account. The property will be ignored (as well as the following password property).

wrapper.share.<n>.password

Compatibilidad :3.5.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Soportado)
Plataformas :WindowsMac OSX (No Soportado)Linux (No Soportado)IBM AIX (No Soportado)FreeBSD (No Soportado)HP-UX (No Soportado)Solaris (No Soportado)IBM z/OS (No Soportado)IBM z/Linux (No Soportado)

This property sets the password affiliated to the account property above.

If the account property hasn't been specified, this property will be ignored.

Example:
wrapper.share.1.password=<pass>

NOTA

When running as a service under the LOCAL SYSTEM user, it is currently not supported to mount a remote resource under a different account. The property will be ignored (as well as the above account property ).

Putting it all together

The following example will mount

  • .location: the share location '\\192.168.0.3\wrapper'
  • .target: as Network Drive 'Y:'.
  • .account: It will try to mount the drive with the credentials of the specified 'sample\user' account
  • .password: with the specified password.
  • .startup.premapped: If the drive 'Y:' has already been assigned, the Wrapper will try to 'CONTINUE'.
  • .startup.max_retries: If an error based on network troubles occurs, then the Wrapper will try to mount the Network Drive 5-times
  • .startup.retry_interval: with a delay between of each retry of 10 seconds.
  • .startup.failure: If a non-network related error occured or the network error persisted after the 5-times-retry, the Wrapper will SHUTDOWN itself.
  • .shutdown.unmap: If the Wrapper could mount the Network Drive, the Wrapper will UNMAP the Network Drive
  • .shutdown.unmap.force: with FORCE when shutting down.
Example:
wrapper.share.1.location=\\192.168.0.3\wrapper
wrapper.share.1.target=Y: 
wrapper.share.1.account=sample\user
wrapper.share.1.password=samplepass
wrapper.share.1.startup.premapped=CONTINUE
wrapper.share.1.startup.max_retries=5
wrapper.share.1.startup.retry_interval=10
wrapper.share.1.startup.failure=SHUTDOWN
wrapper.share.1.shutdown.unmap=TRUE
wrapper.share.1.shutdown.unmap.force=TRUE