Upgrade databases, ZyDesk, and Media Server

The ZyDesk.ini file contains information about the SQL server host, port, user name, password, and ZyDB database name. ZyDesk clients require this file to work, and a copy of the file must be placed in C:\Program Files (x86)\Zylinc\ZyDesk\ZyDesk.ini

Alternative locations in the user profile or in the Windows registry exist, see Deployment Manager user manual for more information.

To create the ZyDesk.ini file:

1. In the Deployment Manager menu, select Database > ZyDesk

2. Clear Include tunnel server address

3. Click Generate encrypted file

4. Save the ZyDesk.ini file in C:\Zylinc install\Release_6.0u4.8\Release_6.0u4.8\4_ZyDesk

Send two files to people who are going to install ZyDesk on Windows client computers.

Different people may manage the installation of clients, terminal servers, or Citrix servers. Remember to send the client software to all of them.

Find the following two files in C:\Zylinc install\Release_6.0u4.8\Release_6.0u4.8\4_ZyDesk), and send them to relevant people:

• ZyDesk_AllUserInstaller.msi

• ZyDesk.ini

You can zip the folder and send it in an e-mail.

Tell the receivers to copy the ZyDesk.ini file to C:\Program Files (x86)\Zylinc\ZyDesk\ZyDesk.ini after they've used the ZyDeskAllUserInstaller.msi file to install the client software.

Alternative locations in the user profile or in the Windows registry exist, see Deployment Manager user manual for more information.

1. In the Deployment Manager menu, select Deployment > Installation

2. In Installed Applications, select ZyDesk and click Uninstall Applications

1. Open the folder C:\Zylinc install\Release_6.0u4.8\Release_6.0u4.8\4_ZyDesk

2. Locate ZyDesk_AllUserInstaller.msi

3. Run the installer

4. Copy ZyDesk.ini to C:\Program Files (x86)\Zylinc\ZyDesk\ZyDesk.ini

Specify the Media Server connection settings and Administration Portal location, because it allows Deployment Manager to connect to Media Server, and then view a list of deployed media server application versions. Via the list, you can also upgrade the software modules, and you can install Administration Portal.

1. In the Deployment Manager menu, select Deployment > Media Server

2. In Address, enter the hostname of Media Server, for example: MediaServer

3. In Port, enter 8080

4. In Media server connection settings > User, enter admin

5. In Media server connection settings > Password, enter the password for Media Server Tomcat user admin

6. In Admin Portal connection settings > URL, enter: http://<MediaServer>:8080/zylinc-admin/

   Example, http://MediaServer:8080/zylinc-admin/

7. In Admin Portal connection settings > User, enter admin

8. In Admin Portal connection settings > Password, enter the password for Media Server Tomcat user admin

9. Click Save

10. Click Refresh

1. In the Deployment Manager menu, select Deployment > Media Server

2. Click Refresh

3. In Available Media Server Application, check if some of the applications indicate new version in the Status column, and appear in blue color

   If so, use CTRL+click to select all the applications with status new version, and then click Deploy Applications

   If you see an error message related to Please run a rewrite config manually, you can safely ignore it because you'll handle it later in the process.

4. Wait until all the applications have successfully been deployed.

5. Click Refresh and optionally repeat step 3 and 4 until no applications indicate new version in the Status column, and appear in blue color

1. Boot the virtual server for Media Server on the ISO image.

2. The ISO installer will run for approximately four minutes.

3. Wait until you see the message: Press <RETURN> to reboot (remove your removable medium)

4. Use the virtual server console to unmount the installation media ISO image from the virtual DVD drive.

   If you use the Eject function in Hyper-V, the installation media may re-insert itself at reboot. To prevent this, do the following if you use Hyper-V:
   
   1. Click Turn Off when you see the message Press <RETURN> to reboot (remove your removable medium)
   
   2. In the Virtual Machine Connection menu, select File > Settings... and then, in DVD Drive, Media, select None
   
   3. Turn the virtual machine back on
   

5. Press RETURN.

6. If you see the message <MediaServer> login:

   Log in as user name: admin
   
   Password: admin

7. In Please enter a value for “Tomcat admin password” (): Enter the password for Media Server Tomcat user admin.

8. In Please enter a value for “confirm the new tomcat password” (): enter the same password again.

