casecenter 2.2 sp2 admininstrator's guide · ldap lightweight directory access protocol – an...

CC2.2SP2-AG-EN Rev1

CaseCenter 2.2 SP2Administrator’s Guide

May 7, 2013Rev. 1

CaseCenter 2.2 SP2 Administrator’s Guide

ContentsDisclaimer....................................................................................................................................5

Character Types and Symbols.......................................................................................................7

Terms and Abbreviations..............................................................................................................8

1 Introduction..............................................................................................................................9

1.1 Structure of the CaseCenter......................................................................................................9

1.2 HUB..........................................................................................................................................10

1.3 Service Unit..............................................................................................................................10

1.4 Configuring a Distributed Network System.............................................................................10

1.5 Folder hierarchy.......................................................................................................................131.5.1 Folder Color Markings....................................................................................................................................141.5.2 Folder option buttons.....................................................................................................................................14

2 Installation..............................................................................................................................18

2.1 System Requirements..............................................................................................................18

2.2 Server Configuration................................................................................................................19

2.3 Installing MySQL Server 5.5.....................................................................................................22

2.4 Creating and Upgrading SQL Users..........................................................................................31

2.5 Installing the HUB and the SU..................................................................................................32

2.6 Installing the SU.......................................................................................................................47

3 Managing Users and Groups....................................................................................................61

3.1 Add User or Group...................................................................................................................61

3.2 Edit User or Group Data...........................................................................................................63

3.3 Remove User or Group............................................................................................................65

3.4 LDAP Users and Groups...........................................................................................................65

4 Add and Remove Language.....................................................................................................67

4.1 Edit \config.inc.php..................................................................................................................67

4.2 Adding National Flags..............................................................................................................67

4.3 Create the Language Dictionary...............................................................................................67

4.4 Set or Edit \email.php..............................................................................................................68

5 Manage Service Units..............................................................................................................69

5.1 Add SU......................................................................................................................................69

5.2 Edit SU......................................................................................................................................69

5.3 Remove SU...............................................................................................................................70

May 7, 2013 – Rev. 1 3DHISTECH Ltd. 2(140)


6 SU and HUB Server Management............................................................................................71

6.1 SU/HUB Server Data Backup....................................................................................................716.1.1 Slide-related information and data backup....................................................................................................716.1.2 Result..............................................................................................................................................................71

6.2 Restoring the HUB Database Backup.......................................................................................726.2.1 Copying folders...............................................................................................................................................736.2.2 Restoring the database...................................................................................................................................73

6.3 Restoring the SU Database Backup.........................................................................................746.3.1 Restoring the database...................................................................................................................................74

6.4 Complete Restoration (SU-HUB)..............................................................................................75

7 Manage Slides.........................................................................................................................76

7.1 SU storage management..........................................................................................................767.1.1 Add new storage.............................................................................................................................................797.1.2 NAS storage usage..........................................................................................................................................797.1.3 DAS, SAN or local storage usage.....................................................................................................................807.1.4 Storage editing...............................................................................................................................................807.1.5 Requirements and and recommendations.....................................................................................................81

7.2 Scan to Server..........................................................................................................................82

7.3 Upload slides with Pannoramic Viewer...................................................................................82

7.4 Import slides............................................................................................................................83

7.5 Slide- and user-related maintenance.......................................................................................867.5.1 Statistics..........................................................................................................................................................867.5.2 Service Units...................................................................................................................................................877.5.3 Problematic slides..........................................................................................................................................887.5.4 Slides in progress............................................................................................................................................887.5.5 Log..................................................................................................................................................................897.5.6 HIS Log............................................................................................................................................................897.5.7 Enums.............................................................................................................................................................907.5.8 Settings...........................................................................................................................................................907.5.9 Column customization....................................................................................................................................987.5.10 Database Backup..........................................................................................................................................99

8 Web Services.........................................................................................................................100

9 CaseCenter – HIS/LIS Message Communication.....................................................................112

9.1 Messages from HIS/LIS to CaseCenter...................................................................................113

9.2 CaseCenter messages towards HIS/LIS..................................................................................116

9.3 Case-based Integration..........................................................................................................119

10 Slide consistency checker, Lost and Found folder.................................................................122

11 CaseCenter Lightweight Directory Access Protocol (LDAP) Implementation..........................125

11.1 LDAP user import.................................................................................................................125

11.2 LDAP group import..............................................................................................................126



11.3 LDAP user login and function...............................................................................................127

12 Troubleshooting..................................................................................................................129

Appendix A – Communication Message Definition CC2LIS........................................................131

Appendix B – Communication Message Definition LIS2CC........................................................136

Index........................................................................................................................................140



Disclaimer

Copyright © 2001-2013 3DHISTECH Ltd.All Rights Reserved

Intellectual property related to the 3DHISTECH products are as follows:

EP 1,789,831; US 7,663,078; EP 2,024,772; JP 2009-512685; US 12/301,781; EP 1,644,767; JP 2007-516451; US7,327,515; EP 1,994,398; JP 2008-557835; US 12/281,566; U0700210; US 6,246,785; HU0900142; HU0700404; PCT/HU2007/000065; EP 08762668.5; US 12/663,537; PCT/AT2006/000492; JP 2008-542552; EP 06817469; US 12/095,545; PCT/AT2006/000493; EP 06817470.5; US 12/095,596; HU0900741; US 61/264,732; US 11/826,752; P0401870; PCT/IB2005/050344; US 11/662,976; HU0700409; US 12/042,050; US 77/636,144 and 007502032.

The above mentioned granted patents, granted utility model, registered trademarks, pending international and national patent applications and the other corresponding IP are the sole properties of the 3DHISTECH Ltd.

3DHISTECH Ltd. is not liable for damage of whatever nature (including, but not limited to, general or specific damage, indirect damage, consequential damage or incidental damage, including the results of the analysis of the digitized slides, for example, change of health status related to erroneous diagnosis from the digitized slide(s)) that stems from or is associated with use of Product, digitized slides, quality of staining, quality of stained slides, quality of used method of staining. 3DHISTECH Ltd. assumes no responsibility for the functionality and fault-free condition of your “application programs” (Workflows, VBA macros, Commander scripts).

CAUTION

For research and education uses only, not for use in diagnostic procedures. This product has not been approved or cleared as a medical device by the U.S. Food and Drug Administration, nor any other regulatory authority. The data and images obtained or viewed using this product are not intended for clinical or diagnostic use.

For performance evaluation only, the performance characteristics of this product have not been established.



Third-Party Disclaimer (LibTIFF – TIFF Library and Utilities)

3DHISTECH Ltd. is not liable for damage of whatever nature (including, but not limited to, general or specific damage, indirect damage, consequential damage or incidental damage, including damage resulting from lost profits, interruption of business, loss of business information, pecuniary loss or similar damage) that stems from or is associated with the incorporated part of this Product that is made by Silicon Graphics Inc.

THE SOFTWARE IS PROVIDED “AS IS” AND WITHOUT WARRANTY OF ANY KIND, EXPRESSED, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR FOR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Further Information

For the latest information on 3DHISTECH products and services, please visit our website at: http ://www.3dhistech.com .

29-33 Konkoly-Thege Miklós street, Building 6Budapest1221 – HUNGARY


http://www.3dhistech.com/http://www.3dhistech.com/


Character Types and Symbols

Example Abbreviation or term that is explained in section Terms and Abbreviations.

Example Words or characters that appear on the screen. These include field names, screen titles, pushbuttons and menu names, paths or options.

Keys on the keyboard. For example, function keys (such as F11) or the Ctrl+O key combination.

