dot-anonymizer 5.0 installation guide...northamerica&latam emea(hq) asiapacific...

North America & LATAM EMEA (HQ) Asia Pacific70 Main Street, Suite 203Peterborough NH 03458USA1-603-371-90741-800-676-4709 (toll free)[email protected]

55 Rue Adrastée – Parc Altaïs74650 Chavanod/AnnecyFrance

+33 450 578 [email protected]

c/o Pramex Intl Ltd1 Austin Rd West Intl Commerce Centre7107B 71/F Tsim Sha Tsui HONG KONGYau Ma Tei Hong Kong

[email protected]

Publication Date: May, 2019

Prepared by the DOT Software Documentation and Consulting Teams

Installation GuideDOT-Anonymizer

Version 5.0

DOT-Anonymizer v5.0Installation Guide |

Copyright © 2015-2019 by DOT Software. All rights reserved.

The following terms are names owned by International Business Machines Corporation in the United States,other countries, or both: AS/400®, ClearCase, ClearQuest®, DB2, DB2 Connect™, DB2 Universal Database™,ibm.com, IBM i, iSeries, System i, OS/400, Rational®, SP2, Service Pack, WebSphere. Java and all names basedon Java are owned by Oracle Corp. in the United States, other countries, or both. Eclipse is a registeredtrademark of Eclipse Foundation, Inc. Other names of companies, products or services are the property of theirrespective owners.

/ 27DOT Software • Copyright © 2019 • All Rights reserved. • arcadsoftware.com

http://www.arcadsoftware.com/

DOT-Anonymizer v5.0Contact DOT Software | Installation Guide

Contact DOT Software

Headquartered in France at the foot of the Alps, DOT Software offers global services and has officesand partners all over the world. ARCAD partners with leading-edge companies throughout the world tooffer full services, close to home.

Visit our website to Contact Us and find out more about our company and partners, or to request ademo.

The Customer Portal is intended for current and potential customers that have full or trial versions ofARCAD software. If you already use or are interested in using an ARCAD product, the portal lets youview all of your current licenses and generate your own temporary license keys for most ARCADproducts. It grants you access to the ARCAD product knowledge base (FAQ, new releases, fixes, etc.) aswell as the Release Notes and current documentation.

Do you have a request for change or have you encountered a bug? Log into the Helpdesk and create aticket.

DOT Software guarantees consultant support 24 hours a day, 5 days a week (24/5) to registeredmembers. Calls received are redirected, according to the hour, to put you in contact with a supportteam in or near your timezone.

Country Address Account Contact Support Contact

FranceARCAD Software (HQ)55 Rue Adrastée74650 Chavanod

+33 4 50 57 83 [email protected] support-

[email protected]

ARCAD Software Deutschland GmbHc/o Pramex International GmbHIm Trutz, Frankfurt 55 60322

USAARCAD Software Inc.70 Main Street, Suite 203Peterborough, NH 03458

+1 (603) 371-9074+1 (800) [email protected]

[email protected]

HongKong

ARCAD Software Asiac/o Pramex Intl Ltd1 Austin Rd West Intl Commerce Centre7107B 71/F KowloonHong Kong

+852 3618 6118

[email protected]

ARCAD Software Products PrivateLmtdRoom D07, floor 34, No.32, ZhujiangEast RoadTianhe District, Guangzhou

+86 (020)22324643+86 (020)[email protected]

IndiaARCAD SoftwareD-280/281/282, Vibhuti KhandGomti Nagar, Lucknow

Table 1: Contact DOT Software


https://arcadsoftware.com/about/contact/

https://arcadsoftware.com/customer/

https://helpdesk.arcadsoftware.com/customer/customer?startup=generic

mailto:[email protected]













DOT-Anonymizer v5.0Installation Guide | Preface

Preface

Document purposeThis document is intended to guide you through the installation process for the following DOT-Anonymizer applications:

