Signiant Agent installation

Transcription

1 Signiant Agent installation Release March 2015 ABSTRACT Guidelines to install the Signiant Agent software for the WCPApp. The following instructions are adapted from the Signiant original documentation Version March 2015 Version October 2013

2 Table of Contents Agent Installation: network requirements...2 Agent installation: System Requirements...3 Downloading Signiant Agent installation files...4 Installing, upgrading and uninstalling the Agent on Windows...5 Installing...5 Upgrading...7 Uninstalling...7 Installing, upgrading and uninstalling the Agent on MAC...8 Installing...8 Upgrading...10 Uninstalling...10 Installing, upgrading and uninstalling the Agent on Linux...12 Installing...12 Upgrading...13 Uninstalling...14 Configuration of the new agent on WCPapp of 15

3 Agent Installation: network requirements Basic requirements for the server where you want to install the agent software are: It must be able to connect to the ports TCP and UDP of the following servers: sc wcpmediaservices.net sc wcpmediaservices.net sc wcpmediaservices.net sc wcpmediaservices.net The four servers indicated above, on the other hand, must be able to connect to the ports TCP and UDP of your agent, so make sure your agent allows connections on those ports from those servers. To achieve this, the best way is if your agent has a FQDN (Full Qualified Domain Name), but it's also possible to use other techniques such as DMZ, port forwarding and so on. Note: Date and time must be accurately set. Utilization of an NTP Server is recommended. Agent installation: System Requirements Hardware CPU: Pentium dual-core processor, 2 GHz or higher Memory: 2 GB minimum Disk Space: 400 MB (preferably 1 GB) Network Connection: 100 Mbps or faster Operating Systems Linux RedHat/CentOS 5.3+ (32-bit & 64-bit) Linux RedHat/CentOS 6.0+ (64-bit) Macintosh OS X 10.7, 10.8 (Intel, 64-bit) Macintosh OS X 10.6 (PowerPC & Intel, 32-bit & 64-bit) Solaris 10 x86 (64-bit) Windows Server 2008 R2 (64-bit) Windows Server 2003 R2 (64-bit) Windows 7, 8, 8.1 Windows 2012 Server R2 (64-bit) VMWare virtual machines supported (except Macintosh) 3 of 15

4 Downloading Signiant Agent installation files To install the Agent software, you need to download the software as a compressed file to the machine where you want to install it. 1. Define a folder where to store all files for the installation (for example: /tmp/sigclient for UNIX-based hosts or C:\temp\sigclient for Windows-based hosts). 2. Go to (the link is case sensitive). 3. Download the installation information file (sigsetup.inf) into your installation folder. This file is really important because it contains all the configuration parameters. If your browser opens the file instead of asking you to download it, return to the download page, right-click on the file and choose to save it in your installation folder. 4. Download the agent installation bundle for your platform into the same directory 4 of 15

5 Installing, upgrading and uninstalling the Agent on Windows Installing 1. In the folder where you downloaded the agent installation bundle and installation information file (for example: C:\temp\sigclient), double-click the downloaded executable file (for example: sig_client_x86-wnt.exe). Take into account that the Windows 64-bit installer will run on a 32-bit system and will attempt, incorrectly, to install 64-bit code on a 32-bit system. 2. Fill in the information on the screens, using Back and Next. The Agent connects to the Manager Web interface web server to request a digitally-signed certificate. 3. The Manager Web interface contacts the Certificate Authority on the agent s behalf and requests the agent s digital certificate. 4. To exit the setup program, click Finish. Note: If an error message is generated, please contact us. 5 of 15

6 Verify the Agent is properly configured WCP can always monitor the agents and check any communication trouble. However the customer can verify that the agent is properly configured from the command line, through the following steps: 1. Open the Windows control panel, and select Services. 2. The services Signiant Process Control and Signiant UDP Relay should be started. 3. Open a command prompt. 4. Change directories to the agent binary directory (Windows default is c:\program files\<install_dir>\bin). 5. Run the command dds_admin as one of the DDS administrators. You should be prompted to login to the local Agent Administration program, similar to the following: > The channel to <hostname> is mutually authenticated Cipher= AES256, Keysize=256/256 bits). Enter password for <username> on <hostname>: [or] No grant is configured Being prompted for a password or seeing a message that no grant is configured indicates that the agent is running and correctly configured. Press CTRL-BREAK or CTRL-C to exit. Verify the Agent can communicate with the WCP Signiant Manager 1. Open a command prompt as Administrator 2. Change directories to the agent binary directory (Windows default is c:\program files\<install_dir>\bin). 3. Run the command dds_cnctst sc wcpmediaservices.net You should receive the following output: The connection to 'sc wcpmediaservices.net' succeeded. If so, the TCP connection to the WCP Signiant Manager works properly 4. Run the command 6 of 15