Example Cross-references to other documents or sections within this document.

Warning!Indicates that you need an additional module to use the feature or that there are prerequisites for the task.

Important!Contains an important piece of information or a recommendation. The application will work if you choose not to follow the recommendation but its performance might be less than optimal.

Tip!Contains a suggestion about using the application in some other way or to some interesting purpose.



Terms and Abbreviations

Annotation A particular detail of a digitized slide.

Host User who uploaded the digital slide to CaseCenter and who initiates the Teleconsultation about the slide.

CaseCenter user group Group created by a CaseCenter administrator.

LDAP Lightweight Directory Access Protocol – an Internet protocol for accessing distributed directory services that act in accordance with X.500 data and service models.

OLDAP OpenLDAP – open source implementation of the LDAP

Participant User invited to participate in the evaluation of a slide stored on a CaseCenter server.

Teleconsultation Provides access to digitized slides for several users and supports their collaboration in inspecting and evaluating the virtual slide.

Teleconsultation group Group created by the Host for a Teleconsultation session independently of the user groups that exist on CaseCenter.

Several Teleconsultation sessions (and therefore several Teleconsultation groups) can be activated on a CaseCenter server in parallel.

Telepathology Teleconsultation in the field of pathology: pathologists exchange information and evaluate a slide together via Teleconsultation.


CaseCenter 2.2 SP2 Administrator’s Guide 1 Introduction

1 Introduction The system supports the following two protocols for accessing the slides:

1. Microsoft Network protocol (SMB/CIFS), if the connection satisfies the standards below:

• If using IPV4: RFC 1918 standard, section P r ivate IPV4 ad d ress sp ac es , or the IPs are different only in their class D addresses.

• If using IPV6: RFC 4193 standard, section Unique local address.

2. HTTP/HTTPS

Install the scanner – SU (as an external storage) – client within the same facility, and this order if possible, since the HTTP overhead can highly decrease the speed of scanning and communication.

It is recommended for you to connect through HTTPS (HyperText Transfer Protocol over SSL) that is a TCP/IP protocol used by Web servers to transfer and display Web content securely. The data transferred is encrypted so that it cannot be read by anyone except the recipient.

1.1 Structure of the CaseCenter

CaseCenter is part of the 3DHISTECH product family that supports tasks in the routine and research workflow of pathologists. It is a platform for managing slides, cases, and other documentations. The figure below demonstrates how slides can be stored and managed on a designated CaseCenter server.


http://en.wikipedia.org/wiki/Unique_Local_Addresshttp://tools.ietf.org/html/rfc4193http://en.wikipedia.org/wiki/Private_network#Private_IPv4_address_spaceshttp://en.wikipedia.org/wiki/Private_network#Private_IPv4_address_spaceshttp://en.wikipedia.org/wiki/Private_network#Private_IPv4_address_spaceshttp://en.wikipedia.org/wiki/Private_network#Private_IPv4_address_spaceshttp://en.wikipedia.org/wiki/Private_network#Private_IPv4_address_spaceshttp://en.wikipedia.org/wiki/Private_network#Private_IPv4_address_spaceshttp://tools.ietf.org/html/rfc1918

CaseCenter 2.2 SP2 Administrator’s Guide 1.1 Structure of the CaseCenter

Important!

Operating system components in different time zones is not supported.

1.2 HUB

The HUB itself consists of two main parts: a database and the web surface. Database is for storing metadata of slides, the web surface is through which you can access and manage slide metadata. Accordingly, the VIMMEET.EXE application, which enables the usage of the Teleconsultation function, runs from the HUB as well.

1.3 Service Unit

A Service Unit (SU) is an element of CaseCenter where slides can be physically stored and slide processes take place. Storage can be added to the SUs on the network. Users who have registered on the server (registration is performed by the server administrator) can manage and use their slides on the server in the following ways:

• Upload slides or scan directly to the server.

• Arrange slides in folders, for example, group slides according to their staining types or your research projects.

• Share slides with other users who:

◦ have account on the same CaseCenter (and can therefore access your slide on the server or if you share the slide with them explicitly).

◦ can access the slide via E-School.

• Invite other users into Teleconsultation sessions to discuss slides.

• Participate in Teleconsultation sessions initiated by another user.

• Search for slides.

1.4 Configuring a Distributed Network System

The below configuration method of a distributed network system allows you to use Microsoft Server Message Block Protocol within a LAN. This way such a system can be built, where slides will be registered on the HUB, the HUB and the SU communicate with each other via a HTTP or HTTPS connection (for example, they are located at different sites).


CaseCenter 2.2 SP2 Administrator’s Guide 1.4 Configuring a Distributed Network System

A LAN connection is ensured for the SU–Scanner and the local users; therefore, slides stored on the local SU can be accessed more quickly, and the speed of scanning is increased accordingly.

There are two ways to configure a distributed network system:

1. There is no Client #2 (7) or Slide Scanner #2 (8) (no client which should access CaseCenter outside of the LAN):

NOTE: No special configuration is required. Either NETBIOS name, local IP address, or FQDN (Fully Qualified Domain Name) can be used during the installation procedure of CaseCenter. No Public DNS (9) is required.

• The HUB (1), the SU (2) and the Slide Storage (3) can be on the same machine, or all other distribution is accepted (for example, SU (2) and Slide Storage (3) on the same machine, and the HUB (1) on an other).

• To enable LAN slide access instead of HTTP slide access you have to specify all the “Slide store directories” in “Service Unit Settings” on the SU (2) with UNC name. (\\NETBIOS_NAME_OF_THE_STORAGE\ SHARE \further path ). In the UNC name there can be either a local IP address, NETBIOS, or FQDN.

• You should use NETBIOS names everywhere during the installation and further configuration. This is also recommended on Slide Scanner #1 (5) and Client #1 (6).

2. There is Client #2 (7) and/or Slide Scanner #2 (8) (there is one or more client which should access CaseCenter outside of the LAN):

NOTE: FQDN must be used during the installation of CaseCenter.

• The HUB (1), the SU (2) and the Slide Storage (3) can be on the same machine, or all other distribution is accepted (for example, SU (2) and Slide Storage (3) on the same machine, and the HUB (1) in on an other). Ensure that the Storage is accessible through SMB Protocol from the SU.


file:///D:/Data/svn/modules/%5C%5CNETBIOS_NAME_OF_THE_STORAGE%5CSHARE%5B%5Cfurther%20path%5Dfile:///D:/Data/svn/modules/%5C%5CNETBIOS_NAME_OF_THE_STORAGE%5CSHARE%5B%5Cfurther%20path%5Dfile:///D:/Data/svn/modules/%5C%5CNETBIOS_NAME_OF_THE_STORAGE%5CSHARE%5B%5Cfurther%20path%5D

CaseCenter 2.2 SP2 Administrator’s Guide 1.4 Configuring a Distributed Network System

• If the HUB (1) and the SU (2) are on the same machine you must have one public/physical IP address and a registered FQDN for it. If the HUB (1) and the SU (2) are two separate machines you must have two public/physical IP addresses and registered FQDN for them. Storage does not require FQDN and public IP.

• You must link the one or the two public IP address to the Router (4).

• You must configure the Router (4) to do “port forwarding” on TCP/HTTP (80) and TCP/HTTPS (443) ports from the public IP address(es) to the local/private IP address(es) of the HUB (1) and the SU (2).

Important!

Some Anti-Virus applications (embedded gateway Anti-Virus solutions, such as the Juniper-Kaspersky’s Deep Inspection Firewall) may filter and block packets during the communication between client and server. In such cases, turn off virus scanning of HTTP packets besides allowing incoming connections on TCP port 80.