l DOT-Anonymizer Server;l DOT-Anonymizer Web Studio;l Anonymizer Command Line Processor;l DOT-Anonymizer Studio.

Intended audienceThis document is intended for System Admins, Administrators and/or the person in charge of installingthe software.

Related documentation

Related documentation

DOT-Anonymizer Datasheet

DOT-Anonymizer User GuideTable 2: Related documentation

Publication recordUnless stated otherwise, all content is valid for themost current version of DOT-Anonymizer listed aswell as every subsequent version.

Product version Documentversion

PublicationDate Update record

≥ 5.0 1.7 May, 2019 Updated the DOT-Anonymizer Server installationinstructions for IBM i.

4.0 1.6 October, 2018No functional changes.

Added the Linux installation procedure.

4.0.7 1.5 October, 2017

No functional changes.

Modified the example for changing the port whenconflicting servers are installed.

4.0.4 1.4 February, 2017 No functional changes.

3.1 1.3 June, 2016 No functional changes.

3.0 1.2 October, 2015 No functional changes.

2.0 1.1 September, 2015 No functional changes.

2.0 1.0 May, 2015 Initial publication.

Table 3: DOT-Anonymizer Installation Guide publication record



DOT-Anonymizer v5.0Contents | Installation Guide

Contents

Contact DOT Software 3

Preface 4

Contents 5

System requirements1 System requirements for the DOT-Anonymizer Server 81.1 Windows 81.1.1 Hardware requirements 8

1.1.2 Software requirements 8

1.1.3 Remote Desktop Services 8

1.1.4 Host name resolution 9

1.1.5 Users, Groups and Environments for the DOT-Anonymizer Server 9

1.2 Linux 91.2.1 Hardware requirements 10



1.2.4 Users, Groups and Environments for the DOT-Anonymizer Server 11

1.3 IBM i 111.3.1 Hardware requirements 11



1.3.4 Users for the DOT-Anonymizer Server 12

2 System requirements for the DOT-Anonymizer Studio 132.1 Windows 132.1.1 Hardware requirements 13


2.1.3 Remote Desktop Services 13

2.1.4 Users, Groups and Environments for the DOT-Anonymizer Studio 13

3 System requirements for the WebStudio 15

Installation4 Installing the DOT-Anonymizer Server on IBM i 174.1 Prerequisites 174.2 Installing and updating 17

5 Installing the DOT-Anonymizer Server, Web Studio and/or CLP on Windows 195.1 Prerequisites 195.2 Installing 195.2.1 Verify the windows services are running 21

5.2.2 Configuring the DOT-AnonymizerWeb Studio port 22

6 Installing the DOT-Anonymizer Server on Linux 236.1 Prerequisites 23



DOT-Anonymizer v5.0Installation Guide | Contents

6.2 Installing 23

7 Installing the DOT-Anonymizer Studio 257.1 Prerequisites 257.2 Installing 257.3 Uninstalling 26



Systemrequirements

DOT-Anonymizer v5.0Installation Guide | 1 System requirements for the DOT-Anonymizer Server

1 System requirements for the DOT-AnonymizerServer

1.1 Windows

1.1.1 Hardware requirementsThe following table lists the hardware components that are required for the DOT-Anonymizer Serveron Windows x64.

Requirement Value

System Architecture 64bits processor

CPU DUAL Core processor recommended

Physical memory(RAM) 4GB minimum, 8GB recommended1

Hard disk RAID storage or any secured storage with redundancy, backup andmonitoring

Disk Space Typical Install Type total: 10GB

Network Any TCP/IP capable network interfaceTable 4: DOT-Anonymizer Server Hardware Requirements - Windows

1.1.2 Software requirementsThe following table lists the software requirements for the DOT-Anonymizer Server on Windows x64.

Requirement Value

Operating systeml Anymicrosoft supported server os with (eg windows server 2016 anyversion)

Network protocoll TCP/IPv4l TCP/IPv4 with SSL

Filesystem NTFS or any journalized filesystemTable 5: DOT-Anonymizer Server Software Requirements - Windows