7 dds_cnctst -udp sc wcpmediaservices.net If you receive the same output as above, the UDP connection to the WCP Signiant Manager works properly. Upgrading 1. In the folder where you downloaded the agent installation bundle and installation information file (for example: C:\temp\sigclient), double-click the downloaded executable file (for example: sig_client_x86-wnt.exe). 2. Read the license agreement and click Accept and Next. 3. In the Software Detected screen, check the Modify Installation radio button and click Next. 4. You must accept the license agreement to complete the installation. 5. In the Setup Complete screen, click Finish. Uninstalling You can remove the Agent software from the section Add or Remove Programs of your Windows Control Panel. As alternative: 1. In the folder where you downloaded the agent installation bundle (for example: C:\temp\sigclient), double-click the downloaded executable file (for example: sig_client_x86-wnt.exe). 2. In the Welcome Screen, click Next. 3. Click the Uninstall button. 4. Click Finish when the uninstall is complete. Important: if you uninstall an agent, please contact WCP, because it's important to revoke the agent certificate. 7 of 15

8 Installing, upgrading and uninstalling the Agent on MAC Installing Java Runtime Environment A Java runtime environment (JRE) must be installed on Mac OS X 10.7 (and above) in order for the Signiant Agent installer to run and for the agent functionalities to work. When the Agent installer is run, the operating system prompts to install Java if it is not present (Note: after Java is installed, the Signiant Installer may need to be invoked again). Rosetta Agent installations on a Mac require Rosetta (installed by default on Mac 10.5, but not on 10.6). If you don't have it, install it in order to use the agent. DNS IMPORTANT: If DNS is not configured on your system, the installation will pick up the agent's bonjour name rather than its hostname or fully-qualified domain name. (The bonjour name is configured under System Preferences>Sharing.) The installation completes, but the host may be unreachable by other Signiant agents. To ensure that the correct name is identified during installation in a non-dns environment, issue the following command from a terminal window: scutil --set Hostname <name> Once you have set the hostname, you must add the name and IP address to the /etc/hosts file, in the existing format. For example: <name>. format. For example: The name should exactly match that set via scutil. Installation Procedure To start the agent software installation, follow these steps: 1. In the folder where you downloaded the agent installation bundle and installation information file (for example, the Mac desktop), double-click the downloaded executable file (for example: sig_client_macintosh-os_x-10.7.dmg). 2. A new volume (SigAgentVol) appears on the desktop. 8 of 15

9 3. Double-click the volume and double-click setup. A password prompt appears. 4. Enter your password and click OK. The Welcome to Signiant Setup screen appears. 5. The Agent starts a Rapid Basic Installation and connects to the Manager Web interface web server to request a digitally-signed certificate. 6. The Manager Web interface contacts the Certificate Authority on the agent s behalf and requests the agent s digital certificate. 7. To exit the setup program, click Finish. Note: If an error message is generated, please contact us. Verify the Agent is Properly Configured WCP can always monitor the agents and check any communication trouble. However the customer can verify that the agent is properly configured from the command line, through the following steps: 1. open a terminal 2. run the command sudo service siginit status The output should show both the services Signiant Process Control and Signiant UDP Relay as running. 3. Change directories to the agent binary directory (default is /usr/signiant/dds/bin). 4. Run the command sudo./dds_admin You should be prompted to login to the local Agent Administration program, similar to the following: > The channel to <hostname> is mutually authenticated Cipher= AES256, Keysize=256/256 bits). Enter password for <username> on <hostname>: [or] No grant is configured Being prompted for a password or seeing a message that no grant is configured indicates that the agent is running and correctly configured. 9 of 15

