hmLoadTopic({
hmKeywords:"",
hmTitle:"Mac",
hmDescription:"The installer file of Linkar Web Services has the following name:",
hmPrevLink:"ws_linux.html",
hmNextLink:"ws_docker.html",
hmParentLink:"ws_installation.html",
hmBreadCrumbs:"<a href=\"ws_installation.html\">Installation<\/a>",
hmTitlePath:"Installation > Mac",
hmHeader:"<h1 class=\"p_Heading1\" style=\"page-break-after: avoid;\"><span class=\"f_Heading1\">Mac<\/span><\/h1>\n\r",
hmBody:"<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">The installer file of Linkar Web Services has the following name:<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">LinkarWS_Setup_Win_x64_x_y_z.exe<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">Where “x”, “y” and “z” stand for the numbers corresponding to the program version.<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">Make sure that the file have all execution permissions assigned. Otherwise, run the following command to give the file the permissions needed:<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\"><span style=\"font-style: italic;\"> &nbsp; &nbsp; sudo chmod a+x LinkarWS_Setup_Mac_x64_1_1_0_8<\/span><\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">To start the installation or update, run this file from the terminal or console with root permissions.<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\"><span style=\"font-style: italic;\"> &nbsp; &nbsp; .\/LinkarWS_Setup_Mac_x64_1_1_0_8<\/span><\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">Before proceeding, the program will ask you to confirm that the installation is being executed as a root user. If that\'s the case, press they &quot;Y&quot; and &quot;Enter&quot; keys.<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: center;\"><img style=\"margin:0 auto 0 auto;width:69.5625rem;height:21.2500rem;border:none\" src=\".\/images\/installationmac1.png\"\/><\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\"><span class=\"f_ImageCaption\" style=\"font-size: 1.00rem; font-family: Arial,Helvetica,sans-serif; font-style: normal;\">The installation menu has the following options:<\/span><\/p>\n\r<p class=\"p_Normal\"><span class=\"f_ImageCaption\" style=\"font-size: 1.00rem; font-family: Arial,Helvetica,sans-serif; font-style: normal;\">1.- &nbsp; &nbsp; &nbsp; &nbsp;Install a new instance of LinkarWS<\/span><\/p>\n\r<p class=\"p_Normal\"><span class=\"f_ImageCaption\" style=\"font-size: 1.00rem; font-family: Arial,Helvetica,sans-serif; font-style: normal;\">2.-  &nbsp; &nbsp; &nbsp; &nbsp;Update an existing instance<\/span><\/p>\n\r<p class=\"p_Normal\"><span class=\"f_ImageCaption\" style=\"font-size: 1.00rem; font-family: Arial,Helvetica,sans-serif; font-style: normal;\">0.- &nbsp; &nbsp; &nbsp; &nbsp;Exit<\/span><\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: center;\"><img style=\"margin:0 auto 0 auto;width:69.6875rem;height:38.7500rem;border:none\" src=\".\/images\/installationmac2.png\"\/><\/p>\n\r<p class=\"p_HeadingHowTo_atoc_\" style=\"page-break-after: avoid;\"><img id=\"TOGGLE0186A1_ICON\" class=\"dropdown-toggle-icon\" style=\"margin:0;width:1.0000rem;height:1.0000rem;border:none\" src=\".\/images\/tog_plus.gif\"\/><span class=\"f_HeadingHowTo_atoc_\" style=\"font-size: 1.00rem; font-family: Arial,Helvetica,sans-serif;\"><a id=\"TOGGLE0186A1_LINK\" class=\"dropdown-toggle\" style=\"font-style: normal; font-weight: normal; color: #000000; letter-spacing: -0.0625rem; background-color: transparent; text-decoration: none;\" href=\"javascript:void(0)\" data-type=\"dropdown\" data-state=\"0\" data-icon=\"TOGGLE0186A1_ICON\" data-src0=\".\/images\/tog_plus.gif\" data-src1=\".\/images\/tog_minus.gif\">Instalación de una nueva instancia<\/a><\/span><\/p>\n\r<div id=\"TOGGLE0186A1\" class=\"dropdown-toggle-body\" style=\"text-align: left; padding: 0 0 0 0; margin: 0 0 0 2.0000rem;display:none\"><table style=\"border:none; border-spacing:0;\">\n\r<tr>\n\r<td style=\"vertical-align:top; padding:0; border:none\"><p class=\"p_Normal\" style=\"text-align: center; margin: 0 0 0 1.5000rem;\"><img style=\"margin:0 auto 0 auto;width:69.6875rem;height:23.3750rem;border:none\" src=\".\/images\/installationnew.png\"\/><\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">It\'s possible to install multiple instances of Linkar Web Services.<\/p>\n\r<p class=\"p_Normal\">Each instance needs to be installed in a different folder and has its own settings, being completely independent from the other instances.<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">To instal a new instance, select option 1 from the menu. Next, enter the full installation path for LinkarWS. The folder must be a new one and it will be created during the installation process.<\/p>\n\r<p class=\"p_Normal\">We strongly recommend installing LinkarWS in the &quot;\/Library&quot; folder. If nothing indicated, default installation path will be “\/Library\/linkarWS”. <\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: center;\"><img style=\"margin:0 auto 0 auto;width:69.3750rem;height:52.5625rem;border:none\" src=\".\/images\/installationmac3.png\"\/><\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">Next, the process will require the following values to be indicated:<\/p>\n\r<p class=\"p_Normal\" style=\"text-indent: 0; padding-left: 0.8125rem; margin-left: 0;\"><span class=\"f_Normal\" style=\"font-family: Arial,\'Lucida Sans Unicode\',\'Lucida Grande\',\'Lucida Sans\';display:inline-block;width:0.8125rem;margin-left:-0.8125rem\">&#8226;<\/span>Host. Interface that LinkarWS will listen to. The default value is &quot;*&quot;, which will indicate LinkarWS to listen to all the available interfaces.<\/p><p class=\"p_Normal\" style=\"text-indent: 0; padding-left: 0.8125rem; margin-left: 0;\"><span class=\"f_Normal\" style=\"font-family: Arial,\'Lucida Sans Unicode\',\'Lucida Grande\',\'Lucida Sans\';display:inline-block;width:0.8125rem;margin-left:-0.8125rem\">&#8226;<\/span>Http Port: Interfaces port to which LinkarWS will listen to. Default is 12000.<\/p><p class=\"p_Normal\" style=\"text-indent: 0; padding-left: 0.8125rem; margin-left: 0;\"><span class=\"f_Normal\" style=\"font-family: Arial,\'Lucida Sans Unicode\',\'Lucida Grande\',\'Lucida Sans\';display:inline-block;width:0.8125rem;margin-left:-0.8125rem\">&#8226;<\/span>Service name: Name of the Linux Service, default is &quot;LinkarWS&quot;. This name must be unique for each LinkarWS instance installed.<\/p><p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\"><span class=\"f_ImageCaption\" style=\"font-size: 1.00rem; font-family: Arial,Helvetica,sans-serif; font-style: normal;\">On the last step, the Linux service of LinkarWS will be started.<\/span><\/p>\n\r<p class=\"p_Normal\"><span class=\"f_ImageCaption\" style=\"font-size: 1.00rem; font-family: Arial,Helvetica,sans-serif; font-style: normal;\">Once started, if the Linux terminal or console is running on a Graphic Desktop context, the computer\'s default web browser will open the LinkarWS configuration website. <\/span><\/p>\n\r<p class=\"p_Normal\"><span class=\"f_ImageCaption\" style=\"font-size: 1.00rem; font-family: Arial,Helvetica,sans-serif; font-style: normal;\">The default credentials are:<\/span><\/p>\n\r<p class=\"p_Normal\" style=\"text-indent: 0; padding-left: 0.8125rem; margin-left: 0;\"><span class=\"f_Normal\" style=\"font-family: Arial,\'Lucida Sans Unicode\',\'Lucida Grande\',\'Lucida Sans\';display:inline-block;width:0.8125rem;margin-left:-0.8125rem\">&#8226;<\/span>User: admin<\/p><p class=\"p_Normal\" style=\"text-indent: 0; padding-left: 0.8125rem; margin-left: 0;\"><span class=\"f_Normal\" style=\"font-family: Arial,\'Lucida Sans Unicode\',\'Lucida Grande\',\'Lucida Sans\';display:inline-block;width:0.8125rem;margin-left:-0.8125rem\">&#8226;<\/span>Password: admin<\/p><p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: center;\"><img style=\"margin:0 auto 0 auto;width:69.5000rem;height:52.4375rem;border:none\" src=\".\/images\/installationmac4.png\"\/><\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p style=\"line-height: 1.28; margin: 0 0 0.6875rem 0;\"><span style=\"font-size: 0.91rem; color: #000000;\">&nbsp;<\/span><\/p>\n\r<p style=\"line-height: 1.28; margin: 0 0 0.6875rem 0;\">At first, LinkarWS is set to <span style=\"font-weight: bold;\">ApiKey<\/span> Authentication Mode.<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: center;\">&nbsp;<\/p>\n\r<div class=\"p_Normal\" style=\"text-align: center;\"><div style=\"margin:0 auto 0 auto;width:100%;height:auto;\"><img style=\"width:100%;height:auto;border:none\" src=\".\/images\/instalacionwindows5.png\"\/><\/div><\/div>\n\r<p class=\"p_Normal\" style=\"text-align: center;\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: center;\">&nbsp;<\/p>\n\r<p class=\"p_Normal\"><span class=\"f_ImageCaption\" style=\"font-size: 1.00rem; font-family: Arial,Helvetica,sans-serif; font-style: normal;\">Access to LinkarWS its via HTTP. However, HTTPS access can be enabled on the configuration of the Kestrel Server, indicating the domain name or IP, and the TPC port to which LinkarWS will listen to. In addition, a valid certificated must be provided for the domain name.<\/span><\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<div class=\"p_Normal\" style=\"text-align: center;\"><div style=\"margin:0 auto 0 auto;width:80%;max-width:1264px;height:auto;\"><img style=\"width:100%;height:auto;border:none\" src=\".\/images\/instalacionwindows6.png\"\/><\/div><\/div>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">LinkarWS can run in two different ways: as an OSX service or as a console application. <\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">If we don\'t want to run LinkarWS as a service, it can be started from the console or terminal on administrator mode, setting the current working directory to the LinkarWS root folder and running the following command:<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify; margin: 0 0 0 1.5000rem;\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify; margin: 0 0 0 1.5000rem;\"><span style=\"width:1.5000rem;display:inline-block\">&nbsp;<\/span>.\/<span style=\"font-style: italic;\">LinkarWS.exe --console<\/span><\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify; margin: 0 0 0 1.5000rem;\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify;\">Remember to stop the service before running this command. To stop it, run the following command:<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify; margin: 0 0 0 1.5000rem;\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify; margin: 0 0 0 1.5000rem;\"><span style=\"width:1.5000rem;display:inline-block\">&nbsp;<\/span><span style=\"font-style: italic;\">sudo launchctl unload \/Library\/LaunchDaemon\/LinkarWS.plist<\/span><\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify; margin: 0 0 0 1.5000rem;\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify;\">To get LinkarWS working and be able to access LinkarWS configuration, the service or console application must be running.<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify;\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify;\">In case of having multiple instances installed, each one of them has to be installed in a different folder and the Linux service name has to be different as well<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: center;\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<\/td>\n\r<\/tr>\n\r<\/table>\n\r<\/div>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_HeadingHowTo_atoc_\" style=\"page-break-after: avoid;\"><img id=\"TOGGLE0186A2_ICON\" class=\"dropdown-toggle-icon\" style=\"margin:0;width:1.0000rem;height:1.0000rem;border:none\" src=\".\/images\/tog_plus.gif\"\/><span class=\"f_HeadingHowTo_atoc_\" style=\"font-size: 1.00rem; font-family: Arial,Helvetica,sans-serif;\"><a id=\"TOGGLE0186A2_LINK\" class=\"dropdown-toggle\" style=\"font-style: normal; font-weight: normal; color: #000000; letter-spacing: -0.0625rem; background-color: transparent; text-decoration: none;\" href=\"javascript:void(0)\" data-type=\"dropdown\" data-state=\"0\" data-icon=\"TOGGLE0186A2_ICON\" data-src0=\".\/images\/tog_plus.gif\" data-src1=\".\/images\/tog_minus.gif\">Actualización de una instancia existente<\/a><\/span><\/p>\n\r<div id=\"TOGGLE0186A2\" class=\"dropdown-toggle-body\" style=\"text-align: left; padding: 0 0 0 0; margin: 0 0 0 2.0000rem;display:none\"><table style=\"border:none; border-spacing:0;\">\n\r<tr>\n\r<td style=\"vertical-align:top; padding:0; border:none\"><p style=\"text-align: center; background: #ffffff;\"><img style=\"margin:0 auto 0 auto;width:69.5625rem;height:23.3750rem;border:none\" src=\".\/images\/installationupdate.png\"\/><\/p>\n\r<p style=\"text-align: justify; background: #ffffff;\"><span style=\"font-size: 0.91rem; color: #000000; background-color: #ffffff;\">&nbsp;<\/span><\/p>\n\r<p style=\"text-align: justify; background: #ffffff;\"><span style=\"font-size: 0.91rem; color: #000000; background-color: #ffffff;\">&nbsp;<\/span><\/p>\n\r<p class=\"p_Normal\">We will update an existing LinkarWS instance by choosing option 2 on the main menu. <\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">An application must be stopped before being updated. If a runninfg application is detected, the update process will be cancelled.<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify;\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify;\">If the validation process determines that the indicated folder exists and contains a valid LinkarWS Installation, the update process will begin.<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: center;\"><img style=\"margin:0 auto 0 auto;width:69.5625rem;height:51.2500rem;border:none\" src=\".\/images\/installationmac5.png\"\/><\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">update process will copy the new files to the corresponding folders. Once finished, will ask you to start the OSX service. If started, and if the access to LinkarWS Manager is enabled (AdminMode), the default browser will load the login website.<\/p>\n\r<p class=\"p_Normal\" style=\"text-align: justify; margin: 0 0 0 1.5000rem;\">&nbsp;<\/p>\n\r<\/td>\n\r<\/tr>\n\r<\/table>\n\r<\/div>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r<p class=\"p_Normal\">&nbsp;<\/p>\n\r"
})