• If you already have a public domain name (for example, 3dhistech.com) with a public Domain Name Server (9), you could register HUB (1) and SU (2) as a sub-domain of your existing public domain name.

• If you do not have a public domain name in a Public Domain Name Server (9), then you have to purchase one for the HUB and one for the SU.

• If there is a Local DNS server (10), then set local IP addresses of HUB and SU for the FQDN. LAN clients must use this address as primary DNS.

• If you do not have a Local DNS server (10), you can use the HUB (1) or the SU (2) (Windows Server 2008 R2) as a Local DNS server (10), and you can configure it as shown above. In this case you must ensure that all the clients on the LAN use this DNS as primary DNS. You can do this to simply configure your DHCP server to advertise that DNS as primary DNS. (If you do not have DHCP server on your LAN you can use W2k8 R2 also as a DHCP server).

• To enable LAN slide access instead of HTTP slide access you have to specify all the “Slide store directories” in “Service Unit Settings” on the SU (2) with a UNC name. (\\NETBIOS_NAME_OF_THE_STORAGE\ SHARE \further path ). In the UNC name there can be either local IP address, NETBIOS, or FQDN.

• Slide Scanner #1 (5) and the Client #1 (6) can access it via NETBIOS name or local IP, but the Client #2 (7) and the Slide Scanner #2 (8) cannot (regardless of using NETBIOS or FQDN).

• You must use FQDN everywhere during the installation and further configuration (except in UNC path names of slide store). This is also recommended on the Slide Scanner #1 (5) and the Client #1 (6) (at the client side), and must do on remote clients, Client #2 (7) and the Slide Scanner #2 (8).


file:///D:/Data/svn/modules/%5C%5CNETBIOS_NAME_OF_THE_STORAGE%5CSHARE%5B%5Cfurther%20path%5Dfile:///D:/Data/svn/modules/%5C%5CNETBIOS_NAME_OF_THE_STORAGE%5CSHARE%5B%5Cfurther%20path%5Dfile:///D:/Data/svn/modules/%5C%5CNETBIOS_NAME_OF_THE_STORAGE%5CSHARE%5B%5Cfurther%20path%5D

CaseCenter 2.2 SP2 Administrator’s Guide 1.5 Folder hierarchy

1.5 Folder hierarchy

The tree structure of the server can be seen on the left side of the panel, where the actual folder is marked with blue background.

Hierarchically, the Case is a sub-level element within a folder, and the Block is a sub-level element of a Case. You can create several cases within a folder and several blocks in a case. Each folder, case, or block can directly contain slides.

Important!

The recommended maximum number of sub-level elements is 200 folders within a parent folder, 200 cases per folder, and 20 blocks per case (50000 elements total).

For slides the recommended counts are: 50 slides per folder, 10 slides per block, and 100 slides per case (in different blocks).



1.5.1 Folder Color Markings

User access rights are presented in different colors of folders in the tree panel. A folder name appears in black characters when it contains slides to which you have read and write access, blue if the slides are read only, and gray if the slides in the folder are hidden because the slides in it are not accessible.

Folder color marking and the tasks according to the different access rights are listed below:

• Black – Read/Write access

• Blue – Read only access

• Gray – No access permission, but a sub-folder can be visible if you have Read only or Read/Write access rights for that specific sub-folder, case, or block.

1.5.2 Folder option buttons

This section describes the folder option buttons above the folder tree panel. Folder option buttons may be inactive depending on folder-related permissions.



• – New folder

1. In the folder tree, click the desired folder in which you would like to create the sub-folder, and if active, click this button.

2. The Create new folder window opens. Type in the Folder name. Add some information in the Description field if necessary.

3. Select users and/or groups you would like to give access to this folder, and set their permissions. Click the right arrow buttons to add them to the selection list. Click the left arrow button to remove items from the lists.

By default, users are displayed with the given permissions for the parent folder, and will be marked with red if you modify their permissions.

NOTE: Only moderator and administrator users are allowed to set user permissions.

Each user type is marked with an avatar of a unique color:

• Moderator user is displayed with green

• Normal user is displayed with blue

• Restricted user is displayed with red



• – New case

Creates a case under the actual folder. Note, that a case cannot be created under an other case or block. Similarly to the Create new folder window, description can be added to the case as well as users and groups and their access rights to the case.

Click the Accept button to create the case.

• – New block

Creates a block under the actual case. Note, that you cannot create a block under an other block. Description can be added to the block as well as determining users and groups and their access rights to the block.

Click Accept to finalize block creation.

• – Edit folder

By default, you can modify the folder description only. Moderator and administrator users are allowed to change user permissions. Administrators are listed with green avatars.

Click Accept to confirm changes.

• – Delete folder

Upon clicking the Delete Folder button a dialog window opens. Select Accept to confirm the removal of the folder.

NOTE: Only an empty folder can be deleted.



• – Duplicate folder (for administrator users only)

Creates an exact copy of the selected folder and its content to another location in the tree.

• – Move folder (for administrator users only)

Same operation and window as above, except that the original folder and its components will be completely removed from the server.


CaseCenter 2.2 SP2 Administrator’s Guide 2 Installation

2 Installation

2.1 System Requirements

Minimum system requirements for the HUB

Intel Xeon DualCore 2.5GHz4GB RAM100 GB HDDWindows Server 2008 R2

Minimum system requirements for the SU

Intel Xeon DualCore 2.5GHz4GB RAM500 GB HDD*Windows Server 2008 R2

*Depending on your storage availability

Important!

More than one SUs can be connected to a HUB, but a SU can belong to one HUB only.

Important!

By completing the above minimum requirements the minimum operating standards are established only. If raising the number of user/folder/SU, make sure to proportionally size each of the components.


CaseCenter 2.2 SP2 Administrator’s Guide 2.1 System Requirements

Important!

When implementing network-element redundancy, consider the following requirements:

• HDD – Sub-system under the OS must be of RAID level 1 or higher providing greater data security.

• Data – RAID level 5 or higher

• Network – If NIC teaming method is applied, run at least 2 ethernet cables between the ports of the switch and the server

2.2 Server Configuration

Before installing any components of the CaseCenter, go through some important steps when using Windows Server 2008 R2.

1. Open the Windows Server 2008 R2 Initial Configuration Tasks window.

2. Select Add roles option from the Customize This Server menu.


CaseCenter 2.2 SP2 Administrator’s Guide 2.2 Server Configuration

3. In the Server Roles panel, select the Web Server (IIS) option.

4. Within the Roles Services group in the Web Server (IIS) panel select the following:


CaseCenter 2.2 SP2 Administrator’s Guide 2.2 Server Configuration

• Common HTTP Features:

• Static Content + Default Document + HTTP Errors

• Application Development:

• ASP

• ISAPI Extensions

• Management Tools:

• IIS Management Console

The above mentioned components are necessary to be activated, others are selected by default.


CaseCenter 2.2 SP2 Administrator’s Guide 2.3 Installing MySQL Server 5.5

2.3 Installing MySQL Server 5.5

To install the MySQL Server 5.5, launch the mysql-essential-5.5.2-m2-winx64.msi file from the installation disc, and follow the steps below:

1. Click Next in the Setup Wizard window to start the installation process.

Important!

CaseCenter is compatible with MySQL Server version 5.5.2 m2 only.

2. Select the Typical installation option to install common program features, then click Next.



3. If the installation settings displayed in this window are correct, click the Install button.

4. A progress bar appears in the window to give you feedback on the installation status.