1.1.3 Remote Desktop ServicesDOT Software supports installing, configuring, and running all of its software through Remote DesktopServices, formerly known as Terminal Services, on Windows. To install, DOT Software recommendsthat you start all configuration tools from the Terminal Server console session of the server using mstscor console.

1Physical memory is used by this entity and all subsequent processes, operating systems and any other softwareinstalled on the server. Please refer to additional software vendors for additional physical memory requirements.



DOT-Anonymizer v5.01 System requirements for the DOT-Anonymizer Server | Installation Guide

Platform-specific support information is as follows:

l Windows client operating systems: The Remote Desktop is only available in Single User Mode.l Windows server operating systems: You can havemultiple Remote Desktop sessions.

1.1.4 Host name resolutionTypically, the computer on which you want to install the DOT-Anonymizer Server is connected to anetwork. Ensure that the computer host name is resolvable through a Domain Name System (DNS) or acentrally-maintained TCP/IP host file, such as /etc/hosts (file is located inC:\Windows\System32\drivers\...). Use the ping command to ensure that your computer host name isresolvable.

Examplehostnameserverhostnameping serverhostnamepinging serverhostname.example.com [192.168.1.10] with 32bytes of data:Reply from 192.168.1.10: bytes=32 time=138ms TTL=56

If your computer host name does not resolve, contact your system administrator.

1.1.5 Users, Groups and Environments for the DOT-Anonymizer Server

NotePlease refer to your OS and system administrator for common securitypractices.

In order to install the DOT-Anonymizer Server software you will need to log into the systemwithadministrator privileges.

The DOT-Anonymizer Server does not need a dedicated group name. If the application is run as aservice it will need a user account with the ‘log on as a service’ right. This account will need ownershipand read/write rights on directories and files where the software will be installed.

The special account LocalSystem can be used.

Depending on the configuration of the deployment processes, the user account might need rights onother directories and commands/software involved in the deployment processes.

The environment must be clean of variables which might affect java software such as JAVA_HOME,JDK_HOME, JRE_HOME, JAVA_OPTIONS, JAVA_OPTS, JVM_OPTS, CLASSPATH, etc.

Important!PATH must contain all java related binaries and tools.

TMP, TEMP, TMPDIR and TEMPDIR can be set to any desired temporary storage location.

1.2 Linux




1.2.1 Hardware requirementsThe following table lists the hardware components that are required for the DOT-Anonymizer Serveron Linux x64.

Requirement Value

System Architecture 64bits processor

CPU DUAL Core processor recommended

Physical memory(RAM) 4GB minimum, 8GB recommended1

Hard disk RAID storage or any secured storage with redundancy, backup andmonitoring


Network Any TCP/IP capable network interfaceTable 6: DOT-Anonymizer Server Hardware Requirements - Linux

1.2.2 Software requirementsThe following table lists the software requirements for the DOT-Anonymizer Server on Linux x64.

Requirement Value

Operating system Linux 64bits

Java JRE Java runtime 8; 64 bits required

Runlevel Server should be started in multi-user mode, commonly runlevel 3 or 5


Filesystem Ext3, ext4 or any journalized filesystem

SELINUX DisabledTable 7: DOT-Anonymizer Server Software Requirements - Linux

1.2.3 Host name resolutionTypically, the computer on which you want to install the DOT-Anonymizer Server is connected to anetwork. Ensure that the computer host name is resolvable through a Domain Name System (DNS) or acentrally-maintained TCP/IP host file, such as /etc/. Use the ping command to ensure that yourcomputer host name is resolvable.

Examplehostnameserverhostnameping serverhostnamepinging serverhostname.example.com [192.168.1.10] with 32bytes of data:Reply from 192.168.1.10: bytes=32 time=138ms TTL=56




DOT-Anonymizer v5.01 System requirements for the DOT-Anonymizer Server | Installation Guide


1.2.4 Users, Groups and Environments for the DOT-Anonymizer Server


