ARCWAY Cockpit

Administration

Administrators have access to the menu items for creating and restoring backups of single projects or an entire server, releasing locks of a project and managing users and user groups. Tell me more about users and user groups...

Backups

Using the Cockpit Client to Create a Backup of the Server

To create a server backup with the help of a Cockpit Client select the item Server > Archive... in the client main menu. The following dialog gives an overview of all servers that can be archived. Select the desired server and enter a destination for storing the archive. Confirm your input with OK. Now all projects will be downloaded from the server and put into a zip file at the desired destination.

Using the Command Line Tool to Create a Backup of the Server

There is also a command line client available that can be used to create a server backup. This command line client does not require a Cockpit Client installation. Since it is completely implemented in Java it can be used on any Platform where a Java Runtime Environment (JRE 1.5 or higher) is installed.

Synopsis

java -jar cockpit-dump.jar -s serverurl -f Sicherungsdatei [-o y|n] [-u Benutzername -p Passwort]

-s serverurl
The url of the ARCWAY Cockpit Server to be dumped
e.g.: http://localhost:8080/CockpitServer/
-f dumpfile
The name of the file that shall be used to store the serverdump
e.g.: CockpitServerDump-20080509.zip
-o y|n overwrite the dumpfile if it already exists y: overwrite n: do not overwrite, but abort currently defaults to n
-u username
The name of the ARCWAY Cockpit Server User that will be used to log in to the ARCWAY Cockpit Server. This User must have sufficient privileges to create a server dump, i.e. the User must be the user 'Administrator', a member of the group 'Admin-istrators' or must have 'Operator' or 'Administrate System' Permission.
This parameter must be omitted if the ARCWAY Cockpit Server is configured for Single Sign-On.
-p password
The password of the ARCWAY Cockpit Server user specified by “–u”.
This parameter must be omitted if the ARCWAY Cockpit Server is configured or Single Sign-On.

Restoring a Backup of a Server

To restore a server backup select Server > Restore... from the Cockpit Client main menu. Select the server that shall be overwritten and the zip file that contains the server archive in the following dialog. Confirm your input with OK to restore the server with the help of the backup.

Creating a Backup of a Project

To create a project backup with the help of a Cockpit Client select the item Project > Ar-chive in the client main menu. The following dialog gives an overview of all projects that can be archived. Select the desired project and enter a destination for storing the archive. Confirm your input with OK. Now the selected project will be downloaded from the server and put into a zip file at the desired destination.

Restoring a Backup of a Project

To restore a project backup select Project > Restore... from the Cockpit Client main menu and select the zip file that contains the project archive in the following dialog.
It is possible to restore the archive as a new project or as stored within the file. Note that exist-ing projects of the same name will be overwritten when selecting the option as dumped. When selecting the option as new project a name for the project has to be entered.
Confirm your input with OK to restore the project with the help of the backup.

Deleting a Project

To permanently delete a project on a server, click Server→Delete Projects in the menu and select the project you wish to delete.

Note: When deleting a project on the server, all data will be lost. This operation cannot be undone!

It is recommended to create an update of the project prior to deleting it.

Locking

ARCWAY Cockpit uses a locking mechanism to prevent different users from interfering each other. Locks are automatically released when the modifications are commited to the server or when the modifications are discarded. Only in rare cases it becomes necessary to release the locks manually (e.g. when the computer on which the locks were requested has crashed). This can be done by clicking the menu entry Server→Remove Locks... and select the project for which you wish to release all locks.
Please note that users who are working with these locks will have to discard all their modifications instantly. Use this function only in exceptional situations when releasing the locks by commiting or discarding modifications is not possible!

Generate Snapshot of the Project

To create a snapshot of a project, select Project→Create Snapshot... in the menu and the project which you want to create a snapshot of. This will be automatically copied and saved as snapshot of the selected project on the server.
You can use this functionality to store preliminary project states on the server and open them at a later date. To open a snapshot you have to perform the same steps as if you were Getting a Project from a Server.