DriveWorks Pro 23

Groups

Groups

Groups show and control the groups that are registered to this Pro Server.

In order for a group to be used in other DriveWorks modules it will need to be registered and owned by this Pro Server, plus be in the same version of DriveWorks.

Groups can be added (registered) to this Pro Server using the following:

• Create Group
• Register Group
• Upscale Group

Groups can be removed (unregistered) to this Pro Server using Unregister Group.

Once Groups are registered, additional actions may be required to ensure they can be used:

• Upgrade Group
• Take/Force Ownsership

Create Group

This will create a new group that will be automatically registered and owned by this Pro Server.

Name: The name of the group that will be used for all DriveWorks modules. This name has the following requirements:

• The name must be unique
• It must begin with a letter or an underscore
• Can only contain numbers, letters, underscores, hyphens and spaces
• It cannot end with a hyphen or space
• 1 to 80 characters long

Initial Username: The user that will be made in the new group.

Initial Password: The password for the created user in the new group.

(Optional) Custom Database Settings - These settings allow the group database to be stored on a different SQL Server to the Pro Server Database and allow the name of the database to be different to the group name. See Custom Database Settings for more info.

Register Group

Register Group will add an existing shared group to this Pro Server and take ownership.

If this is owned by another Pro Server it does not take ownership automatically, you will need to manually Force Ownership.

If this group is registered in another Pro Server, it will remain there until unregistered.

Server Address: SQL Server Address where the group database is stored.

Trust Server Certificate: More information regarding this can be found at Certificate management (SQL Server Configuration Manager)

Authentication: Select the authentication method the SQL database has been set up to use.

• Windows (Recommended) or SQL Authentication.
• The user should have the correct permissions to access the SQL Server.
• See Authentication more information.

Database Name: The name of the shared group database in SQL.

Group Name: The name for the shared group as it will appear in Pro Server and DriveWorks modules. This must follow the same naming requirements as making a new group.

Database Status: Will show if there are any errors connecting to the SQL Server specified in the Server Address.

Upscale Group

Upscale Group will take an individual group and upscale it into a shared group within DriveWorks Pro Server.

This can be carried out here, or using the DriveWorks Group Upscale Tool.

How to Upscale using Pro Server

1. Select Choose File and browse for the individual group to upscale.
2. Enter the name for the new shared group. This must follow the same naming requirements as making a new group.
3. (Optional) Enable Custom Database Settings and configure. See Custom Database Settings for more info.
4. Press Upscale

Please refer to Obsolete Files for information related to the old .drivegroup file

Unregister Group

Unregister Group will remove the group from Pro Server, but the group database will remain in SQL.

The Group will not be owned by a Pro Server until ownership is taken see Take/Force Ownership.

Alternatively, if the group is no longer required, it can be deleted manually in SQL.

Upgrade Group

This will upgrade the selected group to the installed version of DriveWorks Pro Server.

The group must be owned by Pro Server to be upgraded.

This is irreversible, so we recommend taking a backup of your existing group before it's upgraded.

Please see How To: Backup a SQL Database for more information.

Take/Force Ownership

Take/Force Ownership can be used to ensure that a registered group is owned by this Pro Server.

This will allow the group to be used by DriveWorks modules, be upgrade and allow SSO to be configured.

Take Ownership will show when the group is registered and is not owned by a different Pro Server.

Force Ownership will show when the group is registered and is owned by a different Pro Server. If successful, it will remove the previous Pro Server as the owner and the current Pro Server will become the owner.

Group Information

Group Name

The name of the group. There is also an indicator for the current status of the group:

• Green: Connected
• Blue: Connecting
• Amber: Connected with a warning
• Red: Disconnected

Version

The version of the group. This corresponds to the major version of DriveWorks.

(Current) indicates that the version of the group is the same version of Pro Server.

Owner

The Owner of the group. This is the name of the machine that the group is hosted on.

(Current) indicates that the group is owned by this Pro Server.

SSO Enabled

Will show if SSO has been enabled for this group. See Single Sign-On for more information.

Status

More information about the status of the group, if it's not connected. Some examples are:

• Connecting: Connecting...
• Connected with a warning: This group is not upgraded to the latest version
• Connected with a warning: The group is not owned by the current instance
• Disconnected: Failed to connect to group