5. Click More... for more information on MySQL Enterprise, otherwise click Next to continue.

6. Click More... for more information on MySQL Enterprise, otherwise click Next to continue.



7. Leave the Configure the MySQL Server now option checked and deselect the Register the MySQL Server now option, then click Finish.

8. Click Next in the Configuration Wizard window to continue.



9. Choose the Detailed Configuration option, and click Next.

10. Upon selecting the Server Machine option, server applications will be installed on the dedicated server. Click Next to continue installation.



11. You will need to use general purpose databases. Click Next after selecting the Multifunctional Database option.

12. Choose the drive letter and the installation path for the InnoDB datafile, then click Next to continue.

NOTE: InnoDB Tablespace can be installed to another drive of the computer if necessary.



13. Choose the Decision Support (DSS)/OLAP option to set connection number to 20. Select Manual Setting and set the number of the concurrent connections from the drop-down list.

14. Select both options displayed in this window, and type in the Port Number.

If CaseCenter and MySQL will be installed on separate computers the Add firewall exception for this port option should be checked.



15. Select Manual Selected Default Character Set / Collation option and utf8 from the Character Set drop-down list, then click Next.

16. Choose the Install As Windows Service option. Set MySQL as the Service Name, and activate the Launch the MySQL Server automatically option as well.



17. Activate the Modify Security Settings, enter the root password then retype it to confirm. Tick the Enable root access from remote machines option.

18. Click the Execute button to start the configuration.



19. Click Finish to close the Wizard.

2.4 Creating and Upgrading SQL Users

New MySQL users can be created by using the Windows command prompt.

Important!

If upgrading from an older version, and MySQL users at step 4, then step 5 must be executed only.

1. Go to directory c:\Program Files\MySQL\MySQL Server 5.5\bin

2. Enter mysql -uroot -p

3. Enter password


CaseCenter 2.2 SP2 Administrator’s Guide 2.4 Creating and Upgrading SQL Users

4. Type in the following: create user 'cc_install'@'%' identified by 'PASSWORD_YOU_WANT'; this command will create a MySQL user to install CaseCenter database

5. Enter grant select, insert, update, delete, create, drop, reload, grant, index, alter, create temporary tables, lock tables, execute, create view, show view, create routine, alter routine, trigger on *.* to 'cc_install'@'%'; to grant rights, for example to the administrator or power user.

2.5 Installing the HUB and the SU

Important!

Before upgrading to a newer version, it is recommended to archive the SQL databases. For more information, see section 6.1.

Important!

During the database upgrade and the calculation process of the redundant fields, the install process is shown. This process may be time consuming, so it can take several minutes to finish (depending on the amount of data).

During the upgrade process, the usage of CaseCenter is strictly avoidable, and the person doing the upgrade is responsible for ensuring technical conditions (for example, making the client inaccessible for users) and taking necessary precautionary measures.


CaseCenter 2.2 SP2 Administrator’s Guide 2.5 Installing the HUB and the SU

Launch the CaseCenter_2.2_SP2_RTM.exe to install the HUB and the SU, and follow the steps below.


2. Accept the End-User License Agreement then click Next.



3. Select the license mode: Install with HASP dongle or Select a license file for purchased modules. Click Next to continue.

4. Click Install to start the installation of the HASP dongle driver.



5. If the HASP dongle is plugged in, remove it, then click the OK button in the window.

6. Wait until the dongle driver installation is finished. Click Next to continue.

7. Connect the dongle to the computer then click Next to continue.



8. Select both HUB Server and SU server components from the list, then click Next.

9. If missing prerequisite files are waiting for installation, click Install.



10. If all the required components have been installed, click Next to continue.

11. The installation wizard selects a default destination folder. To modify the install location click Browse, and choose a different folder.



12. Select the Default Web Site → (IP:*, Port:80) option from the Site ID list. Type in the Server’s IP or FQDN to the corresponding field. Check Secure connection option to enable HTTPS connection, then click Next.

NOTE: Prior enabling secure connection, make sure to prepare IIS (Certificate, Binding). For more information, please follow this link: http://support.microsoft.com/kb/324069

13. If you would like to configure an SMTP server, fill out the form in the Check SMTP window. When finished, click the Check SMTP Settings button.


http://support.microsoft.com/kb/324069


Otherwise, tick the selection box if you do not want to configure SMTP Server, and click Next to continue.

14. If an SMTP server is configured, a window pops up to inform you that a message has been sent to the given e-mail address.

15. Fill in the fields prior to clicking the Install SQL database button.

• computer name – IP address of the MySQL server (must be an IPv4 address), or '127.0.0.1' in case MySQL is installed on the HUB. If resolution of IPv6 addresses is enabled on the system, neither FQDN nor NetBIOS name cannot be used. In this case instead of using the name 'localhost', type in the local IPv4 address '127.0.0.1'.



• user name – enter the name of the MySQL user which has been created at step 4 in section 2.4 Creating and Upgrading SQL Users and has SQL rights described at step 5 in section 2.4. Creating and Upgrading SQL Users.

NOTE: If there are several users with the same user name (such as cc_user@localhost, cc_user@%), set privileges uniquely, for each account.

• database name – the character string must start with a letter, and it can contain letters of the English alphabet, numbers, and the character “_” only.

16. After clicking the Install SQL database button, click OK in the appearing message box to continue procedure.

17. If the installation of SQL database is complete, this message is displayed. Click OK to close the message box, then click Next in the main installation window continue.

18. User name and password fields must be filled out for MySQL.

• user name – enter the name of the MySQL user. This user will be created during install.

• user password and confirm password – create a password for the MySQL user.



19. Fill in the fields prior to clicking the Install SQL database button.

• computer name, user name, and password fields cannot be overwritten, their values are the same as given in step 15.

• SU database: – the character string must start with a letter, and it can contain letters of the English alphabet, numbers, and the character “_” only.

After clicking the Install SQL database button, click OK in the appearing message box to continue procedure.

If the installation of SQL database is complete, this message is displayed. Click OK to close the message box, then click Next in the main installation window continue.



20. Click Install to finalize installation by creating an application folder under the start menu. The installation process is simulated with a progress bar in the following window. The installation may take a couple of seconds.

21. In the Service Unit Settings window, type in the required data and select the SU protocol type. After registering the SU on a HUB by clicking the Register button, click Close to exit the window.



22. Type in the Name and Password of a CaseCenter administrator (name: admin; default password: admin) in the Login window.

23. A message window pops up in case the SU is successfully registered on the HUB server.

24. For troubleshooting assistance see section 12. Troubleshooting.

25. On the Settings tab panel in the Service Unit Settings window slide storage paths are editable. The Slides sub-folder in the installation path of CaseCenter is set by default at the first installation.



26. It is recommended not to store slides on the system drive. If installing a new CaseCenter, it is recommended to remove the path of default slide storage by clicking the Remove button, and add a new one with the Add button..

27. In the Storage data window you can specify data of the storage folder. It is highly recommended to use a shared folder (specified by UNC path) for storing slides, and add a new network path (UNC) in the displaying window after clicking the Add button.

Important!

UNC storage path can be added from a SMB server only to which the Windows user with administrator rights (running the 3DHISTECH CaseCenter Configuration) is not yet connected and has not mapped a network drive.

If there is a mapped drive or the user is connected to the SMB server already, then drive mapping must be removed first. Log off from the CaseCenter server computer, and after re-logging in, the 3DHISTECH CaseCenter Configuration tool can be launched, so the required UNC path can be added.