If you are installing the software from an X WindowSystemworkstation or X terminal, then log in asroot and enable remote display.

In order to install the DOT-Anonymizer Server software you will need to log into the systemwithadministrator privileges.

DOT-Anonymizer does not need a dedicated group name, although a dedicated user account with adedicated group should be created. This account will need ownership and read/write rights ondirectories and files where the software will be installed.

The special account root should not be used to run the software but is needed to install services.

Depending on the configuration of the deployment processes, the user account might need rights onother directories and commands/software involved in the deployment processes.




1.3 IBM i

1.3.1 Hardware requirementsThe following table lists the hardware components that are required for the DOT-Anonymizer Serveron IBM i.

Requirement Value

Physical memory (RAM) 4GB minimum, 8GB recommended1


Network Any TCP/IP capable network interfaceTable 8: DOT-Anonymizer Server Hardware Requirements - IBM i





1.3.2 Software requirementsThe following table lists the software requirements for the DOT-Anonymizer Server on IBM i.

Requirement Value

Operating system IBM i 7.1 or above


Java JRE Java runtime 8; 64 bits required

At least one instance of the Remote Execution Server (REXEC)must be running.Table 9: DOT-Anonymizer Server Software Requirements - IBM i

1.3.3 Host name resolutionTypically, the partition on which you want to install the DOT-Anonymizer Server is connected to anetwork. Ensure that the partition host name is resolvable through a Domain Name System (DNS) orthe centrally-maintained TCP/IP host table (go CFGTCP, option 10).

Use the PING command to ensure that your computer host name is resolvable.

ExamplePING RMTSYS(hostname)Verifying connection to host systemhostname.domain.com at address 192.168.0.10.PING reply 1 from 192.168.0.10 took 18 ms. 256 bytes. TTL64.


1.3.4 Users for the DOT-Anonymizer Server

Step 1 Log into the systemwith a profile with the following special authorities:

l *ALLOBJl *SECADMl *JOBCTL

Step 2 After the installation, a DOT-Anonymizer user profile will be created and it will be granted thesespecial authorities.

Result The DOT-Anonymizer Server will run under this profile by default.



DOT-Anonymizer v5.02 System requirements for the DOT-Anonymizer Studio | Installation Guide

2 System requirements for the DOT-AnonymizerStudio

2.1 Windows

2.1.1 Hardware requirementsThe following table lists the hardware components that are required for the DOT-Anonymizer Studioon Windows x64.

Requirement Value

System Architecture 64 bit processor

Physical memory (RAM) 4GB minimum, 8GB recommended


Network Any TCP/IP capable network interfaceTable 10: DOT-Anonymizer Studio Hardware Requirements - Windows

2.1.2 Software requirementsThe following table lists the software requirements for the DOT-Anonymizer Studio on Windows x64.

Requirement Value

Operating system l Anymicrosoft supported windows os 64bit


Table 11: DOT-Anonymizer Studio Software Requirements - Windows

2.1.3 Remote Desktop ServicesDOT Software supports installing, configuring, and running all of its software through Remote DesktopServices, formerly known as Terminal Services, on Windows. To install, DOT Software recommendsthat you start all configuration tools from the Terminal Server console session of the server using mstscor console.

Platform-specific support information is as follows:

l Windows client operating systems: The Remote Desktop is only available in Single User Mode.l Windows server operating systems: You can havemultiple Remote Desktop sessions.

2.1.4 Users, Groups and Environments for the DOT-Anonymizer Studio




DOT-Anonymizer v5.0Installation Guide | 2 System requirements for the DOT-Anonymizer Studio

In order to install the DOT-Anonymizer Studio software you will need to log into the systemwithadministrator privileges.

The DOT-Anonymizer Studio does not need any specific rights, any session user account with rightscan launch the software. An account with roaming profile can be used.






DOT-Anonymizer v5.03 System requirements for the WebStudio | Installation Guide

3 System requirements for the WebStudio