9. Wait until you see the message: (network main) Enter option [h for help].

   1. Type 0, for eth0.

   2. Type m, to set DHCP/Static mode to STATIC.

   3. Type ip, and enter the IP4 address that you have planned to use.

   4. Type mask, and enter the subnet mask that you have planned to use.

   5. Type gw, and enter the IP4 address of the default gateway that you have planned to use.

   6. Type da, and enter the IP4 address of DNS server 1 that you have planned to use.

   7. Type da, and enter the IP4 address of DNS server 2, or skip this step if you only use one DNS server.

   8. Type t, to toggle state from down to up.

   9. Type b, to return to previous menu.

   10. Type a, to save and apply all changes.

   11. Verify that eth0 is shown in green, and that is displays a MAC address and an IP4 address. If that's not the case, go through network configuration again.

   12. Type q, to quit the (network main) Enter option [h for help] menu.

10. Enter the hostname that you have planned to use.

    Example of a hostname: MediaServer

    We use hostnames to refer to servers, but you can also use IP4 addresses, if your network requires it.

11. Type n, to keep the selected time zone, or type y and specify another time zone.

12. Wait until you see NTP configuration: Select Action menu.

13. Type a, to save and apply all changes, and use the default time servers.

14. In Enter new UNIX password: Enter the password for Unix (AdminCLI user admin).

15. In Retype new UNIX password, enter the same password again.

16. Wait until you see a menu: select(1-4):

    • If you use a physical server, enter 1

    • If you use a VMWare host, enter 2

    • If you use a Hyper-V host, enter 3

    • If you don’t use any of the above, enter 4

17. In Do you wish to disable IPv6 [y/*], type y, to disable IPv6.

18. In Choice: type 2 for ZyCall Switch Backend.

19. Wait approximately eight minutes until you see a message that says Finished Setup.Press any key to continue.

20. Press return, to reboot Media Server.

21. Wait until you can see a text-based login prompt in the console window.

Specify the Media Server connection settings and Administration Portal location, because it allows Deployment Manager to connect to Media Server, and then view a list of deployed media server application versions. Via the list, you can also upgrade the software modules, and you can install Administration Portal.

1. In the Deployment Manager menu, select Deployment > Media Server

2. In Address, enter the hostname of Media Server, for example: MediaServer

3. In Port, enter 8080

4. In Media server connection settings > User, enter admin

5. In Media server connection settings > Password, enter the password for Media Server Tomcat user admin

6. In Admin Portal connection settings > URL, enter: http://<MediaServer>:8080/zylinc-admin/

   Example, http://MediaServer:8080/zylinc-admin/

7. In Admin Portal connection settings > User, enter admin

8. In Admin Portal connection settings > Password, enter the password for Media Server Tomcat user admin

9. Click Save

10. Click Refresh

1. In the Deployment Manager menu, select Deployment > Media Server

2. Click Refresh

3. In Available Media Server Application, check if some of the applications indicate new version in the Status column, and appear in blue color

   If so, use CTRL+click to select all the applications with status new version, and then click Deploy Applications

   If you see an error message related to Please run a rewrite config manually, you can safely ignore it because you'll handle it later in the process.

4. Wait until all the applications have successfully been deployed.

5. Click Refresh and optionally repeat step 3 and 4 until no applications indicate new version in the Status column, and appear in blue color

1. In the Deployment Manager menu, select Deployment > Media Server

2. Click Refresh

3. In Available Media Server Application, select ZylincAdminPortal

4. Click Deploy Applications

1. In a browser, go to the URL (in Admin Portal connection settings) that you entered in a previous step, and log in with the user name and password you also entered in a previous step.

   Example: URL: http://MediaServer:8080/zylinc-admin/

   Username: admin

   Password: Enter the password for Media Server Tomcat user admin

2. In Host, enter the hostname for the SQL server that hosts ZyDB, for example, WinAppServer

3. In Port, enter 1433

4. In Instance, leave the field blank

5. In Username, enter ZyUser

6. In Password, enter the password for MSSQL user ZyUser

7. In DB Name, enter ZyDB

8. Click Save

9. Click Apply

10. Click Test.

11. You should see this message: Connection successfully established to Singletenant Database: <WinAppServer> / zydb

    You should also see the ZyDb Database Version. The version should not be 0.0.0.0

You're going to use Administration Portal again later, so make a note of the procedure in step 1.