You must specify the Storage Path, a user (User Name and Password) who has Full Control NTFS rights on the folder and on the Windows Share, and zero or more Reserved Space. Click OK to finalize settings.

For further details about storage paths read section 7.1 SU storage management.

28. For the SU working properly, add at least one storage. Press Close to continue installation.

Important!

You can specify a local driver path for slide storage (for example, "d:\slides"), however, in this case every client can access slides only through HTTP/HTTPS which is slower than SMB therefore leading to performance decrease. For more information, see section 7.1 SU storage management.



29. If SlideServer 1.12 had been used before the installation of CaseCenter, and export file was generated, then backup data can be imported into CaseCenter by selecting the checkbox.

Important!

Importing SlideServer 1.12 data is possible only at the first installation of CaseCenter. Data cannot be imported into CaseCenter afterward.

30. After the procedure has finished, the wizard creates a folder on your desktop containing user documentation for the CaseCenter application. Check the Show Administrator’s Guide option, click Finish, and then the folder is opened.



31. If the installer cannot find a PDF reader already installed on your computer, click Yes to download Adobe Acrobat Reader installer from the official website.

2.6 Installing the SU

Important!

Before upgrading to a newer version, it is recommended to archive the SQL databases. For more information, see section 6.1.

Important!

During the database upgrade and the calculation process of the redundant fields, the install process is shown. This process may be time consuming, so it can take several minutes to finish (depending on the amount of data).

During the upgrade process, the usage of CaseCenter is strictly avoidable, and the person doing the upgrade is responsible for ensuring technical conditions (for example, making the client inaccessible for users) and taking necessary precautionary measures.


CaseCenter 2.2 SP2 Administrator’s Guide 2.6 Installing the SU

Launch the CaseCenter_2.2_SP2_RTM.exe to install the SU, and follow the steps below:


2. Accept the End-User License Agreement (EULA) then click Next.



3. Select the license mode: Install with HASP dongle or Select a license file for purchased modules (click Browse to locate the license file). Click Next to continue.

4. Click Install to start the installation of the HASP dongle driver.



5. If the HASP dongle is plugged in, remove it, then click the OK button in the window.

6. Wait until the dongle driver installation is finished. Click Next to continue.

7. Connect the dongle to the computer then click Next to continue.



8. Select the SU Server component from the list, then click Next.

9. If missing prerequisite files are waiting for installation, click Install.



10. If all the required components have been installed, click Next to continue.

11. The installation wizard selects a default destination folder. To modify the install location click Browse, and choose a different folder.



12. Select the Default Web Site → (IP:*, Port:80) option from the Site ID list. Type in the Server’s IP or FQDN to the corresponding field. Check Secure connection option to enable HTTPS connection, then click Next.

NOTE: Before enabling secure connection, make sure to prepare IIS (Certificate, Binding). For more information, please follow this link: http://support.microsoft.com/kb/324069

13. Fill in the fields before clicking the Install SQL database button.


http://support.microsoft.com/kb/324069


• computer name – IP address of the MySQL server (must be an IPv4 address), or '127.0.0.1' in case MySQL is installed on the SU.

If resolution of IPv6 addresses is enabled on the system, neither FQDN nor NetBIOS name can be used. In this case instead of using the name 'localhost', type in the local IPv4 address '127.0.0.1'.

• user name – enter the name of the MySQL user which has been created at step 4 in section 2.4 Creating and Upgrading SQL Users and has SQL rights described at step 5 in section 2.4. Creating and Upgrading SQL Users.

NOTE: If there are several users with the same user name(such as cc_install@localhost, cc_install@%), set privileges uniquely, for each account.

• database name – the character string must start with a letter, and it can contain letters of the English alphabet, numbers, and the character “_” only.

14. If the installation of SQL database is complete, this message is displayed. Click OK to close the message box, then click Next in the main installation window continue.

15. User name and password fields must be filled out for MySQL.

• user name – enter the name of the MySQL user. This user will be created during installation.

• user password and confirm password fields – create the MySQL user password.


mailto:cc_user@localhost


16. Click Install to finalize installation by creating an application folder under the start menu. The installation process is simulated with a progress bar in the following window. The installation may take a couple of seconds.

17. In the Service Unit Settings window, type in the required data and select the SU protocol type. After registering the SU on a HUB by clicking the Register button, click Close to exit the window.



18. Type in the Name and Password of a CaseCenter administrator (name: admin; default password: admin) in the Login window.

19. A message window pops up in case the SU is successfully registered on the HUB server.

For troubleshooting assistance see section 12. Troubleshooting.

20. On the Settings tab panel in the Service Unit Settings window slide storage paths are editable. The Slides sub-folder in the installation path of CaseCenter is set by default at the first installation.



21. It is recommended not to store slides on the system drive. If installing a new CaseCenter, it is recommended to remove the path of default slide storage by clicking the Remove button, and add a new one with the Add button..

22. In the Storage data window you can specify data of the storage folder. It is highly recommended to use a shared folder (specified by UNC path) for storing slides, and add a new network path (UNC) in the displaying window after clicking the Add button.

Important!

UNC storage path can be added from a SMB server only to which the Windows user with administrator rights (running the 3DHISTECH CaseCenter Configuration) is not yet connected and has not mapped a network drive. If there is a mapped drive or the user is connected to the SMB server already, then drive mapping must be removed first. Log off from the CaseCenter server computer, and after re-logging in, the 3DHISTECH CaseCenter Configuration tool can be launched, so the required UNC path can be added.

You must specify the Storage Path, a user (User Name and Password) who has Full Control NTFS rights on the folder and on the Windows Share, and zero or more Reserved Space. Click OK to finalize settings.



For further details about storage paths read section 7.1 SU storage management.

23. For the SU working properly, add at least one storage. Press Close to continue installation.



Important!

You can specify a local driver path for slide storage (for example, "d:\slides"), however, in this case every client can access slides only through HTTP/HTTPS which is slower than SMB therefore leading to performance decrease. For more information, see section 7.1 SU storage management.

24. If SlideServer 1.12 had been used before the installation of CaseCenter, and export file was generated, then backup data can be imported into CaseCenter by selecting the checkbox.

Important!

Importing SlideServer 1.12 data is possible only at the first installation of CaseCenter. Data cannot be imported into CaseCenter afterwards.



25. After the process is finished, the wizard creates a folder on your desktop containing user documentation for the CaseCenter application. Check the Show Administrator’s Guide option, click Finish, and then the folder is opened.

26. If the installer cannot find a PDF reader already installed on your computer, click Yes to download Adobe Acrobat Reader installer from the official website.


CaseCenter 2.2 SP2 Administrator’s Guide 3 Managing Users and Groups

3 Managing Users and GroupsThe Users & Groups window displays information about registered users and groups created by administrators. The Users and Groups information is separately displayed on two different panels. For group data click the Groups tab on the left side of the panel.

To search for users or groups scroll down the list in this window, and you can also narrow search results by entering text in the Quick search textbox.

Adding or removing users and groups is available for you in these two panels.

If LDAP settings are correctly set in the Service/Settings panel, then Get LDAP user list and Get LDAP group list buttons are displayed and active on both Users and Groups panels.

3.1 Add User or Group

Users can be added by clicking the button. Fill in the data fields in the New user window. Check the Can change profile option to allow the user to modify their profile settings, and select the user level from the drop-down list.


CaseCenter 2.2 SP2 Administrator’s Guide 3.1 Add User or Group

Additional Group can be created by clicking the button in the Group panel.

• Type in the name of the new group into the Group name field.

• Select the users you want to add as members of the group to the right column by clicking the

or remove by the button.

• Click Accept when finished.