Supported browsers:

l Internet Explorer 9+l Google Chrome 29+l Firefox 23+l Safari 6+l Opera 15+l iOs 6+l Android 4 (Limited)

Browser plug-ins are required by the default client; only JavaScript needs to be enabled.

Support on mobile browsers has some limitations.



Installation

DOT-Anonymizer v5.04 Installing the DOT-Anonymizer Server on IBM i | Installation Guide

4 Installing the DOT-Anonymizer Server on IBM i

4.1 Prerequisites

ReferenceFor complete details about the technical prerequisites for DOT-Anonymizer, refer to the System requirements on page 7.

4.2 Installing and updating

The DOT-Anonymizer Server can be installed and updated manually on IBM i or, depending on yoursecurity policy, remotely from any machine running Java.

The installers are found in the \ibmi folder in your installation package.

l The install.sh script is used to run the installer locally on IBM i or remotely from Linux.l The remoteInstall.bat is used to run the installer remotely fromWindows.

Step 1 Copy the IBM i installation package to any directory on the target IBM i or themachine that willorchestrate the remote installation.

Step 2 If you are installing manually on IBM i:

1. Open a session on the target IBM i using the QSECOFR profile or an equivalent.2. Run the command QSH to open a shell session. Enter the complete path to the install.sh

script and press Enter to launch it.

If you are installing remotely fromWindows or Linux:

1. Launch the installer that corresponds to OS orchestrating the installation.

l Windows: launch the remoteInstall.bat.

l Linux: launch the install.sh.This will open a prompt asking for theRemote IBM i name/address.

2. Enter the name/address of the target IBM i.3. Login using the QSECOFR profile or an equivalent.

Step 3 Define the installation path for the DOT-Anonymizer Server.

Step 4 Define the TCP ports to use. The DOT-Anonymizer Server is an independent AFS server withan embedded H2 database.

Important!The AFS port defined here will be used to configure aconnection to the server. It will be part of the URL that will beused to communicate with the DOT-Anonymizer Server.



DOT-Anonymizer v5.0Installation Guide | 4 Installing the DOT-Anonymizer Server on IBM i

By default the AFS port is 5252 and the H2DB port is 9092 but you can change either or bothof them.

Step 5 Define theAFS Starter Installation library which will contain the AFS Starter (a utilityprogram, specific to the DOT-Anonymizer Server, used to start AFS servers on IBM i). Bydefault it’s AFSSTARTER.

Step 6 Enter theUser that will run the DOT-Anonymizer Server.

Step 7 Enter the Library (*LIBL) then the JOBQ in which the server’s job will be submitted.

NoteIf you are updating the server, the final two steps will not berequired.

Result The DOT-Anonymizer Server is installed and available for use.

ReferenceFor more information about accessing and configuring DOT-Anonymizer, refer to theDOT-Anonymizer User Guide.



DOT-Anonymizer v5.05 Installing the DOT-Anonymizer Server, Web Studio and/or CLP on Windows | Installation Guide

5 Installing the DOT-Anonymizer Server, Web Studioand/or CLP on Windows

There are three elements available to install on windows:

l the standard DOT-Anonymizer Server;l the DOT-Anonymizer Web Studio that grants access to the interface via the internet;l the Anonymizer Command Line Processor that enables third party applications to communicatewith the DOT-Anonymizer Server in order to trigger specific (transformation) actions or to obtaininformation about managed entities.

5.1 Prerequisites


5.2 Installing

The installation process takes approximately 5 minutes. It is a simple procedure similar to most otherWindows applications. For trouble-free installation, it is recommended that you close all activeWindowsapplications before beginning the installation.

Follow the subsequent steps to install the DOT-Anonymizer Server, Web Studio and/or the CommandLine Processor:

Step 1 Launch the setup wizard.

Execute theDOT-Anonymizer Servers.exe located in the Server folder of your installationmedia. Your windows profile must have administrator status to run this file.