10 Verify the Agent can communicate with the WCP Signiant Manager 1. Open a terminal 2. Go to the agent binary directory (default is /usr/signiant/dds/bin). 3. Run the command sudo./dds_cnctst sc wcpmediaservices.net You should receive the following output: The connection to 'sc wcpmediaservices.net' succeeded. If so, the TCP connection to the WCP Signiant Manager works properly 4. Run the command sudo./dds_cnctst -udp sc wcpmediaservices.net If you receive the same output as above, the UDP connection to the WCP Signiant Manager works properly Upgrading 1. In the folder where you downloaded the agent installation bundle and installation information file (for example, the Mac desktop), double-click the downloaded executable file (for example: sig_client_macintosh-os_x-10.7.dmg). 2. A new volume (SigAgentVol) appears on the desktop. 3. Double-click the volume and double-click setup. A password prompt appears. 4. Enter your password and click OK. The Welcome to Signiant Setup screen appears. 5. Click Next. 6. Accept the license agreement. 7. Click Yes to continue. 8. When the upgrade is completed, click Finish. Note: Agent installations on a Mac require Rosetta (installed by default on Mac 10.5, but not on 10.6). If you don't have it, install it in order to use the agent. Uninstalling 1. In the Applications area, open the Signiant folder. 2. Double-click on the uninstall icon. 3. A password prompt appears. 10 of 15

11 4. Enter the password and click OK. 5. In the Welcome Screen, click Next, and click Next again. 6. You are prompted if you are ready to begin the uninstall. 7. Click Finish when the uninstall is complete. Important: if you uninstall an agent, please contact WCP, because it's important to revoke the agent certificate. 11 of 15

12 Installing, upgrading and uninstalling the Agent on Linux Installing 1. Login with root privileges 2. In the folder where you downloaded the agent installation file (for example: /tmp/sigclient), untar it through the command tar -xzvf <installation_file> 3. Run the executable through the command./sigsetup 4. Fill in the information requested, using the Tab key to navigate through the fields and the N key to navigate through the screens. 5. The Agent connects to the Manager Web interface web server to request a digitallysigned certificate. 6. The Manager Web interface contacts the Certificate Authority on the agent s behalf and requests the agent s digital certificate. 7. The installation should finish without any problem. Note: If an error message is generated, please contact us. Verify the Agent is Properly Configured WCP can always monitor the agents and check any communication trouble. However the customer can verify that the agent is properly configured from the command line, through the following steps: 5. open a terminal and login as root 6. run the command service siginit status The output should show both the services Signiant Process Control and Signiant UDP Relay as running. 7. Change directories to the agent binary directory (default is /usr/signiant/dds/bin). 8. Run the command./dds_admin You should be prompted to login to the local Agent Administration program, similar to the following: > 12 of 15

13 The channel to <hostname> is mutually authenticated Cipher= AES256, Keysize=256/256 bits). Enter password for <username> on <hostname>: [or] No grant is configured Being prompted for a password or seeing a message that no grant is configured indicates that the agent is running and correctly configured. Verify the Agent can communicate with the WCP Signiant Manager 5. Open a terminal and login as root 6. Go to the agent binary directory (default is /usr/signiant/dds/bin). 7. Run the command./dds_cnctst sc wcpmediaservices.net You should receive the following output: The connection to 'sc wcpmediaservices.net' succeeded. If so, the TCP connection to the WCP Signiant Manager works properly 8. Run the command./dds_cnctst -udp sc wcpmediaservices.net If you receive the same output as above, the UDP connection to the WCP Signiant Manager works properly Upgrading 1. Open a terminal and login as root 2. In the folder where you downloaded the agent installation file (for example: /tmp/sigclient), untar it (if needed), and run the executable through the command./sigsetup 3. Use the Tab key to navigate through the fields and the N key to navigate through the screens. 4. The installation should finish without any problem. 13 of 15

14 Uninstalling 1. Open a terminal and login as root 2. Go to the agent binary directory (default is /usr/signiant/dds/bin). 3. Run the command./siguninstall 4. Carry on with the various steps though the key N and Y when requested Important: if you uninstall an agent, please contact WCP, because it's important to revoke the agent certificate. 14 of 15

15 Configuration of the new agent on WCPapp In order to use the new agent, you need to register it in the WCPApp, following these steps: 1. Go to the section Company, to the tab Download&Upload and click the button New Signiant Agent. 2. Insert here the Agent Name, it s a unique identifier and it can be selected as you like. 3. Insert the Hostname. This is the hostname of your agent 4. Insert the upload and download directory using a path where your agent has read and write rights. 5. Click on Save to save the new agent 6. The Agent should have appeared in the list, otherwise wait for a couple minutes 7. Find the entry related to your new agent, you should see both the upload and download paths, each one followed by a grey triangle. 8. Click on the two arrows on the right, they check if the agent can perform respectively uploads and downloads using the paths you specified in the configuration. Please wait a couple minutes to receive the outputs: the triangle associated to each specified path should get green. If instead you receive a red triangle, something went wrong with the path, so click on the Edit button on the right to fix your configuration. 9. As soon as the configuration has finished, you can select your new agent when performing a transfer. 15 of 15