CaseCenter 2.2 SP2 Administrator’s Guide 3.2 Edit User or Group Data

3.2 Edit User or Group Data

To access user or group data, click the or the button. All the information can be modified both in the Edit User and the Edit Group windows. Click Accept if modifications are done, or exit the window without saving the changes by clicking the Cancel button.


CaseCenter 2.2 SP2 Administrator’s Guide 3.2 Edit User or Group Data

LDAP users cannot edit their profiles, they only are able to view their profiles instead.

When editing group data of an imported LDAP group, only storage IP and default user level can be modified.


CaseCenter 2.2 SP2 Administrator’s Guide 3.3 Remove User or Group

3.3 Remove User or Group

Selected User or Users can be removed with the button. To delete a Group or Groups, click the button in the Group window after making the selection.

Important!

Users logged in cannot be removed. If the user status icon is lit, it means that the user is logged in, therefore you cannot put a check mark into the selection box.

3.4 LDAP Users and Groups

To search for LDAP users and groups in LDAP server click the Get LDAP users or Get LDAP groups buttons respectively. A window is then displayed in which LDAP users/groups can be filtered based on the settings.

As a result, the first 100 list items are shown on the displayed list.


CaseCenter 2.2 SP2 Administrator’s Guide 3.4 LDAP Users and Groups

If the LDAP user or group you have searched for is not present on the list, use the Search field at the top of the pop-up window to further narrow down search results. Click Search users or Search groups to start search.

For more information on LDAP user import see section 11.1 LDAP user import, on group import see section 11.2 LDAP group import.


CaseCenter 2.2 SP2 Administrator’s Guide 4 Add and Remove Language

4 Add and Remove LanguageCaseCenter is customizable for different languages. For language customization, all language files are stored on the HUB server in the C:\Program Files (x86)\3DHISTECH\CaseCenter\Web\ folder.

4.1 Edit \config.inc.php

Edit the C:\Program Files (x86)\3DHISTECH\CaseCenter\Web\config.inc.php file, and go to the # Languages section.

• Syntaxis

$_LANGUAGES['language code'] = array("locale" => "language code_language.UTF-8", "name" => "xxx");

• language code: two small letters, for example: en, gr, es, etc.

• language: language dialects, for example: en_EN, en_US, es_ES, es_AG, etc.

• name is the internal name of the language, for example: Greek, Spanish, English, etc.

• Example

$_LANGUAGES['gr'] = array("locale" => "gr_GRE.UTF-8", "name" => "greek");

4.2 Adding National Flags

Copy flag to C:\Program Files (x86)\3DHISTECH\CaseCenter\Web\templates\admin\img\flags, and the C:\Program Files (x86)\3DHISTECH\CaseCenter\Web\templates\default\img\flags folders.

NOTE: Flag image size has to be 16×16 pixels.

The file name of the image is, for example: gr_flag.png

4.3 Create the Language Dictionary

1. Create the new language folder in C:\Program Files (x86)\3DHISTECH\CaseCenter\Web\locale

Folder name is, for example: gr_GR\LC_MESSAGES


CaseCenter 2.2 SP2 Administrator’s Guide 4.3 Create the Language Dictionary

2. Copy C:\Program Files (x86)\3DHISTECH\CaseCenter\Web\locale\en_US\LC_MESSAGES folder to C:\Program Files (x86)\3DHISTECH\CaseCenter\Web\locale\gr_GR\

3. Edit and change C:\Program Files (x86)\3DHISTECH\CaseCenter\Web\locale\gr_GR\LC_MESSAGES\messages.po with a PO editor (PO edit, Virtaal)

4.4 Set or Edit \email.php

Edit the C:\Program Files (x86)\3DHISTECH\CaseCenter\Web\core\lib\smtp\email.php file.

1. Add new section (change en to gr), for example: # gr_GR, and translate the e-mail messages.

• Example:

$email["en"]["subject_new"] = "A new Teleconsultation has been created in CaseCenter.";

$email["en"]["subject_removed"] = "You have been removed from a Teleconsultation.";

$email["en"]["subject_date_changed"] = "The date of Teleconsultation has changed.";

$email["en"]["subject_deleted"] = "Your Teleconsultation session is deleted.";

$email["en"]["new_tc"] = "You have been invited to participate in a Teleconsultation session.";

$email["en"]["removed_from_tc"] = "You have been removed from a Teleconsultation.";

$email["en"]["tc_date_changed"] = "The date of the Teleconsultation session has changed.";

$email["en"]["tc_deleted"] = "One of your Teleconsultation sessions have been deleted.";

$email["en"]["tc_name"] = "Title of Teleconsultation: ";

$email["en"]["created_by"] = "Created by: ";

$email["en"]["start_date"] = "Start date: ";

2. Restart IIS.


CaseCenter 2.2 SP2 Administrator’s Guide 5 Manage Service Units

5 Manage Service Units

5.1 Add SU

A SU can be connected to one HUB only!

After installing the SU, it has to be connected to the HUB through the 3DHISTECH CaseCenter Configuration application, HUB tab panel.

1. Log in as administrator (user name: admin)

2. Add HUB address

3. Chose HUB server protocol (Secure connection means HTTPS)

4. Add SU name

5. Add SU self address

6. Choose used SU protocol

When it is done, the SU starts communicating with the HUB.

5.2 Edit SU

If the SU settings are changed, such as its name, address, or protocol, these values can be set in the SU through the 3DHISTECH CaseCenter Configuration application, HUB tab panel.

NOTE: you cannot change the SU virtual folder.

On the SU side, start the 3DHISTECH CaseCenter Configuration application and switch to the HUB tab panel:


2. Change SU name

3. Change SU self address

4. Change SU protocol

5. Press Change button to save changes

See section 7.5 Slide- and user-related maintenance – Service Units for more information.

Open a slide from the SU to check modifications are well performed.


CaseCenter 2.2 SP2 Administrator’s Guide 5.3 Remove SU

5.3 Remove SU

Warning!

This function should be used only in reasonable cases. All slide-related data (name, staining, organ, scan date) are stored on the HUB, the unique identifiers (GUID) of slides are stored on the SU. Therefore, in a normal situation only that SU can be unregistered from the HUB, that does not contain slides. You can verify this in the settings tab panel of the 3DHISTECH CaseCenter Configuration application.

1. On the SU side, start the 3DHISTECH CaseCenter Configuration application and switch to the HUB tab panel


3. Click Remove


CaseCenter 2.2 SP2 Administrator’s Guide 6 SU and HUB Server Management

6 SU and HUB Server Management

6.1 SU/HUB Server Data Backup

To initiate SU and HUB server data backup, follow these steps:

1. Log in as administrator through the CaseCenter web interface.

2. Open Service window Database Backup panel.

3. Click Start Backup button.

For more information on initiating the backup, see section 7.5.10 Database Backup; on configuring the backup folder, see section 7.5.8 Settings.

6.1.1 Slide-related information and data backup

During the process, slide locations and names, and personal settings of the application for their handling will be stored at the specified location. Because of security reasons, backup of data stored in the SU database is transferred in a converted format to the exact location.

Important!

During backup, slides are not being saved in the backup folder.

6.1.2 Result

After the process is finished, an additional folder with a prefix Backup_ is created with a timestamp suffix, in which the following files are stored:

1. Folders

• Attachments – container for attachments located on the HUB server

• Thumbnails – container for thumbnail images located on the HUB server

2. Files

• Attachments.copy.log

• Thumbnails.copy.log

These log files list records of preformed activities. Search for error logs in these log files in case any fault has occurred during the backup process.