Depending on your computer’s security settings, your web browser might issue a warningmessage at this step asking you whether you want to run the installation program now, or saveit on your PC. To launch the setup program immediately, click Run. If you decide to save it, youmust then locate the saved program and double-click on it to continue.

Step 2 Select a language.

From the Select Setup Language window, select the language for the installation wizard,then clickOK.

Step 3 Confirm to continue

The Setup window indicates the version that will be installed.

ClickNext > to continue.

Step 4 Review and accept the license agreement.

The License Agreement page presents the DOT Software license agreement for you toreview. Please read it carefully.



DOT-Anonymizer v5.0Installation Guide | 5 Installing the DOT-Anonymizer Server, Web Studio and/or CLP on Windows

When you have reviewed the agreement, select I accept the agreement.


Step 5 Confirm the installation location

The Select Destination Location screen displays the default location where ARCAD softwareelements are installed. If you prefer to install the software elements in a different location,either type in the location, or click Browse... to navigate to and select the alternate location.

The default location is: C:\Program Files (x86)\DOT Solutions

A sub-folder for each of the applications you will install will be created at this location.


Step 6 Select the component(s) to install.

If you do not want to install all of the applications, unselect one or more from the list.

Warning!If an item in the list is already installed on your computer,unselecting it in the list of components will uninstall it.


Step 7 Install.

TheReady to Install screen enables you to review and change or confirm the setupparameters provided and to launch the installation.

To change a setup parameter, click < Back and return to the necessary screen.

If you agree with the installation parameters displayed, click Install to start the copy phase ofthe installation process.

As the installation proceeds, a status bar displays its progress. Each element copied appearsabove the status bar. Click Cancel to interrupt the installation.

Step 8 Declare the server port(s).

The DOT-Anonymizer Server is an independent AFS server which hosts references on an H2RDBMS database. Define the HTTP ports to use to access the AFS and the H2.

Important!The port defined heremust be used to configure a connectionin the studio. This is the number that will allow the DOT-Anonymizer Studio to communicate with the DOT-Anonymizer Server.

By default, the AFS HTTP port number is 5252 unless that port is already being used. If anapplication is already using it, the default server port will be the next available port after 5252.

By default, the AFS HTTPS port number is 5353 unless that port is already being used. If anapplication is already using it, the default server port will be the next available port after 5353.

By default, the H2DB port number is 9092 unless that port is already being used. If the 9092port is already in use, the H2’s port and the corresponding data sourcemust be changed



DOT-Anonymizer v5.05 Installing the DOT-Anonymizer Server, Web Studio and/or CLP on Windows | Installation Guide

manually to avoid a conflict with the existing server running on 9092. If required, follow thesubsequent steps to change the port and data source after the server is installed.

1. In a web browser enter this address to open the server’s configuration settings via theweb-services page (also called the ARCAD-Administrator): <Server_address>:<port>/console

2. Log into the server using the admin connection information (admin@quadra/quadra).3. Click theDatabase menu item in the left-hand panel.4. SelectH2 Database Server to open the H2 configuration settings.

a. Change the default Port (9092) to any other open port.b. Click Save.

5. SelectData Source to open the data sources configuration settings.a. Select the data source to edit then click Edit.b. Modify theURL to include the newPort number defined in step 4a.

ExampleInitially the URL may read something like this which calledthe default 9092 port:jdbc:h2:tcp://localhost/database/<module code>

Modify it to include the port number after the <address>:jdbc:h2:tcp://localhost:9093/database/<module code>


Step 9 Complete the setup process.

The final page of the wizard displays confirmation that the setup was a success.

Click Finish to close the setup wizard.

The finish process may take amoment because the windows services are launched.

Result The DOT-Anonymizer Server, Web Studio and Command Line Processor are installed andavailable for use.


5.2.1 Verify the windows services are runningBoth the DOT-Anonymizer Server and the DOT-Anonymizer Web Studio are windows services. Thefinal screen of the installation process enables you to open the Services window. If theVerify theinstallation of the Windows service checkbox is selected, the Services window opens after clickingFinish.This window enables you to verify that the server and/or the web studio is running.