CaseCenter 2.2 SP2 Administrator’s Guide 6.1 SU/HUB Server Data Backup

• config2.inc.php – configuration file in which personal application settings for CaseCenter are stored.

• HUB.sql – Contains the complete content of HUB database.

• SlideCrossReference.csv – Cross reference table about slides. It contains:

◦ Slide name.

◦ Logical path in the HUB folder hierarchy.

◦ Operating system (file system) path of the slide stored on the SU.

◦ ID of the SU which physically stores the slide.

• SU_.sql – Full content of CaseCenter SU database can be found here (of the ID-eth SU – ID as an ordinal number).

6.2 Restoring the HUB Database Backup

Important!

Present version of CaseCenter is capable of restoring backup created with application version 2.2 SP2 or newer.

Important!

When restoring, the usage of CaseCenter is strictly avoidable, and the person doing the upgrade is responsible for ensuring technical conditions (for example, making the client inaccessible for users) and taking necessary precautionary measures.

Restoration of previously saved data can be performed manually. If restoring a backed up CaseCenter data is needed because the version in use became unavailable, you must begin the process by installing a new release of the product. Make sure to read compatibility information regarding the backup of the specific version.

After performing installation in accordance with the instructions, an empty database with a basic configuration will be available. Restore can only be preformed after creating an empty database. Act according to the situation in any non-ordinary case.


CaseCenter 2.2 SP2 Administrator’s Guide 6.2 Restoring the HUB Database Backup

6.2.1 Copying folders

Copy the two resulting folders of the backup process (Attachments and Thumbnails) together with the included elements to the Web sub-folder of the CaseCenter application. By default the installation wizard sets: „C:\Program Files (x86)\3DHISTECH\CaseCenter\Web\” as destination folder.

6.2.2 Restoring the database

For this operation the command line interface to the MySQL database manager (installed together with the CaseCenter) is needed.

1. Launch the interface from the start menu by typing mysql.exe -u root -p to the command line.

NOTE: In place of root type the user name used for the database that has been set during installation. Only user cc_install is permitted to perform this action, as cc_user having a set of minimally required permissions cannot create the database.

2. You are asked for the password for the database-server.

3. After logging in successfully, remove the present CaseCenter database with the following command: drop database cc_hub;

NOTE: Do not forget to put a semicolon (;) to the end of the line, and write the name of the database set during installation in place of cc_hub.

4. Leave MySQL command interface by typing exit to the command line.

5. Type cmd to the command line, then navigate to the folder created during backup.

6. Run the restore process with the following command (entering the database name used previously in place of cc_hub, and the password identical with the one used above instead of using the label ): RestoreSQL.cmd 127.0.0.1 3306 root cc_hub HUB.sql

NOTE: In case the database is not locally installed, replace 127.0.0.1 to the name of the host from which the MySQL HUB database is run.

7. A loading procedure may take few minutes, and restore is fully completed when finished.

8. Finally, modify HUB-SU connection settings in the CaseCenter Configuration window by entering a valid name and IP address.


CaseCenter 2.2 SP2 Administrator’s Guide 6.3 Restoring the SU Database Backup

6.3 Restoring the SU Database Backup

Important!

Present version of CaseCenter is capable of restoring backup created with application version 2.2 SP2 and newer.

Important!

When restoring, the usage of CaseCenter is strictly avoidable, and the person doing the upgrade is responsible for ensuring technical conditions (for example, making the client inaccessible for users) and taking necessary precautionary measures.

The installed auxiliary tools can be found in the BackupRestore folder of the CaseCenter application.

Restoration of previously saved data can be performed manually.

NOTE: Slides are not saved during backup, therefore no slide can be restored by restoring and SU backup. If CaseCenter data backup restoration is needed because the version in use became unavailable, you must begin the process by installing a new release of the product. Make sure to read compatibility information regarding the backup of the specific version.

After performing installation in accordance with the instructions, an empty database with a basic configuration will be available. Restore can only be preformed after creating an empty database. Act according to the situation in any non-ordinary case.

6.3.1 Restoring the database

For this operation the command line interface to the MySQL database manager (installed together with the CaseCenter) is needed.

1. Launch the interface from the start menu by typing mysql.exe -u root -p to the command line.

NOTE: In place of root type the user name used for the database that has been set during installation. Only user cc_install is permitted to perform this action, as cc_user having a set of minimally required permissions cannot create the database.

2. You are asked for the password for the database-server.

3. After logging in successfully, remove the present SU database of CaseCenter with the following command: drop database cc_su;

NOTE: Do not forget to put a semicolon (;) to the end of the line, and write the name of the database set during installation in place of cc_su.


CaseCenter 2.2 SP2 Administrator’s Guide 6.3 Restoring the SU Database Backup

4. After this, close MySQL command interface by typing exit to the command line.

5. Type cmd to the command line, then navigate to the folder created during backup.

6. Run the restore process with the following command (entering the database name used previously in place of cc_su, and the password identical with the one used above instead of using the label ):

RestoreSUSQL.cmd 127.0.0.1 3306 root casecenter_su SU.sql

NOTE: In case the database is not locally installed, replace 127.0.0.1 to the name of the host from which the MySQL HUB database is run.

7. A loading procedure may take few minutes, and restore is fully completed when finished.

8. Finally, modify HUB-SU connection settings in the CaseCenter Configuration window by entering a valid name and IP address.

6.4 Complete Restoration (SU-HUB)

The following procedure shows how to completely restore SU and HUB of a CaseCenter.

1. Transfer each slide manually to the new location (to another computer, or IP destination).NOTE: This location is not the final destination of slides.

2. Install CaseCenter to the new machine with the new IP address (as HOST).

3. Install necessary Windows updates.

4. Start with restoring the HUB first, then the SUs one after the other.

For more information on HUB restoration follow steps in section 6.2, and on SU restoration see section 6.3.

5. Finally, launch CaseCenter Configuration software, and modify HUB-SU connection settings – rewrite old IP address and name to the new ones.


CaseCenter 2.2 SP2 Administrator’s Guide 7 Manage Slides

7 Manage Slides

7.1 SU storage management

The average size of a digital slide is 1GB (Z-Stack slides require multiple times more space). The size of a specific slide depends on the size of the scanned area, the scanning method (Brightfield, Fluorescent, Z-Stack), the selected compression algorithm, and the rate of the algorithm (JPG, JPG2000, BMP). For example, a Brightfield Z-Stack whole slide smear digitized in JPG 80 may require more than 30 GB space on the storage drive.

CaseCenter does not perform backup of slides (because of the huge amount of data) so it is the user's responsibility to ensure that storage of slides is secure. The most obvious solution is to use storage drives conform with security standards.

Data security level can be increased if a backup copy of slides to a 3rd party device is created regularly. Expectation towards the storage device that is has to be compatible with Microsoft Windows Server 2008 R2 (operation system of CaseCenter Host).

Storage connection type is either NAS (Network Attached Storage), DAS (Direct Attached Storage) or SAN (Storage Area Network).

If NAS connection is established, communication through a Windows SMB/CIFS compatible protocol. DAS or SAN requires a proper Windows driver as the bare minimum.

Ensure that storage server does not provide SMB file or printer share function towards CaseCenter clients, otherwise clients connected to storage server can access slides from CaseCenter through HTTP/HTTPS only.

Outer storage has to be connected to SU (if NAS is preferred, the outer storage is connected to the LAN that includes the SU).

NAS storage is in direct connection with clients of the same LAN (through SMB protocol) only if SMB access is enabled on the SU (enabled by default). If SAN or DAS is used, clients access storage through the SU. In such cases, slide storage folder on the SU must be shared (Windows Share), thus making it accessible for clients on the LAN (that includes the SU) through SMB.


CaseCenter 2.2 SP2 Administrator’s Guide 7.1 SU storage management

Storage drives can be set in Settings tab panel in CaseCenter Configuration application.

On the Settings panel of the Service Unit Settings window, the following columns are displayed:

• Storage path: slide storage directory

• State1: usability status of storage (modifiable by administrator)

Values:

• Active: new slide can be placed on the storage

• Archived: additional slide cannot be placed on the storage, slides already present on the drive can be read/written

• State2: accessibility status of storage (shifts automatically)

Values:

• Available: storage can be accessed

• Unavailable: storage is temporarily inaccessible (for example, because of a network error)

• # of slides: number of slides momentarily stored on the storage

• Allocated space: total size of slides on the storage

• Reserved space for other SW's: smallest reservable free space on the storage



• Available space: free space on storage for storing slides

• User name: SMB (NTLM) user that can access storage path with Full control permission

Push buttons:

• Add: add a new storage path

• Archive: a storage in State1 = Active status can be set to Archived

Important!

Do NOT archive a storage if import is in progress.

• Reactivate: a storage in State1 = Archived status can be set to Active

• Remove: remove a storage (can be performed only if there is no slide on the storage)

• Edit: edit storage path data

• Test: check storage path (test result is displayed as a value in column State2)

Statistics:

• Summed up statistics of every storage path (slide number, size, total free space, largest continuous free space)

Status:

• If Operation status is online, slide checker runs automatically in the background.



7.1.1 Add new storage

• Storage Path: storage access – UNC Windows/NAS SMB share

• User Name: a Windows Domain user, or local user that exists on the storage, having Full Control permission on the Storage Path and the Windows Share (these access rights must be set before adding the storage).

• Password: user password

• Reserved Space: the minimum free space to be reserved (value in MB)

7.1.2 NAS storage usage

• Storage Path is a valid UNC path in the following form: \\SERVER_NAME\SHARE\SUBFOLDER. The SUBFOLDER part must be included, one sub-folder path depth (for example, \\SERVER_NAME\SHARE) cannot be used as a folder for slide storage.

• Only one Storage Path can be added to the system from one logical volume.


file://SERVER_NAME/SHAREfile://SERVER_NAME/SHARE/SUBFOLDER


• User Name: a valid user, that either exists on a domain server which includes SERVER_NAME and SU as members, or a local user on the SERVER_NAME machine. This user must have Full Control NTFS access permission to \\SERVER_NAME\SHARE\SUBFOLDER folder and to all of its sub-folders, as well as to \\SERVER_NAME\SHARE SMB share. Permission setting must be performed prior to adding the storage by the storage administrator. Permission must be registered for the user explicitly, group permission is invalid.

• If several Storage Path is added to the system, each of them has to be set with the same User Name.

7.1.3 DAS, SAN or local storage usage

• The folder for storing slides must be shared (Windows share). Specification for the share created this way is the same as in section NAS storage usage.

• Although the system allows us to use local folder path as slide storage (for example, D\:Slides), slides stored in such folder can only be accessed through HTTP/HTTPS even from clients within the LAN of SU, that drastically decreases the speed of transfer, and has dramatic effect especially on the scanning speed.

7.1.4 Storage editing


file://SERVER_NAME/SHAREfile://SERVER_NAME/SHARE/SUBFOLDER


• Storage Path: path of storage, cannot be modified.

• User Name: a Windows Domain user, or a local user on the storage, who has Full Control permission to Storage Path and Windows Share (these permissions must be set prior to adding the storage).

• Password: user password

• Reserved Space [MB]: minimum reserved free space in MB

7.1.5 Requirements and and recommendations

Each system component of CaseCenter (storage as well) is within the same – solely – Windows domain, in other words from network access, name resolution, and handling of user privileges points of view, are included in the scope of the same administration area; so they are mutually accessible and interoperable (including deactivation of occurrent bottlenecks such as firewalls, anti-virus applications, or security system limitations; otherwise – if these components are enabled – assure an absolutely transparent yet standard software interoperability.

• All of the storages of the specific SU must be connected with the same (and the only one) domain user. For this user must have explicitly-granted full access permission (in addition to effective rights related to group membership) both for shares and the file system.

Accordingly, it is the person's responsibility who performs the installation, to ensure that the target computer of the storage is inaccessible by other users using a different user credentials via the SU (neither for establishing connection related to storage, software, nor services) than the one selected.

• If possible, the connection of storages to the SU units must be performed when putting CaseCenter in operation, but their modification during operation is avoidable. Any alteration requires special circumspection and attention, be performed on a system unit out of service, and in accordance with the guidance within the topic.

• Permissions required for the connection and usage of the SU unit must be guaranteed on connectable storage prior putting them in operation, and then continuously during their operation time (while in use).

• The storage connected to SU must be at service non-stop, and with great reliability during operation.

• Connection of more than one storage from the same volume (drive or file-system-level logical unit) to an SU is not supported.



• The folder used as slide storage neither can be a root folder of a drive (for example, D:\) nor a root folder of a network share (for example, D:\) or a DFS path pointing to a root folder (for example, \\server\share). NOTE: HUB/SU backup could not be performed from these locations.

• Do not connect a storage through an administrative Windows share, exclusively by granting appropriate permissions on an explicitly shared folder (for example, \\\C$).

To assure convenient operation performance, we suggest to designate a storage in such a way that it is located on an independent physical drive using different code than any other operating unit of the CaseCenter runs. To meet higher performance needs, further (inner – from system point-of-view) resource decoupling or exclusive use might be necessary.

7.2 Scan to Server

The relevant feature documentation can be found in the device-specific User's Guide for Pannoramic scanners.

7.3 Upload slides with Pannoramic Viewer

You need Pannoramic Viewer to upload slides to the server.

Tip!

Since the upload may take a significant amount of time – depending on the slide size – it is recommended that you upload the slide to the server before starting a Teleconsultation session.

You can only upload one slide at a time from Pannoramic Viewer. Administrators can perform bulk uploads via file transfer.

1. Launch Pannoramic Viewer on your computer.

2. To connect to the CaseCenter server, click in the toolbar.


CaseCenter 2.2 SP2 Administrator’s Guide 7.3 Upload slides with Pannoramic Viewer

3. Enter the server address and your authorization information in the dialog. If you encounter a problem, contact the CaseCenter administrator.

4. Ensure that the slide is visible in the navigation tree on the Local tab in Pannoramic Viewer.

If the slide is not visible, add the containing folder to the navigation tree:

a. To open the slide, click in the toolbar.

b. Browse for the folder that contains the slide

c. Click Add Folder then click Close.

5. Right-click the slide that you want to upload and then select Upload Slide to Teleconsultation Server.

6. Set the properties for the copy of the slide to store on CaseCenter.

7. Click Start Upload.

7.4 Import slides

Slide import is a method of placing slides to the server but not via uploading. Import has to be initiated from the SU side, as the process cannot be launched through the web interface – because of security reasons the web interface does not have access to any data stored on remote computers.

1. Click the 3DHISTECH CaseCenter Configuration icon on the desktop.


CaseCenter 2.2 SP2 Administrator’s Guide 7.4 Import slides

2. Choose Slide Import tab.

3. Click Add to Queue.

4. Log in to the server as admin.

5. Select slides or folders to import from the l

casecenter 2.2 sp2 admininstrator's guide · ldap lightweight directory access protocol – an...

Documents