DOT-Anonymizer v5.0Installation Guide | 5 Installing the DOT-Anonymizer Server, Web Studio and/or CLP on Windows

Figure 1: DOT-Anonymizer servers running in Windows Services

5.2.2 Configuring the DOT-Anonymizer Web Studio portTo access the DOT-Anonymizer Web Studio, themachinemust be connected to the internet and thesame network as the windows machine that theWeb Studio is installed on. By default the port is set to8080.

To change the port for the DOT-Anonymizer Web Studio, edit the jetty.port in the http.ini file:C:\Program Files (x86)\DOT Solutions\DOT-Anonymizer Web Studio\start.d

To apply the change(s), save the .ini file and restart the service (Computer Management/Services andApplications/Services).

If the web browser's configuration has not been modified from the default settings, accessing thestudio online is as simple as entering the name of themachine on which theWeb Studio is installed asthe URL in any web browser.

ExampleIf the DOT-Anonymizer Web Studio is installed on your local computer,the URL is localhost. By default, the port is 8080, which is the standardinternet port, so when you enter the name of themachine in a browser,it will automatically redirect to the address <hostname>/anonymizer.

However, if the port was changed, enter the name of themachine on which it is installed followed by acolon and the port number.

ExampleIf the DOT-Anonymizer Web Studio is installed on a computer calledWeb Server and the port is changed to 8082, the URL isWebServer:8082, which will redirect toWebServer:8082/anonymizer.

NoteIt is recommended to contact your server admin for the correct servername and port number.



DOT-Anonymizer v5.06 Installing the DOT-Anonymizer Server on Linux | Installation Guide

6 Installing the DOT-Anonymizer Server on Linux

6.1 Prerequisites


6.2 Installing

Step 1 Log in as root user.

Step 2 Copy the file server_linux.zip to a temporary location on the server and extract the content.

>unzip server_linux.zip -d /opt/anonymizer

Step 3 [Optional] Create a dedicated user/group.

>useradd -r dotany -d /opt/anonymizer/server -s /sbin/nologin

Step 4 [Optional] Change ownership to the dedicated user.

>chown –R dotany:dotany /opt/anonymizer/server

Step 5 Launch the server.

>$SHELL /opt/anonymizer/server/bin/run.sh

or if using a dedicated user

>su -s /bin/sh -c "/opt/anonymizer/server/bin/run.sh &" dotany

Step 6 [Optional] Install the service.

Example service scripts are provided in the bin subdirectory:

l anonymizer-server for systemV andl anonymizer-server.service for systemd

For systemVCreate a symbolic link to the anonymizer-server script in /etc/init.d:

>ln -s /opt/anonymizer/server/bin/anonymizer-server /etc/init.d/anonymizer-server

If the Server is not installed in /opt/anonymizer/server, you must modify the ANONYMIZER_HOME environment variable in the anonymizer_server_functions script to make it point tofolder in which the server is installed.

If a dedicated user is used, customize the script anonymizer_server_functions.

For systemdCopy the anonymizer-server.service script into the folder /usr/lib/systemd/system.

NoteSome Linux systems, like Ubuntu, may not recognize thisfolder. If this is the case copy the script into



DOT-Anonymizer v5.0Installation Guide | 6 Installing the DOT-Anonymizer Server on Linux

/etc/systemd/system.

If the Server is not installed in /opt/anonymizer/server, you must modify the ANONYMIZER_HOME environment variable in the anonymizer-server.service script.

If a dedicated user is used, change the User variable in the anonymizer-server.service script.

[Unit]

Description=Anonymizer Server

After=network.target

[Service]

Environment="ANONYMIZER_HOME=/opt/anonymizer/server"

Type=forking

ExecStart=/opt/anonymizer/server/bin/anonymizer-server start

ExecStop=/opt/anonymizer/server/bin/anonymizer-server stop

WorkingDirectory=/opt/anonymizer/server

User=dotany

[Install]

WantedBy=multi-user.target

Execute the following commands to enable and start the service (you must have root rights).

l systemctl daemon-reload

l systemctl enable anonymizer-server

l systemctl start anonymizer-server

Result The DOT-Anonymizer Server is installed and available for use, listening on port 8430.



DOT-Anonymizer v5.07 Installing the DOT-Anonymizer Studio | Installation Guide

7 Installing the DOT-Anonymizer Studio

7.1 Prerequisites


7.2 Installing

The installation process takes approximately 5 minutes. It is a simple procedure similar to most otherWindows applications. For trouble-free installation, it is recommended that you close all activeWindowsapplications before beginning the installation.

Follow the subsequent steps to install the DOT-Anonymizer Studio 5.0.

Step 1 Launch the setup wizard.

Execute theDOT-Anonymizer Studio.exe located in the Client folder of your installation media.Your windows profile must have administrator status to run the execution file.

Depending on your computer’s security settings, your web browser might issue a warningmessage at this step asking you whether you want to run the installation program now, or saveit on your PC. To launch the setup program immediately, click Run. If you decide to save it, youmust then locate the saved program and double-click on it to continue.

Step 2 Select a language.

From the Select Setup Language window, select the language for the installation wizard,then clickOK.

Step 3 Begin the setup wizard.

TheWelcome screen displays the version of the product that will be installed and gives you theoption to cancel the installation.


Step 4 Review and accept the license agreement.

The License Agreement page presents the DOT Software license agreement for you toreview. Please read it carefully.

When you have reviewed the agreement, select I accept the agreement.


Step 5 Confirm the installation location.

The Select Destination Location screen displays the default location where DOT Softwareelements will be installed. If you prefer to install the software elements in a different location,either type in the location, or click Browse... to navigate to and select the alternate location.

The default location is: C:\Program Files (x86)\DOT Solutions\DOT-Anonymizer Studio.



DOT-Anonymizer v5.0Installation Guide | 7 Installing the DOT-Anonymizer Studio


Step 6 Confirm the program group name and location.

The Select Start Menu Folder screen displays the default location where a shortcut will becreated in your computer’s Start menu. If you prefer to install the shortcut under a differentgroup, either type the location here, or click Browse... to navigate to and select the alternatelocation.

The default locations is: DOT Solutions\DOT-Anonymizer Studio.

If you do not want to create a start menu folder, select theDon't create a Start Menu foldercheckbox.


Step 7 Install.

TheReady to Install screen enables you to review and change or confirm the setupparameters provided and to launch the installation.

To change a setup parameter, click < Back and return to the necessary screen.

If you agree with the installation parameters displayed, click Install to start the copy phase ofthe installation process.

As the installation proceeds, a status bar displays its progress. Each element copied appearsabove the status bar. Click Cancel to interrupt the installation.

Step 8 Complete the setup process.

The final page of the wizard displays confirmation that the setup was a success.

Check or uncheck the Run DOT-Anonymizer Studio check box as required.

Click Finish to close the setup wizard.

Result The DOT-Anonymizer Studio is installed and available for use.


7.3 Uninstalling

Follow the subsequent steps to uninstall the DOT-Anonymizer Studio fromWindows.

Step 1 Log into the systemwith an administrator account.

Step 2 Open Add or Remove Programs (Start > Control Panel then select Add or RemovePrograms).

Step 3 Find DOT-Anonymizer in the list of installed software and selectUninstall.

Step 4 Click Yes to confirm.

Step 5 Wait for the uninstall to complete.

Step 6 ClickOK.



DOT-Anonymizer v5.07 Installing the DOT-Anonymizer Studio | Installation Guide

Step 7 Remove any remaining files in the installation path.

Result The DOT-Anonymizer Studio is now completely uninstalled.



dot-anonymizer 5.0 installation guide...northamerica&latam emea(hq) asiapacific...

Documents